Auth0 Php Laravel Package

Changes

Added

• feat: add XAA Resource App config, ID-JAG, branding theme identifiers, and session actor metadata

Changes

Added

• feat: add Organization Roles, Connection lifecycle events, and Token Vault access grants; rename Connection attribute identifier #838
• feat: add Network ACL curated-list match and Confirmation prompt partial #840

Fixed

• fix: regenerate session ID on login and logout to prevent session fixation #837

Breaking Changes

• feat!: remove Token Vault v1 federated connections access tokens #841
• Rename ConnectionAttributeIdentifier to EmailAttributeIdentifier #838
• Replace the None case on PhoneProviderProtectionBackoffStrategyEnum with Default #838

Changes

Added

• feat: add Phone Provider Protection endpoints, Token Vault privileged access, and Cross-App Access connection support

Fixed

• fix: correct offset pagination page-skipping; split Client update FedCM/native-social types

Changes

Added

• feat: add Tenant Security Headers and Connection Session Expiry; remove Branding Phone Display #830

Changes

Added

• feat: add Rate Limit Policies, Events SSE, Token Vault Orgs, and HRI Client Settings #820
• feat: add SCIM Groups RBAC, User Effective Permissions/Roles, and Tenant Country Codes #826

⚠️ This is a beta release. It introduces breaking changes to the Management API. The Authentication API is unchanged. Please consult the v9 Migration Guide for detailed upgrade instructions.

🚀 What's New

This release marks a major milestone for the Auth0 PHP SDK: the Management API client has been completely rewritten using the Fern code generation tool, built directly from the Auth0 OpenAPI specification. This delivers complete, always-up-to-date API coverage with full type safety.

✨ Highlights

• 🏗️ Auto-generated Management API - Rebuilt from the Auth0 OpenAPI spec using Fern, ensuring complete endpoint coverage and consistency with the API
• 🔒 Strongly-typed requests & responses - No more associative arrays or manual JSON decoding. Every request parameter and response field is a typed PHP object with IDE autocompletion
• 📄 Built-in pagination - Pager<T> implements IteratorAggregate, automatically fetching pages as you iterate with foreach
• 🔑 Automatic token management - New ManagementClient wrapper handles OAuth 2.0 client credentials grant, token caching (PSR-6), and custom token providers out of the box
• ⚡ Built-in retry middleware - Automatic retries for rate-limited (429) responses
• 🛡️ Exception-driven error handling - Non-2xx responses throw Auth0ApiException with status code and response body, replacing manual status code checks

🔄 What's Changed

The Authentication API is completely unchanged. Auth0\SDK\Auth0, session handling, token verification, and all authentication flows work exactly as before.

The Management API has breaking changes:

📦 Installation

composer require auth0/auth0-php:9.0.0-beta.0

Running composer require auth0/auth0-php without a version constraint will install the latest stable v8 release.

🔧 Quick Start

use Auth0\SDK\API\Management\Wrapper\ManagementClient;
use Auth0\SDK\API\Management\Wrapper\ManagementClientOptions;
use Auth0\SDK\API\Management\Users\Requests\ListUsersRequestParameters;

$client = new ManagementClient(new ManagementClientOptions(
    domain: 'tenant.auth0.com',
    clientId: 'CLIENT_ID',
    clientSecret: 'CLIENT_SECRET',
));

// List users with automatic pagination
$pager = $client->users->list(new ListUsersRequestParameters([
    'perPage' => 50,
    'includeTotals' => true,
]));

foreach ($pager as $user) {
    echo $user->getEmail();
}

📚 Resources

• v9 Migration Guide (v8 -> v9)
• Examples
• API Reference

⚠️ Breaking Changes

• Management API methods return typed objects instead of ResponseInterface
• Management API methods accept typed request classes instead of arrays
• Sub-clients accessed as properties (->users) instead of methods (->users())
• getAll() renamed to list() across all endpoints
• HttpResponsePaginator replaced by Pager<T>
• Non-2xx responses throw Auth0ApiException automatically
• Minimum PHP version remains 8.2 (unchanged from v8.19.0)

🙏 Feedback

This is a beta release - we would love your feedback! Please open an issue if you encounter any problems or have suggestions.

Fixed

