Список (CRUD)

Любой CRUD начинается со списка сущностей, представленных, как правило, в табличном виде. Для его реализации нам понадобится добавить маршрут, создать контроллер, реализовать обработчик и вывести данные в шаблоне. Ещё обязательно нужны тесты и мы их обязательно добавим, но позже, когда разберёмся с фреймворком.

Начнём с маршрута:

<?php

// Название сущности в URL во множественном числе, контроллер в единственном
Route::get('/articles', 'ArticleController@index')
  ->name('articles.index'); // имя маршрута, нужно для того, чтобы не создавать ссылки руками

Следующий шаг, сгенерировать контроллер. Контроллер создаётся пустым. Методы и шаблоны для них нужно добавлять самостоятельно.

$ php artisan make:controller ArticleController

Теперь добавим содержимое:

<?php

namespace App\Http\Controllers;

use App\Article;

class ArticleController extends Controller
{
    public function index()
    {
        $articles = Article::paginate();

        // Статьи передаются в шаблон
        // compact('articles') => [ 'articles' => $articles ]
        return view('article.index', compact('articles'));
    }
}

Первой строкой из базы извлекаются статьи с учётом запрошенной страницы. Laravel автоматически определяет наличие параметра page в запросе и выполняет правильное смещение в SQL. Количество элементов, которые выводятся на странице равно пятнадцати. Это число можно изменить, передав нужное значение в метод paginate($perPage).

Следующей строкой, вызывается шаблон, в который передаётся коллекция статей. Функция view($path, $params) вторым параметром принимает ассоциативный массив, который затем попадает в шаблон.

Осталось добавить шаблон resources/views/article/index.blade.php:

@extends('layouts.app')

@section('content')
    <h1>Список статей</h1>
    @foreach ($articles as $article)
        <h2>{{$article->name}}</h2>
        {{-- Str::limit – функция-хелпер, которая обрезает текст до указанной длины --}}
        {{-- Используется для очень длинных текстов, которые нужно сократить --}}
        <div>{{Str::limit($article->body, 200)}}</div>
    @endforeach
@endsection

Массив параметров, которые были переданы в шаблон из контроллера, превращается в набор переменных. Именами становятся ключи, а содержимым значения этих ключей в массиве. В нашем примере это $articles. Обращаться к этим переменным можно двумя способами: либо в директивах напрямую, либо через интерполяцию {{}}. Последний вариант автоматически подставит вместо переменной её значение.

Обход коллекции выполняется с помощью директивы @foreach, которая выглядит идентично foreach самого PHP.

Последний элемент в шаблоне – вывод постраничной навигации. Эту часть тоже берёт на себя Laravel. Для вывода достаточно вызвать метод links() у коллекции, которую вернул метод paginate.

Самостоятельная работа

1. Выполните все шаги из теории.
2. Убедитесь что при запросе страницы /articles у вас выводятся статьи, которые вы создали в Tinker ранее.
3. Добавьте в общий макет меню, в котором есть ссылка на articles. Воспользуйтесь хелпером route для генерации ссылки.

---

Дополнительные материалы

1. Pagination