Основы Laravel 5: Введение в маршрутизацию, контроллеры и представления

Статистика: Символов — 8 100/6 779 без пробелов (7 092/5 916 без кода):, слов — 1 177
Разметка: Wiki
{{Laracast Laravel 5 Fundamentals, 3, "A Gentle Introduction to Routing, Controllers, and Views", 7.01.2015, 19.05.2016, https://laracasts.com/series/laravel-5-fundamentals/episodes/3}}

%%(hvlraw)
<iframe width="640" height="360" src="https://www.youtube-nocookie.com/embed/H5jD0vUNlPc?list=PLl_kpL5cwH6LLuvd_xXOplXejM7shFhme" frameborder="0" allowfullscreen></iframe>
%%

(0:00)
Итак, вы долго ждали, и я думаю пришло время увидеть код Laravel. Я загружу сервер, и мы сделаем несколько изменений, чтобы вы поняли основной процесс – как загрузить "представление" и вывести результат в окно браузера.
Если вы хотите использовать локальный сервер, то можете сделать так:
%%(sh)
php -S localhost:8888 -t public
%%
И не забудьте установить корень документов (document root) на директорию %%(t)/public%%. Если вы это сделаете и переключитесь в Chrome – увидите Laravel.

(0:30)
Или, если вы прошли второй урок и научились работе с Homestead, то как в таком случае будет выглядеть результат? Давайте быстренько посмотрим. Я переключусь обратно в окно терминала и с помощью ssh войду в нашу VM:
%%(sh)
homestead ssh
%%
И вы увидите что Laravel Homestead включает в себя команду %%(t)serve%%. Заметьте что мы даём ей имя домена и путь, по которому должен находиться корень документов. Давайте попробуем. Мы пишем: %%(t)serve%%,... как насчёт доменного имени %%(t)laravel5.dev%%?

(1:00)
Наш путь будет внутри директории %%(t)/home/Vagrant/Code%%, имя папки %%(t)/learning-laravel-5%%, а корневой путь в %%(t)/public%%. Итак:
%%(sh)
serve laravel5.dev /home/Vagrant/Code/learning-laravel-5/public
%%
Запустим эту команду. Это настроит nginx. Также, не забудьте, у нас собственный локальный домен, так что нужно поправить наш файл %%(t)hosts%%.
В новой закладке терминала выполним:
%%(sh)
sudo vi /etc/hosts
%%
Внутренне наш IP останется тем же, но домен будет %%(t)laravel5.dev%%. И готово. Посмотрим, сработает ли.

(1:30)
Если я переключусь в Chrome и открою %%(t)laravel5.dev%% – всё работает через Homestead. Так что сами решайте, работать через встроенный сервер PHP или через VM c Homestead. Если вы поопытнее, я бы рекомендовал Homestead (там больше гибкости). Но если вы только пробуете построить свой первый сайт и изучаете первый фреймворк – это нормально, если вы пока остановитесь на простом сервере PHP. Итак, давайте перейдем к исходному коду.

(2:00)
Теперь, не знаю как вы, но я всегда когда вижу новый фреймворк, то структура папок сразу кажется мне ошеломительной. Все эти термины, о которых я ничего не знаю. Что это за Console? Или Commands? Events? Handlers, Providers, и Services? Слишком много всего! Так ведь? Это нормально. Вы освоите их шаг за шагом. Я обещаю вам, что они не настолько сложны, как может сначала показаться. Но для начала, давайте будем придерживаться основ.

(2:30)
Как мы получили эту статичную страницу приветствия ("Welcome page")?
Что же, всегда когда вы впервые открываете приложение на Laravel, вам нужно перейти в файл %%(t)routes%%. И вы найдете его в %%(t)/app/Http%% (считайте что эта папка инкапсулирует всю логику приложения по работе с HTTP). Здесь находятся маршруты. Итак, если посмотрим, там уже есть несколько предустановленных. Но сейчас нам интересен лишь этот:
%%(sh)
Route::get('/', 'WelcomeController@index');
%%

(3:00)
Итак, возможно вы пришли из старого (legacy) PHP-приложения, где структура папок определяет, как выглядит URL. Например, если вы хотели создать страницу по адресу блога, то вы бы создали папку %%(t)/blog%% и в ней %%(t)index.php%%.
Затем при переходе на %%(t)example.com/blog%% вы бы увидели результат. Так? Ну как вы возможно догадались – это достаточно негибкий способ. Вместо этого мы специально объявим каждый маршрут в нашем приложении. И к счастью, Laravel делает это так просто как это только возможно.

(3:30)
Давайте вместе прочитаем что тут написано. У нас есть новый маршрут, и когда пользователь исполняет GET-запрос (GET-запрос – это просто тип запроса, самый лёгкий для понимания)... Просто думайте о GET как "когда я посещаю эту страницу"… Хм, какую страницу? Корневую (%%(t)/%% или %%(t)root%%) страницу - то есть домашнюю страницу вашего сайта. Что нужно сделать дальше? Я хочу загрузить конкретный метод, и это должен быть метод от нашего контроллера.

(4:00)
Итак, мы говорим: "ищи %%WelcomeController%%, и вызови на нём метод с названием %%index()%%". Давайте посмотрим где его искать. Вот директория %%(t)Controllers%%, вот %%(t)WelcomeController.php%%, и если я прокручу текст ниже – вот этот метод %%index()%%. Он отвечает за обработку вызова к домашней странице. Давайте попробуем нечто простое:
%%
return 'hello world!';
%%

(4:30)
Отлично. Идём обратно, обновим, и вуаля! Легко и просто. Сделаем ещё один? Если я перейду в файл %%(t)routes.php…%% вы будете часто видеть как я это делаю (вместо перехода к боковой панели и поиску файла). Так что лучше выберите себе хороший редактор, позволяющий очень быстро набирать имя и переходить к нужному файлу.
Хорошо. Как насчет обязательной страницы контактов? Давайте напишем её вместе. Повторяйте мои действия!

(5:00)
У нас новый маршрут, и когда мы получаем GET-request к странице %%(t)contact%% (которую нужно писать так: %%(t)/contact%%, но слэш можно опустить). Затем куда мы хотим пойти? В какой метод нам стоит направить запрос? Давайте пока будем придерживаться %%(t)WelcomeController%%, хотя в действительности, я бы создал отдельный контроллер, возможно какой-то общий %%PagesController%% для статичных страниц на моём сайте. В любом случае, пока придержимся этого варианта, и вызовем метод %%contact()%%:
%%
Route::get('contact', 'WelcomeController@contact');
%%

(5:30)
Хорошо, мы настроили новый маршрут. Перейдем обратно в %%(t)WelcomeController.php%%. Я добавлю тут новый метод:
%%
public function contact()
{
  return 'Contact me';
}
%%
(Пока что просто жёстко пропишем здесь "Contact me"). Так, посмотрим, работает или нет. Открываем:
%%(t)
laravel5.dev/contact
%%
и вот она. Ваша самая первая страница! Поздравляю!
В самом деле, заметьте, это совсем несложно. Нужно всего лишь понять основной принцип работы. И я обещаю, вы по-настоящему полюбите Laravel, когда выучитесь всем этим штукам.

(6:00)
В данных двух примерах мы всего лишь возвращаем строки. За кулисами Laravel распознает и выберет подходящий ответ. В реальной жизни мы не возвращаем строки. Возможно код вернет что-то типа JSON, если вы строите API, но для типичного веб-приложения, вы скорее всего загрузите HTML-код. Это и есть "вид" (view - представление, шаблон). В Laravel думайте о виде, как о неком подставном шаблоне. Он очень простой – лишь дайте ему данные и он отобразит их для пользователя.

(6:30)
Все ваши виды будут храниться в директории %%(t)/resources/views%%. Заметьте, это будет базовая директория. Нам не нужно писать полностью %%(t)resources/views/welcome%%. Также не нужно беспокоиться и о расширении (типа %%(t)welcome.blade.php%%). В этом нет необходимости. Просто пишите %%(t)welcome%%. А может файл внутри поддиректории, как это довольно часто бывает - ведь у вас будет куча видов и вам стоит правильно их организовать.

(7:00)
Если у вас к примеру форум, то сделайте %%(t)/views/forum/[name-of-the-view]%%. В таких случаях можно обращаться к нему как %%(t)forum/name%%. Или если хотите, можно сделать это более объектно-ориентированным на вид используя точку вместо слэша: %%(t)forum.name%%

(7:30)
Laravel будет искать его в директории %%(t)resources/views/forum%%, и затем в файле %%(t)name.php%% или %%(t)name.blade.php%%. Но, в нашем случае, мы используем просто %%(t)welcome%%:
%%
return view('welcome');
%%
Теперь заменим вот на это:
%%
return view('pages.contact');
%%
(Возможно я хочу папку %%(t)/pages%%, и вид с названием %%(t)contact%%). Хорошо, давайте создадим его. Вот здесь. Новый файл. Внутри %%(t)pages/contact.blade.php%%.
Насчёт Blade – возможно вам незнаком этот термин. Это шаблонизатор Laravel. Вы полюбите его. Но мы разберемся с ним чуть позже.

(8:00)
ОК, для начала я просто вставлю здесь большой блок HTML-кода. Позднее я покажу вам как подчистить здесь всё, используя штуки типа мастер-страниц. Итак, я всего лишь напишу:
%%(h)
<h1>Contact Me!</h1>
%%
Хорошо. Это всё что нам было нужно. Давайте еще раз посмотрим на рабочий процесс, и затем посмотрим на это в браузере. Мы определили наш маршрут так, что при GET-запросе к %%(t)example.com/contact%% мы направляем его к контроллеру, который как бы жонглирует всем миром приложения.

(8:30)
Он получает запрос (типа "Я хочу увидеть страницу %%(t)contact%%") и возвращает ответ: "Вот твоя страница". Так или иначе, в том классе мы ссылаемся на метод %%contact()%%. Теперь, если мы переключимся туда, в наш метод %%contact()%%, то мы только лишь загрузим вид %%(t)pages/contact%%. И конечно же, вид – это просто базовый HTML для примера. Хорошо, посмотрим на это в браузере. Переключусь обратно и обновлю. И вот оно – мы загрузили наш вид.

(9:00)
Отлично! Итак, это было ваше первое введение, очень лёгкое введение в основы маршрутизации. Вы ознакомились с тем как выглядит контроллер, и как мы загружаем вид. Как вы можете представить, в будущих уроках мы разберёмся с этим намного глубже. Надеюсь, вам интересно!