Запросы и ввод

Получение экземпляра запроса

Для получения экземпляра текущего HTTP-запроса через внедрение зависимости вам надо указать тип класса в методе вашего контроллера. Экземпляр входящего запроса будет автоматически внедрён сервис-контейнером:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
//для версии 5.1 и ранее:
//use Illuminate\Routing\Controller;

class UserController extends Controller
{
  /**
   * Сохранить нового пользователя.
   *
   * @param  Request  $request
   * @return Response
   */
  public function store(Request $request)
  {
    $name = $request->input('name');

    //
  }
}

Внедрение зависимости и параметры маршрута

Если метод вашего контроллера также ожидает ввода из параметров маршрута, вам надо перечислить параметры вашего маршрута после других зависимостей. Например, если ваш маршрут определён вот так:

Route::put('user/{id}', 'UserController@update');

То вы так же можете указать тип Illuminate\Http\Request и получить параметр id вашего маршрута, определив метод вашего контроллера таким образом:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
//для версии 5.1 и ранее:
//use Illuminate\Routing\Controller;

class UserController extends Controller
{
  /**
   * Обновить указанного пользователя.
   *
   * @param  Request  $request
   *
   * для версии 5.2 и выше:
   * @param  string  $id
   *
   * для версии 5.1 и ранее:
   * @param  int  $id
   *
   * @return Response
   */
  public function update(Request $request, $id)
  {
    //
  }
}

use Illuminate\Http\Request;

Route::get('/', function (Request $request) {
  //
});

$name = Request::input('name');

Методы и путь запроса

Экземпляр класса Illuminate\Http\Request содержит множество методов для изучения входящего в ваше приложение запроса. Он наследует класс PHPSymfony\Component\HttpFoundation\Request. Ниже мы обсудим несколько наиболее полезных методов этого класса.

Получение URI (пути) запроса

Метод PHPpath() возвращает информацию о пути запроса. Например, если входящий запрос обращён к http://domain.com/foo/bar, то метод PHPpath() вернёт foo/bar:

$uri = $request->path();

Метод PHPis() позволяет проверить соответствие пути запроса заданной маске. При использовании этого метода можно использовать символ * в качестве маски:

if ($request->is('admin/*')) {
  //
}

Получение URL запроса

Для получения полного URL без строки запроса используйте метод PHPurl():

// без строки запроса...
$url = $request->url();

// со строкой запроса...
$url = $request->fullUrl();

$url = $request->fullUrlWithQuery(['bar' => 'baz']);

Получение метода запроса

Метод PHPmethod() вернёт HTTP-действие запроса. Вы можете использовать метод PHPisMethod() для проверки соответствия HTTP-действия заданной строке:

$method = $request->method();

if ($request->isMethod('post')) {
  //
}

$uri = Request::path();

if (Request::is('admin/*'))
{
  //
}

$url = Request::url();

if (Request::ajax())
{
  //
}

$method = Request::method();

if (Request::isMethod('post'))
{
  //
}

Запросы PSR-7

Стандарт PSR-7 описывает интерфейсы для HTTP-сообщений, включая запросы и отклики. Если вы хотите получить экземпляр запроса PSR-7 вместо Laravel-запроса, сначала вам надо установить несколько библиотек. Laravel использует компонент Symfony HTTP Message Bridge для конвертации обычных запросов и откликов Laravel в совместимые с PSR-7:

shcomposer require symfony/psr-http-message-bridge
composer require zendframework/zend-diactoros

Когда вы установите эти библиотеки, вы можете получить запрос PSR-7, указав интерфейс запроса в замыкании вашего маршрута или методе контроллера:

use Psr\Http\Message\ServerRequestInterface;

Route::get('/', function (ServerRequestInterface $request) {
  //
});

Если вы возвращаете экземпляр отклика PSR-7 из маршрута или контроллера, он будет автоматически конвертирован обратно в экземпляр отклика Laravel и будет отображён фреймворком.

Получение ввода

Получение всех данных ввода

Вы можете получить все данные ввода в виде массива с помощью метода PHPall():

$input = $request->all();

Получение значения из ввода

Вы можете получить доступ ко всем введённым данным из экземпляра Illuminate\Http\Request, используя всего несколько простых методов. Вам не нужно думать о том, какой тип HTTP-запроса был использован (GET, POST и т.д.) — метод PHPinput() работает одинаково для любого из них:

$name = $request->input('name');

$name = $request->name;

Вы можете передать значение по умолчанию вторым аргументом метода PHPinput(). Это значение будет возвращено, когда запрашиваемый ввод отсутствует в запросе:

$name = $request->input('name', 'Sally');

При работе с формами, имеющими переменные-массивы, вы можете использовать точечную запись для обращения к массивам:

$name = $request->input('products.0.name');

$names = $request->input('products.*.name');

$name = $request->name;

$name = $request->input('user.name');

Определение наличия значения переменной

Для определения наличия значения в запросе используйте метод PHPhas(). Метод PHPhas() возвращает true, если значение существует и является непустой строкой:

if ($request->has('name')) {
  //
}

Получение части переменных запроса

Если вам необходимо получить только часть данных ввода, используйте методы PHPonly() и PHPexcept(). Оба этих метода принимают один массив или динамический список аргументов:

$input = $request->only(['username', 'password']);

