Тема 3. Основы Laravel

План лекции

Версия и границы темы

Что нужно до установки

php -v
composer --version
php -m

Node.js не нужен для минимального PHP-only примера без Vite.

Создание проекта

composer global require laravel/installer
laravel new mini-blog
cd mini-blog

• laravel/installer ставится глобально для текущего пользователя
• laravel new создает каркас и устанавливает зависимости
• В интерактивных вопросах выбираем SQLite
• Sail и Docker не добавляем в этот локальный сценарий
• Все следующие команды выполняются из mini-blog

Два режима запуска

php artisan serve

npm install && npm run build
composer run dev

Окружение и секреты

APP_ENV=local
APP_DEBUG=true
DB_CONNECTION=sqlite

Структура прикладного кода

• Пространства имен повторяют структуру app
• Сгенерированные файлы сначала читают, затем изменяют

Структура выполнения

Роли MVC в примере

Цикл запроса Laravel

browser
   -> public/index.php
   -> bootstrap приложения
   -> middleware и router
   -> PostController
   -> Eloquent -> SQLite
   -> Blade
   -> HTTP response -> browser

• Middleware работает до или после контроллера
• Router сопоставляет HTTP-метод и URI с обработчиком
• Не каждый запрос обращается к базе или Blade
• В нашем GET /posts задействована вся показанная цепочка

Что дает routes/web.php

Маршрут и ограничение параметра

use Illuminate\Support\Facades\Route;

Route::get('/demo/posts/{postId}', function (string $postId) {
    return "Post {$postId}";
})->whereNumber('postId')
  ->name('posts.show-demo');

• get задает допустимый HTTP-метод
• {postId} извлекает сегмент URI
• whereNumber принимает только цифры
• name отделяет имя маршрута от его URI
• Это отдельная демонстрация вне маршрутов мини-блога

Маршруты мини-блога

use App\Http\Controllers\PostController;
use Illuminate\Support\Facades\Route;

Route::get('/posts', [PostController::class, 'index'])
    ->name('posts.index');

Route::post('/posts', [PostController::class, 'store'])
    ->name('posts.store');

php artisan route:list --except-vendor

• Один URI может иметь разные обработчики для GET и POST
• Blade строит адрес через route('posts.store')

Генерация файлов примера

php artisan make:model Post -m
php artisan make:controller PostController

SQLite в новом Laravel 13

Миграция таблицы posts

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('posts', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->text('body');
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('posts');
    }
};

Управление миграциями

php artisan migrate
php artisan migrate:status

php artisan migrate:rollback применяйте осторожно и только локально, когда понимаете состав последнего пакета миграций.

Модель Post

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $fillable = [
        'title',
        'body',
    ];
}

• Eloquent связывает Post с таблицей posts
• $fillable разрешает массовое заполнение только указанных полей
• Это граница mass assignment, но не замена validation
• В create() передаем только массив $validated

Чтение и создание через Eloquent

$posts = Post::query()
    ->latest()
    ->get();

$post = Post::create([
    'title' => 'Первый пост',
    'body' => 'Текст первого поста',
]);

Почему контроллер остается тонким

• SQL, разметка и ручная работа с CSRF в контроллер не попали

Обычный сбой валидации

$validated = $request->validate([
    'title' => ['required', 'string', 'max:255'],
    'body' => ['required', 'string', 'max:10000'],
]);

Post/Redirect/Get после успеха

POST /posts
   -> validate
   -> INSERT
   -> 302 redirect to posts.index
GET /posts
   -> render updated list

• Успешный POST не возвращает страницу списка напрямую
• Redirect меняет следующий запрос на GET
• Обновление страницы повторяет GET, а не вставку
• Flash status живет до следующего запроса
• Ошибка валидации использует другой redirect back

Экранирование в Blade

<h2>{{ $post->title }}</h2>
<p>{{ $post->body }}</p>

Порядок сборки мини-блога

1. Создать проект и проверить .env
2. Сгенерировать Post с миграцией
3. Описать up() и down(), выполнить migrate
4. Задать $fillable в модели
5. Создать контроллер и два named route
6. Добавить layout, форму и список
7. Проверить успешный и ошибочный сценарии

После каждого шага запускайте приложение, не откладывая проверку до конца.

Инструменты диагностики

• APP_DEBUG=true допустим только в локальной среде

Частые коды и причины

• Для обычной HTML-формы validation чаще виден как redirect назад
• Ошибка no such table: posts означает, что нужная миграция не применена
• Mass assignment exception требует проверить $fillable и входной массив

Готовность к лабораторной 1

Установка, структура, маршруты и Blade

• Проект mini-blog запускается через php artisan serve
• Студент объясняет назначение семи основных путей проекта
• GET /posts связан с PostController@index
• POST /posts связан с PostController@store
• Оба маршрута имеют имена и видны в route:list
• Layout и страница списка открываются без Vite
• В форме есть method="POST" и @csrf

Готовность к лабораторной 2

SQLite, Eloquent и обработка формы

• Миграция создает posts и корректно удаляет таблицу в down()
• migrate:status показывает примененную миграцию
• Post содержит $fillable для title и body
• Валидный POST создает запись один раз
• Невалидный POST показывает ошибки и сохраняет старый ввод
• После успеха работает PRG и flash status
• Пользовательский текст выводится через {{ }}
• Причины 404, 419, 422 и 500 проверяются по плану

Что остается для лекции 4

• Полноценная аутентификация и starter kits
• Авторизация через Gates и Policies
• Form Requests вместо inline validation
• REST API и отдельные JSON-контракты
• Файлы и storage
• Cache
• Tests
• Deployment

В лекции 3 строим базовую серверную цепочку. Расширения добавляются после того, как она понятна и работает.

Резюме

Вопросы для самопроверки: устройство

Вопросы для самопроверки: мини-блог

Ресурсы: версия и устройство

Ресурсы: HTTP и представление

Ресурсы: данные