Tincan Laravel Package

• Adds handling for If-None-Match: * headers for Agent and Activity profile requests. (credit @garemoko) fixes #104

• Added support for file URL attachments
• Allow for a verb/activity or its ID when querying for statements

tl;dr Other than specific uses of Score or specific features of 5.4 the public interface has not changed.

• Adds support for PHP 7 and drops support of PHP 5.4.
• Makes the Score object act more inline with intention of specification, particularly around the use of the scaled property. (See https://github.com/RusticiSoftware/TinCanPHP/commit/dbd8b3f24041683276598bfdc9fbdeed2e3920e0)
• Add handling of und as language key in LanguageMap for when a language is not matched but it is present.

The reason for the major version bump is that PHP 7 changes handling of return value for empty string or null arguments to json_decode which affects the public interface of the FromJSONTrait implementation. 5.4 can be supported by recognizing this fact and either removing the call to json_last_error_msg() in JSONParseErrorException or by stubbing in a replacement for it (probably based on the one in the PHP docs), having said that PHP 5.4 is EOLd by the core team so there is no reason to maintain support for it going forward, and because we try to minimize major version bumps and maintain backwards compatibility it makes sense to drop EOLd versions at those major version bump points. The JSONParseErrorException is wholly unnecessary to get to support of PHP 7, but because we were breaking compatibility of that interface anyways it makes sense as an implementation wrapper around the more generic InvalidArgumentException.

PHP 5.5 is EOLd as of 21 Jul 2016 (see http://php.net/eol.php) but still has enough installed user base at this time that we'll continue to support it within the 1.x series. Expect support to be removed from the next major version of TinCanPHP. (Where "support" means we'll stop testing and trying to maintain backwards compatibility, but we won't intentionally be trying to break it.)

Fixes made while improving test coverage (credit @WillSkates)

• Exception namespace issue in Map and State
• Accept-Language header issue in RemoteLRS.retrieveActivity
• Incorrect class in failure reason in SignatureComparisonTrait

• Switch Util.getTimestamp to return UTC timestamps (credit @lewyckoff) fixes #64
• Add header customization capability to RemoteLRS.queryStatements fixes #26
• Add 'proxy' option to RemoteLRS as well as ability to set "default" headers to be included in all requests, fixes #68
• Silence undefined warnings from variable scoping issue in RemoteLRS.sendRequest fixes #62

Note: the first bullet point above could be considered a backwards incompatible change if you are counting on the library to return timestamps in a particular timezone. In general this would be to store statements using a specific timezone, however you should probably reconsider counting on that based on what the LRS is allowed to do. If you were using the library to get timestamps for another purpose and need them in a specific timezone you'll want to re-examine your use case or your code.

• Instantiation of a non imported class introduced in 0.40.0 which is only hit on certain error conditions in RemoteLRS handling (credit @FireGhost @garemoko).

• Added full Attachments handling
• Added Statement Signing public interface
• Improved Language Map support (by @garemoko)
• Added readonly document API calls (including Person object support) (by @garemoko)
• Fixed asVersion for empty arrays and values
• Refactored test bootstrapping and configuration (@texdc)
• Refactored Version to be enum like (@texdc)
• Other various fixes: RemoteLRS exception handling, "1xx" status code handling, Util timestamp, etc.

• Significant improvements made by @texdc to internal implementation of per version serialization of objects.
• Made classes "immutable" as a subitem of the above to prevent non-anticipated use.
• Includes significant improvements in unit test coverage.
• Improvements to Score object property restrictions on acceptable values.

• Fixed a bug caused by using PHP's built in ISO 8601 format constant which generates improper timezone offsets.

• Default ContextActivities properties to arrays. The check to make sure the properties were set was not happening soon enough so that the set methods through the _listSetter were trying to push to arrays that were not defined yet
• setMember in Group wasn't auto constructing Agent members correctly

• Provide getter/setter methods for 'response' property of the Result object

• Fixes issue with .asVersion call on certain instances of ContextActivities

• Fixes a bug with argument exception handling
• Typo in exception message
• Improves exception message for call to setId on a Statement when value passed fails UUID regex match (includes unit test)

• UUIDs were being checked to make sure they were version 4, this was overly strict. The version check was removed and made case insensitive.

First public release, which is a stretch to call production worthy, but I'm satisfied enough with the effort that it should be usable without introduction of severe backwards compatibility hassles.

Fix for namespace map in autoload.

Adjustment to get composer autoload.

Just some cleanup to make it more-PHP like.

• Full implementation of all API calls except for Statement query
• API calls return consistent response object with converted content where possible

• Rounds out most of what is needed to build complex statements

• Bare minimum repo setup including license files, etc.
• Core source files needed to be able to send simple statements
• Basic unit test framework and few early unit tests