$input = $request->only('username', 'password');

$input = $request->except(['credit_card']);

$input = $request->except('credit_card');

$name = Request::input('name');

$name = Request::input('name', 'Sally');

if (Request::has('name'))
{
  //
}

$input = Request::all();

$input = Request::only('username', 'password');

$input = Request::except('credit_card');

$input = Request::input('products.0.name');

Старый ввод

Вам может пригодиться сохранение пользовательского ввода между двумя запросами. Например, после проверки формы на корректность вы можете заполнить её старыми значениями в случае ошибки. Однако, если вы используете включённые в Laravel возможности проверки ввода, то вряд ли вам понадобиться использовать эти методы вручную, так как встроенные возможности Laravel вызовут их автоматически.

Передача ввода в сессию

Метод PHPflash() класса Illuminate\Http\Request передаст текущий ввод в сессию, и он будет доступен во время следующего пользовательского запроса к приложению:

$request->flash();

Request::flash();

Для передачи некоторых переменных в сессию используйте методы PHPflashOnly() и PHPflashExcept(). Эти методы полезны для хранения важной информации (например, паролей) вне сессии:

//для версии 5.2 и выше:
$request->flashOnly(['username', 'email']);

//для версии 5.1 и ранее:
//$request->flashOnly('username', 'email');

$request->flashExcept('password');

Request::flashOnly('username', 'email');

Request::flashExcept('password');

Передать и перенаправить

Поскольку часто требуется передать ввод в сессии и затем перенаправить на предыдущую страницу, вы можете легко прицепить передачу ввода к перенаправлению с помощью метода PHPwithInput():

return redirect('form')->withInput();

return redirect('form')->withInput(
  $request->except('password')
);

return redirect('form')->withInput();

return redirect('form')->withInput(Request::except('password'));

Получение старого ввода

Для получения переданного ввода из предыдущего запроса используйте метод PHPold() на экземпляре Request. Метод PHPold() получит переданные ранее данные ввода из сессии:

$username = $request->old('username');

$username = Request::old('username');

В Laravel есть глобальная вспомогательная функция PHPold(). Когда вы выводите старый ввод в шаблоне Blade, удобнее использовать эту функцию PHPold. Если для данного поля нет старого ввода, вернётся PHPnull:

//для версии 5.2 и выше:
<input type="text" name="username" value="{{ old('username') }}">

//для версии 5.1 и ранее:
//{{ old('username') }}

Cookies

Получение Cookies из запросов

Все cookie, создаваемые Laravel, шифруются и подписываются специальным кодом — таким образом, если клиент изменит их значение, то они станут недействительными. Для получения значения cookie из запроса используйте метод PHPcookie() на экземпляре Illuminate\Http\Request:

$value = $request->cookie('name');

$value = Request::cookie('name');

return response('Hello World')->cookie(
  'name', 'value', $minutes
);

return response('Hello World')->cookie(
  'name', 'value', $minutes, $path, $domain, $secure, $httpOnly
);

$cookie = cookie('name', 'value', $minutes);

return response('Hello World')->cookie($cookie);

$response = new Illuminate\Http\Response('Hello World');

//для версии 5.2 и выше:
$response->withCookie('name', 'value', $minutes);

//для версии 5.1 и ранее:
//$response->withCookie(cookie('name', 'value', $minutes));

return $response;

$response->withCookie(cookie()->forever('name', 'value'));

<?php namespace App\Http\Controllers;

use Cookie;
use Illuminate\Routing\Controller;

class UserController extends Controller
{
  /**
   * Обновить ресурс
   *
   * @return Response
   */
  public function update()
  {
    Cookie::queue('name', 'value');

    return response('Hello World');
  }
}

Файлы

Получение загруженных файлов

Получить доступ к загруженным файлам из экземпляра Illuminate\Http\Request можно с помощью метода PHPfile() или динамических свойств. Метод PHPfile() возвращает экземпляр класса Symfony\Component\HttpFoundation\File\UploadedFile, который наследует PHP-класс SplFileInfo и предоставляет различные методы для взаимодействия с файлами:

$file = $request->file('photo');

$file = $request->photo;

$file = Request::file('photo');

Определение наличия файла

Также вы можете определить, есть ли в запросе файл, с помощью метода PHPhasFile():

if ($request->hasFile('photo')) {
  //
}

if (Request::hasFile('photo'))
{
  //
}

Прошёл ли загруженный файл проверку?

Вдобавок к проверке наличия файла вы можете проверить, что при загрузке файла не возникло никаких проблем, с помощью метода PHPisValid():

if ($request->file('photo')->isValid()) {
  //
}

if (Request::file('photo')->isValid())
{
  //
}

$path = $request->photo->path();

$extension = $request->photo->extension();

$request->file('photo')->move($destinationPath);

$request->file('photo')->move($destinationPath, $fileName);

Request::file('photo')->move($destinationPath);

Request::file('photo')->move($destinationPath, $fileName);

Другие методы для работы с файлами

Есть множество других методов для экземпляров UploadedFile. Загляните в документацию по API класса за более подробной информацией об этих методах.

$path = $request->photo->store('images');

$path = $request->photo->store('images', 's3');

$path = $request->photo->storeAs('images', 'filename.jpg');

$path = $request->photo->storeAs('images', 'filename.jpg', 's3');