Merge branch '8.x'

Author: taylorotwell

authentication.md

@@ -51,10 +51,12 @@ Also, you should verify that your `users` (or equivalent) table contains a nulla
 <a name="authentication-quickstart"></a>
 ## Authentication Quickstart
 
+> {note} This portion of the documentation discusses authenticating users via the [Laravel Jetstream](https://jetstream.laravel.com) package, which includes UI scaffolding to help you get started quickly. If you would like to integrate with Laravel's authentication systems directly, check out the documentation on [manually authenticating users](#authenticating-users).
+
 <a name="included-routing"></a>
 ### Routing
 
-Laravel's `laravel/jetstream` package provides a quick way to scaffold all of the routes and views you need for authentication using a few simple commands:
+Laravel's `laravel/jetstream` package provides a quick way to scaffold all of the routes, views, and other backend logic needed for authentication using a few simple commands:
 
     composer require laravel/jetstream
 
@@ -66,25 +68,25 @@ Laravel's `laravel/jetstream` package provides a quick way to scaffold all of th
 
 This command should be used on fresh applications and will install a layout view, registration and login views, as well as routes for all authentication end-points. A `/dashboard` route will also be generated to handle post-login requests to your application's dashboard.
 
-To learn more about Jetstream, please visit the official [Jetstream documentation](https://jetstream.laravel.com).
-
 #### Creating Applications Including Authentication
 
 If you are starting a brand new application and would like to include the authentication scaffolding, you may use the `--jet` directive when creating your application via the Laravel Installer. This command will create a new application with all of the authentication scaffolding compiled and installed:
 
     laravel new kitetail --jet
 
+> {tip} To learn more about Jetstream, please visit the official [Jetstream documentation](https://jetstream.laravel.com).
+
 <a name="included-views"></a>
 ### Views
 
 As mentioned in the previous section, the `laravel/jetstream` package's `php artisan jetstream:install` command will create all of the views you need for authentication and place them in the `resources/views/auth` directory.
 
-Jetstream will also create a `resources/views/layouts` directory containing a base layout for your application. All of these views use the Tailwind CSS framework, but you are free to customize them however you wish.
+Jetstream will also create a `resources/views/layouts` directory containing a base layout for your application. All of these views use the [Tailwind CSS](https://tailwindcss.com) framework, but you are free to customize them however you wish.
 
 <a name="included-authenticating"></a>
 ### Authenticating
 
-Now that you have routes and views setup for the included authentication controllers, you are ready to register and authenticate new users for your application! You may access your application in a browser since Jetstream's authentication controllers already contain the logic to authenticate existing users and store new users in the database.
+Now that your application has been scaffolded for authentication, you are ready to register and authenticate! You may simply access your application in a browser since Jetstream's authentication controllers already contain the logic to authenticate existing users and store new users in the database.
 
 #### Path Customization
 
@@ -115,10 +117,10 @@ Alternatively, once a user is authenticated, you may access the authenticated us
 
     use Illuminate\Http\Request;
 
-    class ProfileController extends Controller
+    class FlightController extends Controller
     {
         /**
-         * Update the user's profile.
+         * Get a list of all available flights.
          *
          * @param  Request  $request
          * @return Response
@@ -144,19 +146,12 @@ To determine if the user is already logged into your application, you may use th
 <a name="protecting-routes"></a>
 ### Protecting Routes
 
-[Route middleware](/docs/{{version}}/middleware) can be used to only allow authenticated users to access a given route. Laravel ships with an `auth` middleware, which is defined at `Illuminate\Auth\Middleware\Authenticate`. Since this middleware is already registered in your HTTP kernel, all you need to do is attach the middleware to a route definition:
+[Route middleware](/docs/{{version}}/middleware) can be used to only allow authenticated users to access a given route. Laravel ships with an `auth` middleware, which references the `Illuminate\Auth\Middleware\Authenticate` class. Since this middleware is already registered in your HTTP kernel, all you need to do is attach the middleware to a route definition:
 
-    Route::get('profile', function () {
+    Route::get('flights', function () {
         // Only authenticated users may enter...
     })->middleware('auth');
 
-If you are using [controllers](/docs/{{version}}/controllers), you may call the `middleware` method from the controller's constructor instead of attaching it in the route definition directly:
-
-    public function __construct()
-    {
-        $this->middleware('auth');
-    }
-
 #### Redirecting Unauthenticated Users
 
 When the `auth` middleware detects an unauthorized user, it will redirect the user to the `login` [named route](/docs/{{version}}/routing#named-routes). You may modify this behavior by updating the `redirectTo` function in your `app/Http/Middleware/Authenticate.php` file:
@@ -176,20 +171,21 @@ When the `auth` middleware detects an unauthorized user, it will redirect the us
 
 When attaching the `auth` middleware to a route, you may also specify which guard should be used to authenticate the user. The guard specified should correspond to one of the keys in the `guards` array of your `auth.php` configuration file:
 
-    public function __construct()
-    {
-        $this->middleware('auth:api');
-    }
+    Route::get('flights', function () {
+        // Only authenticated users may enter...
+    })->middleware('auth:api');
 
 <a name="login-throttling"></a>
 ### Login Throttling
 
 If you are using Laravel Jetstream, rate limiting will automatically be applied to login attempts. By default, the user will not be able to login for one minute if they fail to provide the correct credentials after several attempts. The throttling is unique to the user's username / e-mail address and their IP address.
 
+> {tip} If you would like to rate limit your own routes, check out the [rate limiting documentation](/docs/{{version}}/routing#rate-limiting).
+
 <a name="authenticating-users"></a>
 ## Manually Authenticating Users
 
-Note that you are not required to use the authentication controllers included with Laravel Jetstream. If you choose to not use this scaffolding, you will need to manage user authentication using the Laravel authentication classes directly. Don't worry, it's a cinch!
+You are not required to use the authentication scaffolding included with Laravel Jetstream. If you choose to not use this scaffolding, you will need to manage user authentication using the Laravel authentication classes directly. Don't worry, it's a cinch!
 
 We will access Laravel's authentication services via the `Auth` [facade](/docs/{{version}}/facades), so we'll need to make sure to import the `Auth` facade at the top of the class. Next, let's check out the `attempt` method:
 
@@ -272,7 +268,7 @@ If you are "remembering" users, you may use the `viaRemember` method to determin
 
 #### Authenticate A User Instance
 
-If you need to log an existing user instance into your application, you may call the `login` method with the user instance. The given object must be an implementation of the `Illuminate\Contracts\Auth\Authenticatable` [contract](/docs/{{version}}/contracts). The `App\Models\User` model included with Laravel already implements this interface:
+If you need to log an existing user instance into your application, you may call the `login` method with the user instance. The given object must be an implementation of the `Illuminate\Contracts\Auth\Authenticatable` [contract](/docs/{{version}}/contracts). The `App\Models\User` model included with Laravel already implements this interface. This method of authentication is useful when you already have a valid user instance, such as directly after a user registers with your application:
 
     Auth::login($user);
 

eloquent-mutators.md

@@ -268,7 +268,7 @@ As an example, we will define a custom cast class that casts multiple model valu
 
     namespace App\Casts;
 
-    use App\Models\Address;
+    use App\Models\Address as AddressModel;
     use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
     use InvalidArgumentException;
 
@@ -285,7 +285,7 @@ As an example, we will define a custom cast class that casts multiple model valu
          */
         public function get($model, $key, $value, $attributes)
         {
-            return new Address(
+            return new AddressModel(
                 $attributes['address_line_one'],
                 $attributes['address_line_two']
             );
@@ -302,7 +302,7 @@ As an example, we will define a custom cast class that casts multiple model valu
          */
         public function set($model, $key, $value, $attributes)
         {
-            if (! $value instanceof Address) {
+            if (! $value instanceof AddressModel) {
                 throw new InvalidArgumentException('The given value is not an Address instance.');
             }
 

hashing.md

@@ -7,7 +7,7 @@
 <a name="introduction"></a>
 ## Introduction
 
-The Laravel `Hash` [facade](/docs/{{version}}/facades) provides secure Bcrypt and Argon2 hashing for storing user passwords. If you are using the built-in `LoginController` and `RegisterController` classes that are included with your Laravel application, they will use Bcrypt for registration and authentication by default.
+The Laravel `Hash` [facade](/docs/{{version}}/facades) provides secure Bcrypt and Argon2 hashing for storing user passwords. If you are using the [Laravel Jetstream](https://jetstream.laravel.com) authentication scaffolding, Bcrypt will be used for registration and authentication by default.
 
 > {tip} Bcrypt is a great choice for hashing passwords because its "work factor" is adjustable, which means that the time it takes to generate a hash can be increased as hardware power increases.
 
@@ -71,7 +71,7 @@ If you are using the Argon2 algorithm, the `make` method allows you to manage th
 
 #### Verifying A Password Against A Hash
 
-The `check` method allows you to verify that a given plain-text string corresponds to a given hash. However, if you are using the `LoginController` [included with Laravel](/docs/{{version}}/authentication), you will probably not need to use this directly, as this controller automatically calls this method:
+The `check` method allows you to verify that a given plain-text string corresponds to a given hash:
 
     if (Hash::check('plain-text', $hashedPassword)) {
         // The passwords match...

helpers.md

@@ -227,7 +227,6 @@ Laravel includes a variety of global "helper" PHP functions. Many of these funct
 [dump](#method-dump)
 [env](#method-env)
 [event](#method-event)
-[factory](#method-factory)
 [filled](#method-filled)
 [info](#method-info)
 [logger](#method-logger)

migrations.md

@@ -60,7 +60,7 @@ When you execute this command, Laravel will write a "schema" file to your `datab
 
 You should commit your database schema file to source control so that other new developers on your team may quickly create your application's initial database structure.
 
-> {note} Migration squashing is only available for the MySQL and PostgreSQL databases.
+> {note} Migration squashing is only available for the MySQL, PostgreSQL, and SQLite databases.
 
 <a name="migration-structure"></a>
 ## Migration Structure