Список (CRUD) / PHP: Laravel

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

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

<?php

// Название сущности в URL во множественном числе, контроллер в единственном
Route::get('/articles', '[email protected]')
  ->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>
    <div>
        <table>
            <thead>
                <tr>
                    <td>ID</td>
                    <td>Name</td>
                </tr>
            </thead>
            <tbody>
                @foreach($articles as $article)
                    <tr>
                        <td>{{$article->id}}</td>
                        <td>{{$article->name}}</td>
                    </tr>
                @endforeach
            </tbody>
        </table>

        {{$articles->links()}}
    <div>
@endsection

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

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

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

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

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

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

Pagination