Merge branch '5.7'

Author: taylorotwell

artisan.md

@@ -1,6 +1,7 @@
 # Artisan Console
 
 - [Introduction](#introduction)
+    - [Tinker (REPL)](#tinker)
 - [Writing Commands](#writing-commands)
     - [Generating Commands](#generating-commands)
     - [Command Structure](#command-structure)
@@ -29,12 +30,33 @@ Every command also includes a "help" screen which displays and describes the com
 
     php artisan help migrate
 
-#### Laravel REPL
+<a name="tinker"></a>
+### Tinker (REPL)
 
 All Laravel applications include Tinker, a REPL powered by the [PsySH](https://github.com/bobthecow/psysh) package. Tinker allows you to interact with your entire Laravel application on the command line, including the Eloquent ORM, jobs, events, and more. To enter the Tinker environment, run the `tinker` Artisan command:
 
     php artisan tinker
 
+You can publish Tinker's configuration file using the `vendor:publish` command:
+
+    php artisan vendor:publish --provider="Laravel\Tinker\TinkerServiceProvider"
+
+#### Command Whitelist
+
+Tinker utilizes a white-list to determine which Artisan commands are allowed to be run within its shell. By default, you may run the `clear-compiled`, `down`, `env`, `inspire`, `migrate`, `optimize`, and `up` commands. If you would like to white-list more commands you may add them to the `commands` array in your `tinker.php` configuration file:
+
+    'commands' => [
+        // App\Console\Commands\ExampleCommand::class,
+    ],
+
+#### Alias Blacklist
+
+Typically, Tinker automatically aliases classes as you require them in Tinker. However, you may wish to never alias some classes. You may accomplish this by listing the classes in the `dont_alias` array of your `tinker.php` configuration file:
+
+    'dont_alias' => [
+        App\User::class,
+    ],
+
 <a name="writing-commands"></a>
 ## Writing Commands
 
@@ -365,7 +387,7 @@ For long running tasks, it could be helpful to show a progress indicator. Using
     $users = App\User::all();
 
     $bar = $this->output->createProgressBar(count($users));
-    
+
     $bar->start();
 
     foreach ($users as $user) {

authentication.md

@@ -60,6 +60,8 @@ Laravel provides a quick way to scaffold all of the routes and views you need fo
 
 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 `HomeController` will also be generated to handle post-login requests to your application's dashboard.
 
+> {tip} If your application doesn’t need registration, you may disable it by removing the newly created `RegisterController` and modifying your route declaration: `Auth::routes(['register' => false]);`.
+
 <a name="included-views"></a>
 ### Views
 

authorization.md

@@ -393,13 +393,13 @@ The `authorizeResource` method accepts the model's class name as its first argum
 
     class PostController extends Controller
     {
-        public function __constructor()
+        public function __construct()
         {
             $this->authorizeResource(Post::class, 'post');
         }
     }
 
-> {tip} You may use the `policy:make` command with the `--model` option to quickly generate a policy class for a given model: `php artisan policy:make --model=Post`.
+> {tip} You may use the `make:policy` command with the `--model` option to quickly generate a policy class for a given model: `php artisan make:policy PostPolicy --model=Post`.
 
 <a name="via-blade-templates"></a>
 ### Via Blade Templates

collections.md

@@ -157,9 +157,13 @@ For the remainder of this documentation, we'll discuss each method available on
 [unique](#method-unique)
 [uniqueStrict](#method-uniquestrict)
 [unless](#method-unless)
+[unlessEmpty](#method-unlessempty)
+[unlessNotEmpty](#method-unlessnotempty)
 [unwrap](#method-unwrap)
 [values](#method-values)
 [when](#method-when)
+[whenEmpty](#method-whenempty)
+[whenNotEmpty](#method-whennotempty)
 [where](#method-where)
 [whereStrict](#method-wherestrict)
 [whereIn](#method-wherein)
@@ -1926,6 +1930,16 @@ The `unless` method will execute the given callback unless the first argument gi
 
 For the inverse of `unless`, see the [`when`](#method-when) method.
 
+<a name="method-unlessempty"></a>
+#### `unlessEmpty()` {#collection-method}
+
+Alias for the [`whenNotEmpty`](#method-whennotempty) method.
+
+<a name="method-unlessnotempty"></a>
+#### `unlessNotEmpty()` {#collection-method}
+
+Alias for the [`whenEmpty`](#method-whenempty) method.
+
 <a name="method-unwrap"></a>
 #### `unwrap()` {#collection-method}
 
@@ -1985,6 +1999,88 @@ The `when` method will execute the given callback when the first argument given
 
 For the inverse of `when`, see the [`unless`](#method-unless) method.
 
+<a name="method-whenempty"></a>
+#### `whenEmpty()` {#collection-method}
+
+The `whenEmpty` method will execute the given callback when the collection is empty:
+
+    $collection = collect(['michael', 'tom']);
+    
+    $collection->whenEmpty(function ($collection) {
+        return $collection->push('adam');
+    });
+    
+    $collection->all();
+    
+    // ['michael', 'tom']
+    
+    
+    $collection = collect();
+    
+    $collection->whenEmpty(function ($collection) {
+        return $collection->push('adam');
+    });
+    
+    $collection->all();
+    
+    // ['adam']  
+    
+    
+    $collection = collect(['michael', 'tom']);
+    
+    $collection->whenEmpty(function($collection) {
+        return $collection->push('adam');
+    }, function($collection) {
+        return $collection->push('taylor');
+    });
+
+    $collection->all();
+    
+    // ['michael', 'tom', 'taylor']
+
+For the inverse of `whenEmpty`, see the [`whenNotEmpty`](#method-whennotempty) method.
+
+<a name="method-whennotempty"></a>
+#### `whenNotEmpty()` {#collection-method}
+
+The `whenNotEmpty` method will execute the given callback when the collection is not empty:
+
+    $collection = collect(['michael', 'tom']);
+    
+    $collection->whenNotEmpty(function ($collection) {
+        return $collection->push('adam');
+    });
+    
+    $collection->all();
+    
+    // ['michael', 'tom', 'adam']
+    
+    
+    $collection = collect();
+    
+    $collection->whenNotEmpty(function ($collection) {
+        return $collection->push('adam');
+    });
+    
+    $collection->all();
+    
+    // []  
+    
+    
+    $collection = collect();
+    
+    $collection->whenNotEmpty(function($collection) {
+        return $collection->push('adam');
+    }, function($collection) {
+        return $collection->push('taylor');
+    });
+    
+    $collection->all();
+    
+    // ['taylor']
+
+For the inverse of `whenNotEmpty`, see the [`whenEmpty`](#method-whenempty) method.
+
 <a name="method-where"></a>
 #### `where()` {#collection-method}
 

middleware.md

@@ -6,6 +6,7 @@
     - [Global Middleware](#global-middleware)
     - [Assigning Middleware To Routes](#assigning-middleware-to-routes)
     - [Middleware Groups](#middleware-groups)
+    - [Sorting Middleware](sorting-middleware)
 - [Middleware Parameters](#middleware-parameters)
 - [Terminable Middleware](#terminable-middleware)
 
@@ -185,6 +186,27 @@ Middleware groups may be assigned to routes and controller actions using the sam
 
 > {tip} Out of the box, the `web` middleware group is automatically applied to your `routes/web.php` file by the `RouteServiceProvider`.
 
+<a name="sorting-middleware"></a>
+### Sorting Middleware
+
+Rarely, you may need your middleware to execute in a specific order but not have control over their order when they are assigned to the route. In this case, you may specify your middleware priority using the `$middlewarePriority` property of your `app/Http/Kernel.php` file:
+
+    /**
+     * The priority-sorted list of middleware.
+     *
+     * This forces non-global middleware to always be in the given order.
+     *
+     * @var array
+     */
+    protected $middlewarePriority = [
+        \Illuminate\Session\Middleware\StartSession::class,
+        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
+        \App\Http\Middleware\Authenticate::class,
+        \Illuminate\Session\Middleware\AuthenticateSession::class,
+        \Illuminate\Routing\Middleware\SubstituteBindings::class,
+        \Illuminate\Auth\Middleware\Authorize::class,
+    ];
+
 <a name="middleware-parameters"></a>
 ## Middleware Parameters
 

queues.md

@@ -164,6 +164,14 @@ In this example, note that we were able to pass an [Eloquent model](/docs/{{vers
 
 The `handle` method is called when the job is processed by the queue. Note that we are able to type-hint dependencies on the `handle` method of the job. The Laravel [service container](/docs/{{version}}/container) automatically injects these dependencies.
 
+If you would like to take total control over how the container injects dependencies into the `handle` method, you may use the container's `bindMethod` method. The `bindMethod` method accepts a callback which receives the job and the container. Within the callback, you are free to invoke the `handle` method however you wish. Typically, you should call this method from a [service provider](/docs/{{version}}/providers):
+
+    use App\Jobs\ProcessPodcast;
+
+    $this->app->bindMethod(ProcessPodcast::class.'@handle', function ($job, $app) {
+        return $job->handle($app->make(AudioProcessor::class));
+    });
+
 > {note} Binary data, such as raw image contents, should be passed through the `base64_encode` function before being passed to a queued job. Otherwise, the job may not properly serialize to JSON when being placed on the queue.
 
 <a name="dispatching-jobs"></a>

routing.md

@@ -76,8 +76,16 @@ Any HTML forms pointing to `POST`, `PUT`, or `DELETE` routes that are defined in
 
 If you are defining a route that redirects to another URI, you may use the `Route::redirect` method. This method provides a convenient shortcut so that you do not have to define a full route or controller for performing a simple redirect:
 
+    Route::redirect('/here', '/there');
+
+By default, `Route::redirect` returns a `302` status code. You may customize the status code using the optional third parameter:
+
     Route::redirect('/here', '/there', 301);
 
+You may use the `Route::permananentRedirect` method to return a `301` status code:
+
+    Route::permanentRedirect('/here', '/there');
+
 <a name="view-routes"></a>
 ### View Routes
 

scheduling.md

@@ -38,7 +38,7 @@ You may define all of your scheduled tasks in the `schedule` method of the `App\
 
     namespace App\Console;
 
-    use DB;
+    use Illuminate\Support\Facades\DB;
     use Illuminate\Console\Scheduling\Schedule;
     use Illuminate\Foundation\Console\Kernel as ConsoleKernel;