Любите загадки? Событие еще доступно на сайте.

Контроллеры

Вы просматриваете документ для прошлой версии.
Рассмотрите возможность обновления вашего проекта до актуальной версии 10.x. Почему это важно?

Простейшие контроллеры

Вместо того, чтобы писать код в роутах, вы можете организовать его, используя класс Controller. Контроллеры могут группировать связанную логику в отдельные классы, а кроме того использовать дополнительные возможности Laravel, такие как автоматическое внедрение зависимостей.

Контроллеры обычно хранятся в папке app/controllers, а этот путь по умолчанию зарегистрирован в настройке classmap вашего файла composer.json. Но вообще-то контроллеры могут находиться в любой папке или подпапке проекта – лишь бы была настроена их загрузка в Composer.

Вот пример простейшего класса контроллера:

class UserController extends BaseController {

	/**
	 * Отобразить профиль соответствующего пользователя.
	 */
	public function showProfile($id)
	{
		$user = User::find($id);

		return View::make('user.profile', array('user' => $user));
	}

}

Все контроллеры должны наследовать класс BaseController. Этот класс также может хранится в папке app/controllers и в него можно поместить общую логику для других контроллеров. The BaseController расширяет стандартный класс Laravel, Controller class. Теперь, определив контроллер, мы можем зарегистрировать роут для его действия (action):

Route::get('user/{id}', 'UserController@showProfile');

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

Route::get('foo', 'Namespace\FooController@method');

Примечание: Так как Laravel использует Composer для автоматической загрузки php-классов, контроллеры могут располагаться в любом месте фоеймворка, лишь бы Composer знал, как их загрузить. Не обязательно держать контролеры в папке app/controllers. Роутинг к контроллерам полностью отвязан от особенностей расположения файлов фреймворка.

Вы также можете присвоить имя этому роуту:

Route::get('foo', array('uses' => 'FooController@method',
										'as' => 'name'));

Вы можете получить URL к экшну (действию, методу контроллера) методом URL::action:

$url = URL::action('FooController@method');

Получить имя экшна, которое выполняется в данном запросе, можно методом currentRouteAction:

$action = Route::currentRouteAction();

Фильтры контроллеров

Фильтры могут указываться для роутов в контроллеры аналогично тому, как они указываются для обычных роутов:

Route::get('profile', array('before' => 'auth',
			'uses' => 'UserController@showProfile'));

Однако вы можете указывать их и внутри самого контроллера:

class UserController extends BaseController {

	/**
	 * Создать экземпляр класса UserController.
	 */
	public function __construct()
	{
		$this->beforeFilter('auth');

		$this->beforeFilter('csrf', array('on' => 'post'));

		$this->afterFilter('log', array('only' =>
							array('fooAction', 'barAction')));
	}

}

Можно устанавливать фильтры в виде функции-замыкания:

class UserController extends BaseController {

	/**
	 * Создать экземпляр класса UserController.
	 */
	public function __construct()
	{
		$this->beforeFilter(function()
		{
			//
		});
	}

}

Можно выносить фильтр в метод контроллера:

class UserController extends BaseController {

    /**
     * Instantiate a new UserController instance.
     */
    public function __construct()
    {
        $this->beforeFilter('@filterRequests');
    }

    /**
     * Filter the incoming requests.
     */
    protected function filterRequests($route, $request)
    {
        //
    }

}

Неявные контроллеры

Laravel позволяет вам легко создавать единый маршрут для обработки всех действий контроллера. Для начала зарегистрируйте маршрут методом Route::controller:

Route::controller('users', 'UserController');

Метод controller принимает два аргумента. Первый – корневой URI (путь), который обрабатывает данный контроллер, а второй – имя класса самого контроллера.После регистрации просто добавьте методы в этот класс с префиксом в виде типа HTTP-запроса (HTTP verb), который они обрабатывают.

class UserController extends BaseController {

	public function getIndex()
	{
		//
	}

	public function postProfile()
	{
		//
	}

	public function anyLogin()
	{
		//
	}

}

Метод index обрабатывает корневой URI контроллера.

Если имя экшна вашего контроллера состоит из нескольких слов вы можете обратиться к нему по URI, используя синтаксис с дефисами (-). Например, следующий экшн в нашем классе UserController будет доступен по адресу users/admin-profile:

public function getAdminProfile() {}

Имена роутов

Имена роутов для RESTful-контроллеров можно задавать следующим образом:

Route::controller('manager', 'ManagerController', array(
    'getIndex' => 'manager.index',
    'getLogout' => 'manager.logout'
));

Контроллеры ресурсов

Контроллеры ресурсов упрощают построение RESTful-контроллеров, работающих с ресурсами. Например, вы можете создать контроллер, обрабатывающий фотографии, хранимые вашим приложением. Вы можете быстро создать такой контроллер с помощью команды controller:make интерфейса (Artisan) и метода Route::resource.

Для создания контроллера выполните следующую консольную команду:

php artisan controller:make PhotoController

Теперь мы можем зарегистрировать его как контроллер ресурса:

Route::resource('photo', 'PhotoController');

Этот единственный вызов создаёт множество маршрутов для обработки различный RESTful-действий на ресурсе photo. Сам сгенерированный контроллер уже имеет методы-заглушки для каждого из этих маршрутов с комментариями, которые напоминают вам о том, какие типы запросов они обрабатывают.

Запросы, обрабатываемые контроллером ресурсов:

Тип Путь Действие Имя маршрута
GET /resource index resource.index
GET /resource/create create resource.create
POST /resource store resource.store
GET /resource/{id} show resource.show
GET /resource/{id}/edit edit resource.edit
PUT/PATCH /resource/{id} update resource.update
DELETE /resource/{id} destroy resource.destroy

Иногда вам может быть нужно обрабатывать только часть всех возможных действий:

php artisan controller:make PhotoController --only=index,show

php artisan controller:make PhotoController --except=index

Вы можете указать этот набор и при регистрации маршрута:

Route::resource('photo', 'PhotoController',
				array('only' => array('index', 'show')));
				
// либо:

Route::resource('photo', 'PhotoController',
              array('except' => array('create', 'store', 'update', 'destroy')));

По умолчанию имена у роутов совпадают с названиями экшнов контроллеров ресурсов. Однако, вы можете изменить это:

Route::resource('photo', 'PhotoController',
                array('names' => array('create' => 'photo.build')));

###№ Вложенные контроллеры ресурсов

Для того, чтобы обрабатывать ресурсы, задаваемые несколькими параметрами, используйте dot-нотацию (нотацию с точкой) в названии ресурса:

Route::resource('photos.comments', 'PhotoCommentController');

Этот роут создаст контроллер, обрабатывающий урлы типа photos/{photoResource}/comments/{commentResource}.

class PhotoCommentController extends BaseController {

	public function show($photoId, $commentId)
	{
		//
	}

}                

Добавление роутов в контроллер ресурсов

Иногда требуется, чтобы контроллер ресурсов обрабатывал не только стандартные RESTful методы, но и некоторые дополнительные. Для этого просто зарегистрируйте эти роуты перед Route::resource:

Route::get('photos/popular');
Route::resource('photos', 'PhotoController');

Обработка неопределённых методов

Если вы используете Route::controller, можно определить “catch-all” метод, который будет вызываться для обработки запроса, когда в контроллере нет соответствующего метода. Он должен называться missingMethod и принимать массив параметров запроса в виде единственного своего аргумента.

Определение Catch-All метода

public function missingMethod($parameters = array())
{
	//
}

Если вы используете коннтроллер ресурсов, то определите “магический”" метод __call , который вызывается, если не найден вызываемый метод.