УРОК · Laravel: приложение и данные

От PHP-скрипта к маршруту

Опубликовано Автор: Соловьёва Мария Андреевна

Каталог notes-php остаётся рабочим. Создадим рядом отдельное приложение Laravel и проверим первый маршрут без переноса данных.

Разберём по шагам

В старом проекте public/index.php сам выбирал ветку GET или POST. В Laravel маршрут связывает метод и адрес с обработчиком. Для первого наблюдаемого результата достаточно GET /notes, который вернёт HTML-заголовок; таблицу и форму добавим позже. Работаем в Ubuntu 24.04, в том числе через WSL на Windows: PHP 8.3.6, Composer 2.8.12, каркас laravel/laravel 13.10.1 и laravel/framework 13.33.0. Новое приложение хранит свою SQLite-базу в notes-laravel/database/database.sqlite и не подключается к базе WordPress или прежнему notes.sqlite.

Слова, которые пригодятся

Маршрут
Пара HTTP-метода и пути, которой Laravel назначает обработчик. Здесь только GET /notes ведёт к ответу со списком.
Composer
Инструмент PHP для установки пакетов. composer.lock записывает конкретные версии установленных зависимостей.
Каркас приложения
Начальные папки и настройки Laravel, в которых мы будем добавлять свои маршруты, модель и шаблон.
Blade
Шаблон Laravel для HTML; в следующем уроке он заменит временную строку ответа.

--no-install --no-scripts оставляет установку зависимостей отдельным шагом: post-create скрипт каркаса не запускается раньше появления vendor. После закрепления laravel/framework:13.33.0 команда install создаёт composer.lock и устанавливает совместимые пакеты. PHP 8.3 соответствует требованиям Laravel 13.

Служебные таблицы каркаса не означают включённую авторизацию. Здесь нет входа, владельца записи или переноса строк из notes-php; это новый локальный каталог с той же задачей «показать и добавить заметку». Порт 8001 выбран, чтобы не конфликтовать со старым сервером на 8000.

Рабочий пример

<?php
// notes-laravel/routes/web.php — весь файл
use Illuminate\Support\Facades\Route;

Route::get('/notes', fn () => '<h1>Заметки</h1><p>Пока пусто</p>');

Практика

Запустите новый каркас рядом со старым каталогом и увидите первый ответ Laravel. Это даст точную точку входа для модели и шаблона следующего урока.

  1. Остановите прежний сервер notes-php через Ctrl+C, но сохраните его файлы. В терминале Ubuntu 24.04 из корня notes-php выполните php -v; нужна ветка 8.3. Если расширений ещё нет, выполните sudo apt update и sudo apt install php8.3-cli php8.3-sqlite3 php8.3-mbstring php8.3-curl php8.3-xml php8.3-zip curl unzip. Команда php -m должна показывать pdo_sqlite, mbstring, curl, dom и zip. Затем выполните cd ..: новая папка появится рядом с notes-php.
  2. В этом родительском каталоге выполните curl -fsSL https://getcomposer.org/download/2.8.12/composer.phar -o composer.phar, затем sha256sum composer.phar. Ожидайте f446ea719708bb85fcbf4ef18def5d0515f1f9b4d703f6d820c9c1656e10a2f2; при другом хеше не запускайте файл. php composer.phar --version должен вывести Composer 2.8.12. Файл composer.phar останется рядом с проектами, вне их Git-репозиториев.
  3. Выполните php composer.phar create-project laravel/laravel notes-laravel 13.10.1 --no-install --no-scripts --no-interaction, затем cd notes-laravel, php ../composer.phar require laravel/framework:13.33.0 --no-update --no-scripts --no-interaction и php ../composer.phar install --no-scripts --no-interaction --prefer-dist. Проверьте php artisan --version: ожидайте Laravel Framework 13.33.0. Сохраните созданный composer.lock: он фиксирует выбранные версии зависимостей для следующих установок.
  4. Из корня notes-laravel выполните cp .env.example .env, php artisan key:generate, touch database/database.sqlite и php artisan migrate. В .env оставьте DB_CONNECTION=sqlite; файл .env и база не должны попадать в Git. Первые миграции создадут служебные таблицы каркаса, но не таблицу заметок. В Visual Studio Code откройте папку notes-laravel, полностью замените routes/web.php примером и сохраните Ctrl+S. php artisan route:list --path=notes должен показать только GET|HEAD /notes.
  5. Запустите php artisan serve --host=127.0.0.1 --port=8001. Во втором терминале Ubuntu выполните curl -i http://127.0.0.1:8001/notes, curl -i -X POST http://127.0.0.1:8001/notes и curl -i http://127.0.0.1:8001/missing: ожидайте соответственно 200 с «Заметки», 405 и 404. Остановите сервер Ctrl+C.

Как проверить себя

Есть отдельный notes-laravel с закреплённой версией фреймворка и SQLite-файлом; GET /notes возвращает 200, а неизвестный метод и адрес — 405 и 404.

Если не получилось
  • php artisan не запускается из-за отсутствующего vendor/autoload.php? Проверьте, что composer install завершился без ошибки именно в notes-laravel.
  • could not find driver при миграции? Проверьте pdo_sqlite командой php -m в том же терминале. SQLSTATE о недоступном файле означает, что не создан database/database.sqlite или нет прав на запись.
  • Нет GET /notes в route:list? Проверьте сохранение routes/web.php и что команда запущена из нового приложения. Если порт 8001 занят, выберите другой и замените его во всех адресах этого урока.

Куда заглянуть дальше