Роуты (маршрутизация)

Простейшая маршрутизация

Большинство роутов (маршруты, routes) вашего приложения будут определены в файле app/routes.php. В Laravel простейший роут состоит из URI (урла, пути) и функции-замыкания (она же коллбек).

Простейший GET-роут:

Route::get('/', function()
{
	return 'Hello World';
});

Простейший POST-роут:

Route::post('foo/bar', function()
{
	return 'Hello World';
});

Регистрация роута для нескольких методов

Route::match(array('GET', 'POST'), '/', function()
{
	return 'Hello World';
});	

Регистрация роута для любого типа HTTP-запроса:

Route::any('foo', function()
{
	return 'Hello World';
});

Регистрация роута, всегда работающего через HTTPS:

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) и роут не будет вызван. И все 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::get('user', array('before' => array('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) для лучшего тестирования.

Определение класса для фильтра:

Route::filter('foo', 'FooFilter');

По умолчанию будет вызван метод filter класса FooFilter:

class FooFilter {

	public function filter()
	{
		// Логика фильтра...
	}

}

Вы можете изменить это дефолтное поведение и указать метод явно:

Route::filter('foo', 'FooFilter@foo');

Именованные роуты

Присваивая имена роутам вы можете сделать обращение к ним (при генерации 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.
	});
});

Внутри группы вы можете указать параметр namespace , чтобы не прописывать неймспейсы к каждому контроллеру:

Route::group(array('namespace' => 'Admin'), function()
{
	//
});

Поддоменные роуты

Роуты 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 NotFoundHttpException;
});

Иногда вам может быть нужно использовать собственный метод для получения модели перед её передачей в маршрут. В этом случае просто используйте метод Route::bind:

Route::bind('user', function($value, $route)
{
	return User::where('name', $value)->first();
});

Ошибки 404

Есть два способа вызвать исключение 404 (Not Found) из маршрута. Первый – методом App::abort:

App::abort(404);

Второй – бросив исключение класса или потомка класса Symfony\Component\HttpKernel\Exception\NotFoundHttpException.

Больше информации о том, как обрабатывать исключения 404 и отправлять собственный ответ на такой запрос содержится в разделе об ошибках.

Роуты в контроллер

Laravel позволяет вам регистрировать маршруты не только в виде функции-замыкания, но и классов-контроллеров и даже создавать контроллеры ресурсов.

Больше информации содержится в разделе о контроллерах.