4.0.0-beta1

![Build Status]

This release provides a stable interface for our new major release (v4.0).
We now have a library ready for PHP 8.0, fully documented, and able to be more easily extended.

Please check our upgrading guide, test your code, and report any issue.

Attention: There are a few BC-breaks (when comparing to the previous alpha releases), so please check the change set (especially PRs 538 and 533).

• Total issues resolved: 7
• Total pull requests resolved: 142
• Total contributors: 7

Improvement (BC-break)

• 533: Extract interface for keys thanks to @lcobucci
• 538: Rename getters thanks to @lcobucci

Improvement

• 536: Rename key implementation thanks to @lcobucci
• 531: Use lib exceptions thanks to @lcobucci
• 526: Minor improvements on docs and performance thanks to @lcobucci
• 508: Pull JOSE encoder back thanks to @lcobucci
• 462: Fix base exception concept thanks to @lcobucci
• 454: Allow users to configure format for date registered claims thanks to @t0mmy742
• 431: PHP 8.0 compatibility thanks to @lcobucci
• 399: Move object initialisation to constructor thanks to @lcobucci
• 355: add toString method thanks to @p4veI
• 351: Validator: raise exception when no constraint is given thanks to @Slamdunk
• 325: Allow users to provide custom token builders thanks to @lcobucci
• 319: adds tests for ES512 algorithm thanks to @ffflabs

Documentation

• 534: Final preparations for 4.0.0-beta1 thanks to @lcobucci
• 326: Create documentation thanks to @lcobucci
• 94: Add information about how to extend the library thanks to @lcobucci

CI

• 461: Add makefile thanks to @lcobucci
• 429: Migrate to GH actions thanks to @lcobucci
• 337: Add more files to .gitattributes thanks to @reedy

Dependencies

