Теория: Список (CRUD)

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

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

<?php
use App\Http\Controllers\ArticleController;

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

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

php artisan make:controller ArticleController

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

<?php

namespace App\Http\Controllers;

use App\Models\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.