• Security fix: Resolve CVE-2026-34236

Changed

• Dropped support for PHP 8.1 (EOL since Dec 2025). The minimum supported PHP version is now 8.2.

Changes

Security fix: Resolve CVE-2025-68129

Changes

Security fix: Resolve CVE-2025-58769

Added

• feat: add Network ACLs management API support #797 (kishore7snehil)

Fixed

• docs: Update README.md (#785) by staudenmeir

Added

• feat: Adding M2M Quota Support #788 (kishore7snehil)

Fixed

• Security fix: Resolve CVE-2025-47275

Added

• https://github.com/auth0/auth0-PHP/pull/782 (kishore7snehil)

• https://github.com/auth0/auth0-PHP/pull/783 (kishore7snehil)

Fixed

• Adjusted link typo on codeExchange method to the right url (#782) (GabrielBrittoDev)

Added

• Adding client credentials support #775 (kishore7snehil)

• Adding Support For CYOK #779 (kishore7snehil)

Fixed

• fix jobs test fail #773 (yasuaki640)

Fixed

• fix: Resolve erroneous exception throw on tenant domain validation #755 (ramonschriks)

Added

• feat: Support validating tokens with tenant domain in the case of custom domains #753 (ramonschriks)

Added

• feat(SDK-4731): Implement support for Back-Channel Logout #747 (evansims)

Changed

• PHP 8.1 is now the minimum supported runtime #748 (evansims)

Fixed

• fix: Remove redundant token verification step #742 (evansims)

Full Changelog

Fixed

• fix(SDK-4716): Resolve thrown exception when enumerating device cookies that include non-string keys/names #739 (evansims)

Full Changelog

Added

• feat(SDK-4543): Support Organizations with Client Grants #736 (evansims)

Added

• Support initiate_login_uri property for PATCH requests to the /api/v2/clients/:id Management API endpoint. #732

Fixed

• Token generator typo in claim header. #729

Changed

• composer.json now identifies mbstring as a required extension. #730
• PHP 8.3 nightlies have been added to the continuous integration testing matrix. #733

Fixed

• Corrected Management API route for deploy action endpoint by [@speercy](https://github.com/speercy) (#723)

Added

• Organization Name support added for Authentication API and token handling ¹ (#719)

Note ¹ To use this feature, an Auth0 tenant must have support for it enabled. This feature is not yet available to all tenants.

Added

• PAR (Pushed Authorization Request) support¹ (#714):
  • Auth0\SDK\API\Authentication\PushedAuthorizationRequest is a new class for issuing Pushed Authorization Requests and producing authorization links for them.
  • Auth0\SDK\API\Authentication::pushedAuthorizationRequest() has been added as a shortcut method for returning a configured instantiation of the above class.
  • Auth0\SDK\Auth0::login() has been updated to support issuing Pushed Authorization Requests and returning authorization links for them.
  • Auth0\SDK\Configuration\SdkConfiguration has been updated to accept a pushedAuthorizationRequest boolean to enable this feature.
• Auth0\SDK\Auth0::isAuthenticated() has been added as a shortcut method. It is an alias for getCredentials() !== null.

¹ Note: To use this feature, an Auth0 tenant must have support for it enabled. This feature is not yet available to all tenants.

This release improves the SDK's automatic discovery process of compatible HTTP clients, factories and messages (PSR-18, 17 and 7, respectively). If you encounter issues with your implementation not being discovered, please open an issue.

This release also introduces support for a number of additional Management API endpoints.

Added

• State Management

  • Added Auth0\SDK\Auth0::refreshState() to force a refresh of the SDK's internal state. This is useful when you have updated the SDK's configuration and want to ensure the SDK is using the latest values.

• Management API

  • Auth0\APIs\Management\Users
    • DELETE /users/:id/authenticators → deleteAllAuthenticators() (#702) (Documentation)
  • Support for Authentication Method endpoints: (#707):
    • GET /api/v2/users/:user/authentication-methods → getAuthenticationMethods() (Documentation)
    • PUT /api/v2/users/:user/authentication-methods → replaceAuthenticationMethods() (Documentation)
    • DELETE /api/v2/users/:user/authentication-methods → deleteAuthenticationMethods(string user) (Documentation)
    • POST /api/v2/users/:user/authentication-methods → createAuthenticationMethod() (Documentation)
    • GET /api/v2/users/:user/authentication-methods/:method → getAuthenticationMethod() (Documentation)
    • PATCH /api/v2/users/:user/authentication-methods/:method → updateAuthenticationMethod() (Documentation)
    • DELETE /api/v2/users/:user/authentication-methods/:method → deleteAuthenticationMethod() (Documentation)

Fixed

• Transient storage would sometimes not be fully cleared after a successful code exchange under certain conditions.
• Calls to certain methods under Auth0\SDK\API\Authentication with manually assigned client_id or client_secret parameters could have those values overwritten by the SDK's assigned configuration. #705

Changed

• Upgraded test suite to PEST 2.0 framework.
• Updated code styling rules, along with some light refactoring.
• Updated production dependencies:
  • Replaced php-http/discovery dependency with psr-discovery/all.
  • Replaced php-http/httplug dependency with psr-discovery/all.
• Updated development dependencies:
  • Removed ergebnis/composer-normalize as it now runs in CI.
  • Removed firebase/php-jwt as it was replaced by an in-library generator.
  • Replaced hyperf/event with symfony/event-dispatcher.
  • Replaced laravel/pint with friendsofphp/php-cs-fixer.
  • Replaced nyholm/psr7 with psr-mock/http-factory-implementation.
  • Replaced php-http/mock-client with psr-mock/http-client-implementation.
  • Updated vimeo/psalm to 5.8.
  • Updated phpstan/phpstan to 1.10.
  • Updated rector/rector to 0.15.

Thanks to our contributors for this release: knash94

Added

• Client Assertion (private_key_jwt) support #699 (evansims)
• Client Credentials management endpoints #700 (evansims)
• JSON Web Token generator classes, Auth0\SDK\Token\Generator and Auth0\SDK\Token\ClientAssertionGenerator. #698 (evansims)

Changed

• Restore test coverage to 100% #697 (evansims)
• Exclude unnecessary files from distribution package #696 (ramsey)

Full Changelog

Fixed

• fix: Always store provided state in transient medium #674 (evansims)

Full Changelog

Fixed

• fix: emailPasswordlessStart() incorrectly passes params as array under some conditions #670 (evansims)
• fix: Remove redundant Cache getItem() call in Auth0\SDK\Token\Verifier::getKeySet() #669 (pkivits-litebit)

Full Changelog

Fixed

• Allow SdkConfiguration::setScope() to be nullable #665 (evansims)

Full Changelog

Fixed

• [SDK-3722] Fix: Stateless strategies should not invoke stateful session classes #662 (evansims)

Full Changelog

Fixed

• Fix SdkConfiguration::setScope() not assigning default values when an empty array is passed #659 (evansims)

Full Changelog

Fixed

• Configuration validator improvements #657 (evansims)

Fixed

• Fix PHP 8.0+ SdkConfiguration named arguments usage #654 (evansims)

Full Changelog

Changed

• [SDK-3647] Add PHP 8.2.0-dev to test matrix #650 (evansims)

Fixed

• [SDK-3646] Reliability and performance improvements to CookieStore #649 (evansims)

Note: Previously in some circumstances, cookie secrets were not always being required in strategies where they should have been required. This has been resolved as part of the fixes in this release. If you are suddenly prompted to configure a cookie secret in an app that doesn't use sessions/cookies, please ensure you are using the correct strategy: https://github.com/auth0/auth0-PHP/tree/8.3.1#configuration-strategies

Full Changelog

Added

• Add PSR-14 Event Dispatcher, for highly customizable session storage mediums #646 (evansims)

Changed

• Treat passing an empty string to SdkConfiguration as the default undefined value type of NULL #643 (evansims)
• Enable configuration of SessionStore and CookieStore samesite property #645 (evansims)
• Add hardcoded debugging flag to CookieStore to disable encryption of session cookies #644 (evansims)
• Update getRequestParameter() filter to use FILTER_SANITIZE_FULL_SPECIAL_CHARS and allow passing extra filter options #642 (evansims)
• Defer/batch "Set-Cookie" headers at login() for transient cookies, and clear() #641 (evansims)