26) Учебник по Laravel Framework

Пример # 1: определение и реализация маршрута внутри одного вызова метода (в файле маршрутов web.php)

//inside routes/web.php
<?php
Route::get('/hello-world', function(Request $request) {
   $name = $request->name;
   return response()->make("<h1>Hello World! This is ".$name, 200);
});

Пример №2. Определение маршрута находится в маршруте / web.php, но его реализация находится в классе / app / Http / Controllers / HelloWorldController

//inside routes/web.php
<?php

Route::get('/hello-world', 'HelloWorldController@index')->name('hello-world');

------------------------------------------------------------------------------------
//inside app/Http/Controllers/HelloWorldController.php
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;

class HelloWorldController extends Controller
{
   public function index(Request $request)
   {
       $name = $request->name;
       return response()->make("<h1>Hello World! This is ".$name, 200);
   }
}

Хотя пример № 2 выглядит гораздо более трудоемким (а это не так — просто немного больше кода — все), посмотрим на преимущества, которые мы получаем, поместив вместо этого нашу логику действий для заданного маршрута «hello-world» внутри контроллера из определения маршрута в качестве функции обратного вызова:

1. Наша логика четко разделена на собственный класс (разделение интересов)
2. Наш контроллер будет настроен для расширения позже, если нам понадобится добавить в него дополнительные возможности … Скажем, может быть, мы хотим добавить функцию «до свидания» … В этом случае мы переименуем контроллер в более общий «HelloController» затем определите два отдельных метода, hello () и goodbye () . Нам также нужно было бы определить два отдельных маршрута, которые отобразили бы / hello и / goodbye URI на их соответствующий метод на контроллере. Это желательно по сравнению с заполнением файла маршрутов с реализацией каждого маршрута, определенной как функции обратного вызова.
3. Laravel имеет встроенную возможность кэшировать все определения маршрутов в приложении, чтобы ускорить время, необходимое для поиска заданного маршрута (увеличивает производительность приложения); однако вы сможете воспользоваться этим только в том случае, если все определенные вами маршруты внутри приложения настроены с использованием привязок для конкретного контроллера (см. пример № 2 выше)

Давайте запустим эту команду, которая сгенерирует новый контроллер для нас.

// ...inside the project's root directory:
php artisan make:controller UploadController   

По сути, эта команда генерирует заглушку для контроллера с именем «UploadController» внутри каталога основного контроллера по адресу /app/Http/Controllers/UploadController.php. Не стесняйтесь, чтобы открыть этот файл и посмотреть. Это очень просто, потому что это только заглушенная версия контроллера с правильным путем к пространству имен и требуемыми классами, из которых он расширяется.

Прежде чем мы продолжим и внесем несколько изменений в сгенерированную заглушку UploadController, я думаю, что сначала будет разумнее создать класс запроса. Это связано с тем, что метод контроллера, который обрабатывает запрос, должен ввести подсказку для объекта запроса в своей подписи, что позволит ему автоматически проверять входящие данные формы (как указано в методе rules (). Подробнее об этом позже …) давайте снова используем команду artisan для создания заглушки нашего запроса:

php artisan make:request UploadFileRequest

Эта команда создаст файл с именем UploadFileRequest внутри приложения / Http / Requests / UploadFileRequest. Откройте заглушку и взгляните … Вы найдете ее очень простой, содержащей только два метода, authorize () и rules.

Давайте изменим заглушку запроса в соответствии с потребностями нашего приложения. Измените файл так, чтобы он выглядел так:

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class UploadFileRequest extends FormRequest
{
   /**
    * Determine if the user is authorized to make this request.
    *
    * @return bool
    */
   public function authorize()
   {
       return true;
   }

   /**
    * Get the validation rules that apply to the request.
    *
    * @return array
    */
   public function rules()
   {
       return [
           'fileName' => 'required|string',
           'userFile' => 'required|file'
       ];
   }
}

Не много изменений, но обратите внимание, что метод authorize () теперь возвращает true вместо false. Этот метод решает, разрешить или нет запрос войти в приложение. Если для этого параметра установлено значение false, запрос не будет входить в систему (что обычно является методом на контроллере). Это было бы очень удобным местом для проведения любых проверок авторизации пользователя или любой другой логики, которая может решить, может ли запрос переместиться к контроллеру. Сейчас мы просто возвращаем true, чтобы все и вся могли использовать запрос.

Другой метод, rules (), — это то, где все волшебство вступает в игру в отношении проверки. Идея проста: вернуть массив, содержащий набор правил, в виде:

