Любой CRUD начинается со списка сущностей, представленных, как правило, в табличном виде. Для его реализации нам понадобится добавить маршрут, создать контроллер, реализовать обработчик и вывести данные в шаблоне. Еще обязательно нужны тесты и мы их обязательно добавим, но позже, когда разберемся с фреймворком.
Начнем с маршрута:
<?php
// Название сущности в 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
.
Самостоятельная работа
- Выполните все шаги из теории.
- Убедитесь что при запросе страницы /articles у вас выводятся статьи, которые вы создали в Tinker ранее.
- Добавьте в общий макет меню, в котором есть ссылка на articles. Воспользуйтесь хелпером route для генерации ссылки.
Дополнительные материалы
Остались вопросы? Задайте их в разделе «Обсуждение»
Вам ответят команда поддержки Хекслета или другие студенты
Для полного доступа к курсу нужен базовый план
Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.