git f53f291f67507108dd0f5772a7eb33bc6458d840
- Простейшая маршрутизация
- Параметры роутов
- Фильтры роутов
- Именованные роуты
- Группы роутов
- Доменная маршрутизация
- Префикс пути
- Привязка моделей
- Ошибки 404
- Маршрутизация в контроллер
Большинство роутов (маршруты, routes) вашего приложения будут определены в файле app/routes.php. В Laravel простейший роут состоит из URI (урла, пути) и функции-замыкания (она же коллбек).
Route::get('/', function()
{
return 'Hello World';
});
Route::post('foo/bar', function()
{
return 'Hello World';
});
Route::any('foo', function()
{
return 'Hello World';
});
Route::get('foo', array('https', function()
{
return 'Must be over HTTPS';
}));
Вам часто может понадобиться сгенерировать URL к какому-либо роуту - для этого используется метод URL::to:
$url = URL::to('foo');
Здесь 'foo' - это URI.
Route::get('user/{id}', function($id)
{
return 'User '.$id;
});
Route::get('user/{name?}', function($name = null)
{
return $name;
});
Route::get('user/{name?}', function($name = 'John')
{
return $name;
});
Route::get('user/{name}', function($name)
{
//
})
->where('name', '[A-Za-z]+');
Route::get('user/{id}', function($id)
{
//
})
->where('id', '[0-9]+');
Конечно, при необходимости вы можете передать массив ограничений (constraints):
Route::get('user/{id}/{name}', function($id, $name)
{
//
})
->where(array('id' => '[0-9]+', 'name' => '[a-z]+'))
Вы можете определить соответствие параметра пути регулярному выражению глобально для всех роутов. Например, если у вас {id} в урлах это всегда числовое значение:
Route::pattern('id', '[0-9]+');
Route::get('user/{id}', function($id)
{
// Only called if {id} is numeric.
});
Если вам нужно получить значение параметра роута не в нем, а, где-то еще, например, в фильтре или контроллере, то вы можете использовать Route::input():
Route::filter('foo', function()
{
if (Route::input('id') == 1)
{
//
}
});
Фильтры - удобный механизм ограничения доступа к определённому роуту, что полезно при создании областей сайта только для авторизованных пользователей. В Laravel изначально включено несколько фильтров, в том числе auth, auth.basic, guest and csrf. Они определены в файле app/filters.php.
Route::filter('old', function()
{
if (Input::get('age') < 200)
{
return Redirect::to('home');
}
});
Если фильтр возвращает значение, оно используется как ответ фреймворка (response) на сам запрос (request) и обработчик маршрута не будет вызван, и все after-фильтры тоже будут пропущены.
Route::get('user', array('before' => 'old', function()
{
return 'You are over 200 years old!';
}));
Route::get('user', array('before' => 'old', 'uses' => 'UserController@showProfile'));
Route::get('user', array('before' => 'auth|old', function()
{
return 'You are authenticated and over 200 years old!';
}));
Route::filter('age', function($route, $request, $value)
{
//
});
Route::get('user', array('before' => 'age:200', function()
{
return 'Hello World';
}));
Фильтры типа after (выполняющиеся после запроса, если он не был отменён фильтром before - прим. пер.) получают $response как свой третий аргумент:
Route::filter('log', function($route, $request, $response, $value)
{
//
});
Вы можете также указать, что фильтр применяется ко всем роутам, URI (путь) которых соответствует шаблону.
Route::filter('admin', function()
{
//
});
Route::when('admin/*', 'admin');
В примере выше фильтр admin будет применён ко всем маршрутам, адрес которых начинается с admin/. Звёздочка (*) используется как символ подстановки и соответствует любому набору символов, в том числе пустой строке.
Вы также можете привязывать фильтры, зависящие от типа HTTP-запроса:
Route::when('admin/*', 'admin', array('post'));
Для продвинутой фильтрации вы можете использовать классы вместо функций-замыканий. Так как такие фильтры будут создаваться с помощью IoC-контейнера, то вы можете использовать внедрение зависимостей (Dependency Injection) для лучшего тестирования.
class FooFilter {
public function filter()
{
// Логика фильтра...
}
}
Route::filter('foo', 'FooFilter');
Присваивая имена роутам вы можете сделать обращение к ним (при генерации URL во вьюхах (views) или переадресациях) более удобным. Вы можете задать имя роуту таким образом:
Route::get('user/profile', array('as' => 'profile', function()
{
//
}));
Также можно указать контроллер и его действие:
Route::get('user/profile', array('as' => 'profile', 'uses' => 'UserController@showProfile'));
Теперь вы можете использовать имя маршрута при генерации URL или переадресации:
$url = URL::route('profile');
$redirect = Redirect::route('profile');
Получить имя текущего выполняемого маршрута можно методом currentRouteName:
$name = Route::currentRouteName();
Иногда вам может быть нужно применить фильтры к набору маршрутов. Вместо того, чтобы указывать их для каждого маршрута в отдельности вы можете сгруппировать маршруты:
Route::group(array('before' => 'auth'), function()
{
Route::get('/', function()
{
// К этому маршруту будет привязан фильтр auth.
});
Route::get('user/profile', function()
{
// К этому маршруту также будет привязан фильтр auth.
});
});
Роуты Laravel способны работать и с поддоменами по их маске и передавать в ваш обработчик параметры из шаблона.
Route::group(array('domain' => '{account}.myapp.com'), function()
{
Route::get('user/{id}', function($account, $id)
{
//
});
});
Группа роутов может быть зарегистрирована с одним префиксом без его явного указания с помощью ключа prefix в параметрах группы.
Route::group(array('prefix' => 'admin'), function()
{
Route::get('user', function()
{
//
});
});
Привязка моделей - удобный способ передачи экземпляров моделей в ваш роут. Например, вместо передачи ID пользователя вы можете передать модель User, которая соответствует данному ID, целиком. Для начала используйте метод Route::model для указания модели, которая должна быть использована вместо данного параметра.
Route::model('user', 'User');
Затем зарегистрируйте маршрут, который принимает параметр {user}:
Route::get('profile/{user}', function(User $user)
{
//
});
Из-за того, что мы ранее привязали параметр {user} к модели User, то её экземпляр будет передан в маршрут. Таким образом, к примеру, запрос profile/1 передаст объект User , который соответствует ID 1 (полученному из БД - прим. пер.).
Внимание: если переданный ID не соответствует строке в БД, будет брошено исключение (Exception) 404.
Если вы хотите задать свой собственный обработчик для события "не найдено", вы можете передать функцию-замыкание в метод model:
Route::model('user', 'User', function()
{
throw new NotFoundException;
});
Иногда вам может быть нужно использовать собственный метод для получения модели перед её передачей в маршрут. В этом случае просто используйте метод Route::bind:
Route::bind('user', function($value, $route)
{
return User::where('name', $value)->first();
});
Есть два способа вызвать исключение 404 (Not Found) из маршрута. Первый - методом App::abort:
App::abort(404);
Второй - бросив исключение класса или потомка класса Symfony\Component\HttpKernel\Exception\NotFoundHttpException.
Больше информации о том, как обрабатывать исключения 404 и отправлять собственный ответ на такой запрос содержится в разделе об ошибках.
Laravel позволяет вам регистрировать маршруты не только в виде функции-замыкания, но и классов-контроллеров и даже создавать контроллеры ресурсов.
Больше информации содержится в разделе о контроллерах.