'formFieldName' => 'constraints this field has separated by pipe characters (|)'

Откройте приложение / Http / Controllers / UploadController и внесите в него следующие изменения:

<?php

namespace App\Http\Controllers;

use Illuminate\Contracts\Container\BindingResolutionException;
use Illuminate\Http\Request;
use App\Http\Requests\UploadFileRequest; //our new request class
use Illuminate\Support\Facades\Storage; 

class UploadController extends Controller
{
   /**
    * This is the method that will simply list all the files uploaded by name and provide a
    * link to each one so they may be downloaded
    *
    * @param $request : A standard form request object
    * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
    * @throws BindingResolutionException
    */
   public function list(Request $request)
   {
       $uploads = Storage::allFiles('uploads');

       return view('list', ['files' => $uploads]);
   }

   /**
    * @param $file
    * @return \Symfony\Component\HttpFoundation\BinaryFileResponse
    * @throws BindingResolutionException
    */
   public function download($file)
   {
       return response()->download(storage_path('app/'.$file));
   }

   /**
    * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
    * @throws BindingResolutionException
    */
   public function upload()
   {
       return view('upload');
   }

   /**
    * This method will handle the file uploads. Notice that the parameter's typehint
    * is the exact request class we generated in the last step. There is a reason for this!
    *
    * @param $request : The special form request for our upload application
    * @return array|\Illuminate\Http\UploadedFile|\Illuminate\Http\UploadedFile[]|null
    * @throws BindingResolutionException
    */
   public function store(UploadFileRequest $request)
   {
       //At this point, the parameters passed into the $request (from form) are
       //valid--they satisfy each of the conditions inside the rules() method

       $filename = $request->fileName;    //parameters have already been validated
       $file = $request->file('userFile'); //that we don't need any additional isset()

       $extension = $file->getClientOriginalExtension(); //grab the file extension
       $saveAs = $filename . "." . $extension; //filename to save file under

       $file->storeAs('uploads', $saveAs, 'local'); //save the file to local folder

       return response()->json(['success' => true]); //return a success message
   }
}

Так что это довольно простой подход к сохранению загруженных файлов на диск. Вот разбивка метода upload () выше:

• Подсказка класса запроса в методе контроллера, который выполняет функцию «мяса и картофеля», чтобы мы могли автоматически проверять поступающие данные
• Извлеките файл из (теперь проверенного) объекта запроса внутри метода контроллера (в данном случае мы назвали его upload (), но его также можно было бы назвать более стандартизированным именем, например store ()).
• Захватите имя файла из запроса
• Сгенерируйте окончательное имя файла, которое будет использоваться для сохранения файла. Метод getClientOriginalExtension () просто получает исходное расширение загруженного файла.
• Сохраните файл в локальной файловой системе, используя метод storeAs (), передавая именованный путь в каталоге / storage в качестве 1-го аргумента и имя файла для сохранения его в качестве второго.
• Вернуть JSON-ответ, указывающий, что запрос был успешным

Последняя важная часть этой головоломки — шаблон лезвия, который будет содержать весь HTML, CSS и javascript для нашего простого приложения. Вот код — я объясню позже.

<body>
   <h1>Upload a file</h1>
   <form id="uploadForm" name="uploadForm" action="{{route('upload')}}" enctype="multipart/form-data">
       @csrf
       <label for="fileName">File Name:</label>
       <input type="text" name="fileName" id="fileName" required /><br />
       <label for="userFile">Select a File</label>
       <input type="file" name="userFile" id="userFile" required />
       <button type="submit" name="submit">Submit</button>
   </form>
   <h2 id="success" style="color:green;display:none">Successfully uploaded file</h2>
   <h2 id="error" style="color:red;display:none">Error Submitting File</h2>
   <script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
   <script>
        $('#uploadForm').on('submit', function(e) {
            e.preventDefault();
            var form = $(this);
            var url = form.attr('action');
            $.ajax({
                url: url,
                type: "POST",
                data: new FormData(this),
                processData: false,
                contentType: false,
                dataType: "JSON",
                success: function(data) {
                    $("#fileName").val("");
                    $("#userFile").val("");
                }
            }).done(function() {
                $('#success').css('display', 'block');
                window.setTimeout(()=>($("#success").css('display', 'none')), 5000);
            }).fail(function() {
                $('#error').css('display', 'block');
                window.setTimeout(()=>($("#error").css('display', 'none')), 5000);
            });
        });
   </script>
</body>
</html>

Вот как выглядит наша страница загрузки :