Перейти к содержимому
Leonidov.DEV

Старт PHP-проекта: 5 решений до первой строки

Инженерия
Старт PHP-проекта: 5 решений до первой строки

Фреймворк отвечает, как код работает. Он не отвечает, где в этом проекте лежит контроллер, кто пишет миграцию для пользователей и в каком файле настройки очереди. Эти ответы даёт скелет, и первое решение принимается до того, как появится первая строка.

Код: Atomic-Framework-Application, лицензия GPL-3.0-or-later.

Решение 1: скелет это отдельный репозиторий

Скелет живёт отдельно от фреймворка, и это не формальность. Фреймворк обновляется по своим правилам, проект по своим, и между ними остаётся граница, которую видно в composer.

Плюс в том, что новый проект начинается командой, а не переписыванием прошлого. Минус в том, что скелет тоже надо обновлять, и об этом стоит помнить на второй год.

Скелет и фреймворк версионируются отдельно, поэтому проект фиксирует версию фреймворка в composer и обновляет её тогда, когда команда готова пройти по изменениям. Скелет при этом остаётся тем же набором папок и примеров: его задача не меняться каждый месяц, а держать форму, к которой привыкли.

Решение 2: папки это контракт

app/ держит контроллеры, модели, middleware и провайдер пользователей, bootstrap/ константы, загрузчик конфига и обработку ошибок, config/ базу, кеш, почту, аутентификацию и очередь, routes/ маршруты по типу запроса, public/ точку входа, database/ миграции и сиды, resources/ шаблоны, storage/ логи, кеш и сессии.

Договорённость про папки экономит не время разработки, а время ревью. Когда все кладут файл в одно место, спор о структуре не начинается на каждом пулл-реквесте.

Решение 3: аутентификация приходит рабочим срезом

Три контроллера, middleware Authenticate, модель User с uuid, email, password и role, провайдер из базы, миграция таблицы пользователей.

Срез выбран потому, что он проверяет весь вертикальный путь: маршрут, middleware, сессию, модель, миграцию, шаблон. Заглушка проверяет только то, что код собирается, и это дешёвая проверка с дорогими последствиями.

Решение 4: требования записаны в README

PHP 8.1 с расширениями json, session, mbstring, fileinfo, pdo, pdo_mysql, curl, MySQL или MariaDB, Redis по желанию, Composer.

Список кажется мелочью до первого деплоя на чужой сервер. Отсутствующее расширение это не ошибка в коде, а час переписки с поддержкой, и лучше, чтобы список был в репозитории, а не в голове одного человека.

Решение 5: генератора CRUD в скелете нет

Скелет не создаёт админку, экраны списков и формы. Миграции остаются файлами с метками времени, и изменение схемы пишется руками.

Я выбираю это сознательно. Сгенерированный экран живёт до первого нестандартного требования, а потом его переписывают целиком, и никто не помнит, что там было. Файл, написанный человеком, читается в тот же день.

Что это даёт на практике

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

Проверить стоит три вещи: .env не попал в репозиторий, storage/ доступен на запись и закрыт снаружи, миграции прогнаны на сервере. Дальше воркер под supervisor и schedule/run в cron, иначе очередь копит письма, а ночной отчёт не выходит.

Чему это учит

Стандарт важнее удобства. Папки, имена и требования, записанные до кода, экономят месяцы объяснений, и единственная цена этого решения в том, что кто-то должен его принять и записать.

Тот же довод в заметке создание фреймворка: сначала граница, потом код. И тот же принцип в прогрессивном улучшении, где работает то, что уже умеет платформа.

Правило простое: то, что повторяется в каждом проекте, должно лежать в репозитории до начала работы.

Скелет выходит под GPL-3.0-or-later и ставится одной командой Composer.