Release 8.0.0 (#567)

Author: evansims

.github/ISSUE_TEMPLATE/Bug Report.yml

@@ -11,6 +11,7 @@ body:
       label: SDK Version
       description: What version of our SDK are you running? (`composer show | grep auth0/auth0-php`)
       options:
+        - 8.0.0
         - 8.0.0-BETA3
         - 8.0.0-BETA2
         - 8.0.0-BETA1
@@ -32,9 +33,9 @@ body:
       label: PHP Version
       description: What version of PHP are you running? (`php -v`)
       options:
+        - PHP 8.1 (In Development)
         - PHP 8.0
         - PHP 7.4
-        - PHP 7.3
         - Other (specify in 'additional context')
     validations:
       required: true

CHANGELOG.md

@@ -1,5 +1,36 @@
 # CHANGELOG
 
+## [8.0.0](https://github.com/auth0/auth0-PHP/tree/8.0.0) (2021-09-20)
+
+[Full Changelog](https://github.com/auth0/auth0-PHP/compare/7.9.0...8.0.0)
+
+**BEFORE YOU UPGRADE**
+
+- This is a major release that includes breaking changes. Please see [UPGRADE.md](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](https://www.php-fig.org/psr/psr-18/) and [PSR-17](https://www.php-fig.org/psr/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](https://www.php.net/supported-versions.php).
+
+**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](https://www.php-fig.org/psr/psr-6/) caches are now used for caching JWKs and Management API tokens.
+  - [PSR-7](https://www.php-fig.org/psr/psr-7/) HTTP messages are now returned by methods that initiate network requests.
+  - [PSR-14](https://www.php-fig.org/psr/psr-14/) events are now raised, allowing for deeper integration into the SDK's behavior.
+  - [PSR-17](https://www.php-fig.org/psr/psr-17/) HTTP factories are now used during network requests for generating PSR-7 messages.
+  - [PSR-18](https://www.php-fig.org/psr/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](https://auth0.com/docs/flows/call-your-api-using-the-authorization-code-flow-with-pkce) is now enabled by default.
+
+For a complete overview of API changes, please see [UPGRADE.md](UPGRADE.md).
+
+For guidance on using the new configuration interface or SDK API, please see [README.md](README.md).
+
 ## [8.0.0-BETA3](https://github.com/auth0/auth0-PHP/tree/8.0.0-BETA3) (2021-09-03)
 
 [Full Changelog](https://github.com/auth0/auth0-PHP/compare/7.9.0...8.0.0-BETA3)

README.md

@@ -57,20 +57,13 @@ To get started, you'll need to create a [free Auth0 account](https://auth0.com/s
 The supported method of SDK installation is through [Composer](https://getcomposer.org/). From your terminal shell, `cd` into your project directory and issue the following command:
 
 ```bash
-$ composer require auth0/auth0-php:8.0.0-BETA3
+$ composer require auth0/auth0-php
 ```
 
 You can find guidance on installing Composer [here](https://getcomposer.org/doc/00-intro.md).
 
 > ⚠️ Your application must include the Composer autoloader, [as explained here](https://getcomposer.org/doc/01-basic-usage.md#autoloading), for the SDK to be usable within your application.
 
-If you receive a warning regarding 'minimum-stability', you may need to update your `composer.json` file to include the following options, and then retry the `require` command above:
-
-```
-"minimum-stability": "beta",
-"prefer-stable": true
-```
-
 Next, you will want ensure your application has [PSR-17](https://www.php-fig.org/psr/psr-17/) and [PSR-18](https://www.php-fig.org/psr/psr-18/) compatible libraries installed. These are used for network requests. As an example, let's say you wish to use [Buzz](https://github.com/kriswallsmith/Buzz) and [Nylom's PSR-7 implementation](https://github.com/Nyholm/psr7), which include PSR-18 and PSR-17 factories, respectively:
 
 ```bash
@@ -506,8 +499,8 @@ In some cases, your application may need to support validating tokens' `org_id`
   - [Management API](https://auth0.com/docs/libraries/auth0-php/using-the-management-api-with-auth0-php)
   - [Troubleshooting](https://auth0.com/docs/libraries/auth0-php/troubleshoot-auth0-php-library)
 - Quickstarts
-  - [Web Application Authentication](https://auth0.com/docs/quickstart/webapp/php-beta/) ([GitHub repo](https://github.com/auth0-samples/auth0-php-web-app/tree/8.x))
-  - [Backend API Authorization](https://auth0.com/docs/quickstart/backend/php-beta/) ([GitHub repo](https://github.com/auth0-samples/auth0-php-api-samples/tree/8.x))
+  - [Web Application Authentication](https://auth0.com/docs/quickstart/webapp/php/) ([GitHub repo](https://github.com/auth0-samples/auth0-php-web-app))
+  - [Backend API Authorization](https://auth0.com/docs/quickstart/backend/php/) ([GitHub repo](https://github.com/auth0-samples/auth0-php-api-samples))
 
 ## Contributing