Skip to content

8.0.0-BETA2

Pre-release
Pre-release
Compare
Choose a tag to compare
@evansims evansims released this 09 Aug 14:02
· 663 commits to main since this release
8.0.0-BETA2
88a0894
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Full Changelog

BEFORE YOU UPGRADE

  • This is a major release that includes breaking changes. Please see UPGRADE.md before upgrading. This release will require changes to your application.
  • The SDK no longer specifically relies on Guzzle for network requests. Options for supplying your libraries of choice have been added through PSR-18 and PSR-17 configuration options.
  • PHP 7.4 is now the minimum supported PHP version, but we encourage using PHP 8.0. PHP 7.4 will be the last supported 7.x release. This library follows the official support schedule for PHP.

Changes Since BETA1

  • Auth0\SDK\API\Management endpoint factory magic methods documented for proper IDE hinting.
  • Auth0\SDK\API\Authentication and Auth0\SDK\API\Management create their HTTP client instances as needed when getHttpClient() is invoked, rather than at class initialization.
  • Auth0\SDK\Configuration\SdkConfiguration now supports passing a strategy option to customize what configuration options are necessary at initialization, appropriate for different use cases. Defaults to the general use webapp with the same configuration requirements as previously used. See the README for more information.
  • Auth0\SDK\Utility\HttpRequest now intercepts 429 rate-limit errors from Auth0 API responses and will automatically retry these requests on your behalf, using an exponential backoff strategy. Defaults to 3 retry attempts, configurable with httpMaxRetires during SDK configuration up to 10, or 0 to opt-out of this behavior.

8.0 Highlights

  • Updated SDK API for more intuitive use and improved usability. Now follows fluent interface principles.
  • Updated SDK API designed with PHP 8.0's named arguments as the encouraged interface method.
  • New configuration object, SdkConfiguration, allows for dynamic changes within your application.
  • Updated PHP language support, including typed properties and return types, are now used throughout the SDK.
  • Added support for the following PHP-FIG standards interfaces:
    • PSR-6 caches are now used for caching JWKs and Management API tokens.
    • PSR-7 HTTP messages are now returned by methods that initiate network requests.
    • PSR-14 events are now raised, allowing for deeper integration into the SDK's behavior.
    • PSR-17 HTTP factories are now used during network requests for generating PSR-7 messages.
    • PSR-18 HTTP clients are now supported, allowing you to choose your network client.
  • Improved Token handling system.
  • Encrypted session cookies, with cookies being the default session handler. PHP sessions may be phased out in a future release.
  • New Management API auto-pagination helper for iterating through API results.
  • PKCE is now enabled by default.

For a complete overview of API changes, please see UPGRADE.md.

For guidance on using the new configuration interface or SDK API, please see README.md.

Assets 2
Loading