• 535: Bump infection/infection from 0.20.1 to 0.20.2 thanks to @dependabot-preview[bot]
• 532: Bump phpstan/phpstan from 0.12.55 to 0.12.56 thanks to @dependabot-preview[bot]
• 530: Bump phpstan/phpstan from 0.12.54 to 0.12.55 thanks to @dependabot-preview[bot]
• 529: Bump myclabs/deep-copy from 1.10.1 to 1.10.2 thanks to @dependabot-preview[bot]
• 528: Bump composer/xdebug-handler from 1.4.4 to 1.4.5 thanks to @dependabot-preview[bot]
• 527: Bump seld/jsonlint from 1.8.2 to 1.8.3 thanks to @dependabot-preview[bot]
• 523: Bump doctrine/instantiator from 1.3.1 to 1.4.0 thanks to @dependabot-preview[bot]
• 522: Bump phpunit/phpunit from 9.4.2 to 9.4.3 thanks to @dependabot-preview[bot]
• 509: Bump phpstan/phpstan from 0.12.53 to 0.12.54 thanks to @dependabot-preview[bot]
• 507: Bump infection/infection from 0.20.0 to 0.20.1 thanks to @dependabot-preview[bot]
• 506: Bump infection/infection from 0.19.2 to 0.20.0 thanks to @dependabot-preview[bot] and @lcobucci
• 505: Bump phpstan/phpstan from 0.12.52 to 0.12.53 thanks to @dependabot-preview[bot]
• 504: Bump phpunit/php-code-coverage from 9.2.2 to 9.2.3 thanks to @dependabot-preview[bot]
• 503: Bump infection/infection from 0.19.1 to 0.19.2 thanks to @dependabot-preview[bot]
• 500: Bump symfony/debug from 4.4.15 to 4.4.16 thanks to @dependabot-preview[bot]
• 499: Bump symfony/options-resolver from 5.1.7 to 5.1.8 thanks to @dependabot-preview[bot]
• 497: Bump infection/infection from 0.19.0 to 0.19.1 thanks to @dependabot-preview[bot]
• 496: Bump phpunit/php-code-coverage from 9.2.1 to 9.2.2 thanks to @dependabot-preview[bot]
• 493: Bump symfony/filesystem from 5.1.7 to 5.1.8 thanks to @dependabot-preview[bot]
• 492: Bump doctrine/annotations from 1.11.0 to 1.11.1 thanks to @dependabot-preview[bot] and @lcobucci
• 491: Bump infection/infection from 0.18.2 to 0.19.0 thanks to @dependabot-preview[bot] and @lcobucci
• 490: Bump phpunit/php-code-coverage from 9.2.0 to 9.2.1 thanks to @dependabot-preview[bot]
• 489: Bump sebastian/comparator from 4.0.5 to 4.0.6 thanks to @dependabot-preview[bot]
• 488: Bump sebastian/global-state from 5.0.1 to 5.0.2 thanks to @dependabot-preview[bot]
• 487: Bump phpunit/php-timer from 5.0.2 to 5.0.3 thanks to @dependabot-preview[bot]
• 486: Bump sebastian/type from 2.3.0 to 2.3.1 thanks to @dependabot-preview[bot]
• 485: Bump sebastian/object-enumerator from 4.0.3 to 4.0.4 thanks to @dependabot-preview[bot]
• 484: Bump sebastian/diff from 4.0.3 to 4.0.4 thanks to @dependabot-preview[bot]
• 483: Bump sebastian/code-unit from 1.0.7 to 1.0.8 thanks to @dependabot-preview[bot]
• 482: Bump sanmai/pipeline from 5.0.1 to 5.1.0 thanks to @dependabot-preview[bot]
• 481: Bump phpunit/php-text-template from 2.0.3 to 2.0.4 thanks to @dependabot-preview[bot]
• 480: Bump doctrine/coding-standard from 8.1.0 to 8.2.0 thanks to @dependabot-preview[bot]
• 479: Bump phpstan/phpstan from 0.12.50 to 0.12.52 thanks to @dependabot-preview[bot] and @lcobucci
• 478: Bump symfony/polyfill-mbstring from 1.18.1 to 1.20.0 thanks to @dependabot-preview[bot]
• 477: Bump symfony/polyfill-php73 from 1.18.1 to 1.20.0 thanks to @dependabot-preview[bot]
• 475: Bump symfony/polyfill-intl-grapheme from 1.18.1 to 1.20.0 thanks to @dependabot-preview[bot]
• 476: Bump symfony/polyfill-ctype from 1.18.1 to 1.20.0 thanks to @dependabot-preview[bot]
• 474: Bump symfony/polyfill-php80 from 1.19.0 to 1.20.0 thanks to @dependabot-preview[bot]
• 473: Bump symfony/polyfill-intl-normalizer from 1.19.0 to 1.20.0 thanks to @dependabot-preview[bot]
• 472: Bump doctrine/annotations from 1.10.4 to 1.11.0 thanks to @dependabot-preview[bot] and @lcobucci
• 471: Bump composer/xdebug-handler from 1.4.3 to 1.4.4 thanks to @dependabot-preview[bot]
• 469: Bump squizlabs/php_codesniffer from 3.5.6 to 3.5.8 thanks to @dependabot-preview[bot]
• 464: Bump symfony/polyfill-php80 from 1.18.1 to 1.19.0 thanks to @dependabot-preview[bot]
• 463: Bump symfony/polyfill-intl-normalizer from 1.18.1 to 1.19.0 thanks to @dependabot-preview[bot]
• 460: Bump thecodingmachine/safe from 1.3.1 to 1.3.2 thanks to @dependabot-preview[bot]
• 459: Bump infection/infection from 0.17.3 to 0.18.2 thanks to @dependabot-preview[bot]
• 458: Bump phpunit/phpunit from 9.4.1 to 9.4.2 thanks to @dependabot-preview[bot]
• 457: Bump phpstan/phpstan from 0.12.49 to 0.12.50 thanks to @dependabot-preview[bot]
• 455: Bump lstrojny/functional-php from 1.14.0 to 1.14.1 thanks to @dependabot-preview[bot]
• 453: Bump phpstan/phpstan from 0.12.48 to 0.12.49 thanks to @dependabot-preview[bot]
• 451: Bump phpunit/phpunit from 9.4.0 to 9.4.1 thanks to @dependabot-preview[bot]
• [450: B...

3.3.3

• Total issues resolved: 1
• Total pull requests resolved: 1
• Total contributors: 1

Documentation Bug

• 368: Claim::getValue can return anything thanks to @carusogabriel

3.3.2

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Documentation

• 356: fix php docblock thanks to @prolic

3.3.1

This version fixes the inconsistencies with the upcoming major release.

• Total issues resolved: 0
• Total pull requests resolved: 3
• Total contributors: 1

Documentation

• 297: Fix method name for audience configuration thanks to @lcobucci
• 296: Fix method name to match interface in v4 thanks to @lcobucci
• 295: Fix deprecation notes thanks to @lcobucci

3.3.0

This version provides a major performance improvement for the ECDSA algorithm, making it compatible with PHP 7.1+ too. We're also starting to add deprecation notes and will soon backport things from v4.x to create an upgrade path.

• Total issues resolved: 7
• Total pull requests resolved: 8
• Total contributors: 11

Improvement

• 288: Backport ECDSA improvements thanks to @lcobucci
• 283: Grammatical exception message fix thanks to @zanechua
• 261: Adjust build thanks to @lcobucci
• 260: Fixes memory leak in RSA-Signer thanks to @Fahrenholz
• 248: Issue #191: Allow leeway to handle clock skew thanks to @m777z
• 137: Update PHPECC to remove mcrypt dependency thanks to @lcobucci
• 282: There is no support for PHP 7.3 thanks to @aksafan
• 259: Unable to use ECDSA signer on PHP 7.2 (request to update mdanter/ecc dependency) thanks to @shakura
• 246: mdanter_ecc Singer Ecdsa KeyParse Issue thanks to @kapil-infobeans

Documentation

• 278: Corrected typos in README.md thanks to @msimion
• 258: Add Key typehint for verify() thanks to @francislavoie
• 196: Update README.md thanks to @jagDanJu
• 133: Add deprecation notes on methods thanks to @lcobucci

Bug

• 191: Validation of iat breaks on systems with a clock skew. thanks to @viviivanov

4.0.0-alpha3

• Total issues resolved: 1
• Total pull requests resolved: 1
• Total contributors: 2

Improvement

• 292: Make audience argument variadic in builder thanks to @lcobucci and @samjudge

4.0.0-alpha2

• Total issues resolved: 0
• Total pull requests resolved: 25
• Total contributors: 8

BC-break

• 247: Use OpenSSL to handle ECDSA signature thanks to @lcobucci

Improvement

• 287: Require PHPUnit v8.0 thanks to @lcobucci
• 286: Upgrade Infection to 0.12 thanks to @lcobucci
• 285: Upgrade PHPStan to v0.11 thanks to @lcobucci
• 281: Fix deprecation notices thanks to @lcobucci
• 277: Upgrade infection thanks to @lcobucci
• 276: ECDSA Alg improvements thanks to @Spomky
• 275: Revert "Remove assertion count manipulation" thanks to @lcobucci
• 272: Various minor improvements thanks to @lcobucci
• 271: Add leeway to ValidAt constraint thanks to @lcobucci
• 270: Remove assertion count manipulation thanks to @lcobucci
• 269: Make build more strict thanks to @lcobucci
• 264: Add validation constraints to configuration object thanks to @daniruizcamacho
• 224: Improve build tools thanks to @lcobucci
• 202: Remove file level docblock from all files thanks to @lcobucci
• 200: Re-enable Humbug since we now have a RC version thanks to @lcobucci
• 199: 198: Add CS checking to build thanks to @vanbrabantf
• 197: Switched public and final to match PSR2 thanks to @vanbrabantf
• 189: Add PHPBench as performance test tool thanks to @lcobucci
• 188: Add PHPCS configuration thanks to @lcobucci

Documentation

• 242: Fix travis link in readme thanks to @BackEndTea
• 221: Make it super obvious that the stable docs are at at 3.2 branch. thanks to @frankdejonge
• 218: Update license year thanks to @m1guelpf
• 208: Add information about Auth0's support thanks to @lcobucci
• 184: Fix README.md link to issue #37 thanks to @ricardoseriani

v3.2.5

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Documentation

• 274: Fix documentation of internal components thanks to @lcobucci

3.2.4

This release fixes a compatibility issue introduced in v3.2.3.

• Total issues resolved: 1
• Total pull requests resolved: 1
• Total contributors: 2

Bug

• 257: Fix PHP 5.5 compatibility thanks to @lcobucci, @Ocramius, and @taasan

Release 3.2.3

• Total issues resolved: 1
• Total pull requests resolved: 3
• Total contributors: 3

Improvement

• 250: Add newer PHP versions (allowing some to fail) thanks to @lcobucci

Documentation

• 225: Add missing docblock argument thanks to @Quezler

Bug

• 209: Add content check after key file reading thanks to @misantron and @lcobucci