diff --git a/releases.md b/releases.md index ad7bbc2..1bf5bc8 100644 --- a/releases.md +++ b/releases.md @@ -1,94 +1,96 @@ # Release Notes -- [9.0.0](#9.0.0) -- [8.0.0](#8.0.0) -- [7.0.0](#7.0.0) -- [6.0.0](#6.0.0) -- [5.8.0](#5.8.0) -- [5.7.0](#5.7.0) -- [5.6.0](#5.6.0) -- [5.5.0](#5.5.0) -- [5.4.0](#5.4.0) -- [5.3.0](#5.3.0) -- [5.2.0](#5.2.0) -- [5.1.0](#5.1.0) -- [5.0.4](#5.0.4) -- [5.0 (Based On Laravel 5.0.x)](#5.0) +- [Support Policy](#support-policy) +- [Versioning Scheme](#versioning-scheme) +- [Releases](#releases) + + +## Support Policy + +Lumen only receives bug fixes on the latest version. For all new projects, we recommend using the full [Laravel framework](https://laravel.com). + + +## Versioning Scheme + +Lumen follows Laravel's [Semantic Versioning](https://semver.org) and release schedule. + + +## Releases -## Lumen 9.0.0 +### Lumen 9.0.0 Lumen 9.0 upgrades the framework's underlying Laravel components to the `9.x` series. -## Lumen 8.0.0 +### Lumen 8.0.0 Lumen 8.0 upgrades the framework's underlying Laravel components to the `8.x` series. -## Lumen 7.0.0 +### Lumen 7.0.0 Lumen 7.0 upgrades the framework's underlying Laravel components to the `7.x` series. -## Lumen 6.0.0 +### Lumen 6.0.0 Lumen 6.0 upgrades the framework's underlying Laravel components to the `6.0` series. -## Lumen 5.8.0 +### Lumen 5.8.0 Lumen 5.8 upgrades the framework's underlying Laravel components to the `5.8` series. -## Lumen 5.7.0 +### Lumen 5.7.0 Lumen 5.7 upgrades the framework's underlying Laravel components to the `5.7` series. -## Lumen 5.6.0 +### Lumen 5.6.0 Lumen 5.6 upgrades the framework's underlying Laravel components to the `5.6` series. -## Lumen 5.5.0 +### Lumen 5.5.0 Lumen 5.5 upgrades the framework's underlying Laravel components to the `5.5` series. -## Lumen 5.4.0 +### Lumen 5.4.0 Lumen 5.4 upgrades the framework's underlying Laravel components to the `5.4` series. -## Lumen 5.3.0 +### Lumen 5.3.0 Lumen 5.3 upgrades the framework's underlying Laravel components to the `5.3` series. -## Lumen 5.2.0 +### Lumen 5.2.0 Lumen 5.2.0 upgrades the framework to use the 5.2 family of Laravel components, as well as introduces some significant changes to Lumen's underlying philosophy and purpose. -### Only Stateless APIs +#### Only Stateless APIs Lumen 5.2 represents a shift on slimming Lumen to focus solely on serving stateless, JSON APIs. **As such, sessions and views are no longer included with the framework.** If you need access to these features, you should use the full Laravel framework. Upgrading your Lumen application to the full Laravel framework mainly involves copying your routes and classes over into a fresh installation of Laravel. Since Laravel and Lumen share many of the same components, your classes should not require any modification. -### Authentication +#### Authentication Because sessions are no longer included with Lumen, authentication must be done stateless using API tokens or headers. You have complete control over the authentication process in the new `AuthServiceProvider`. Please review the [authentication documentation](/docs/{{version}}/authentication) for more information. -### Testing Helpers +#### Testing Helpers Since sessions and views are no longer included with Lumen, all of the form interaction testing helpers have been removed. The testing helpers for JSON APIs remain, so be sure to review the [testing documentation](/docs/{{version}}/testing). -## Lumen 5.1.0 +### Lumen 5.1.0 Lumen 5.1.0 upgrades the framework to use the 5.1 family of Laravel components. Features such as event broadcasting, middleware parameters, and testing improvements are now available in Lumen. For the full Laravel 5.1 release notes, consult the [Laravel documentation](http://laravel.com/docs/releases). -## Lumen 5.0.4 +### Lumen 5.0.4 When upgrading to Lumen 5.0.4, you should update your `bootstrap/app.php` file's creation of the Lumen application class to the following: @@ -99,6 +101,6 @@ When upgrading to Lumen 5.0.4, you should update your `bootstrap/app.php` file's > **Note:** This is not a **required** change; however, it should prevent some bugs when using the Artisan CLI and PHP's built-in web server. -## Lumen 5.0 +### Lumen 5.0 Lumen 5.0 is the initial release of the Lumen framework, and is based on the Laravel 5.x series of PHP components.