Конституция PHP

Публичный дайджест правил PHP-разработки модулей DevCraft для DLE 20.

Публичный дайджест правил PHP-разработки модулей DevCraft (и совместимого legacy MH Admin).

Иерархия при конфликте: Конституция > Roistat PHP Code Conventions > legacy mhadmin.

Scope

Входит	Не входит (явно исключено)
Семантика PHP (Roistat Code Conv)	Правила PR-workflow
Стиль форматирования (Principle VIII)	Обязательные тесты / test env
Стек, слои, DLE/DevCraft интеграция	Standalone CLI (`bin/`)
	Документация без явного запроса

Слой	Технология
Runtime	PHP ≥ 8.3
Шаблоны	Twig
Persistence	Cycle ORM
Admin UI	Metro UI
Хост	DLE 20.0
Workspace	репозиторий/проект модуля на DevCraft
Legacy-референс	проект `mhadmin` и его `graphify-out/` (если есть)

#	Принцип	Кратко
I	Roistat semantics	Читаемость, без мёртвого кода, typed/IDE-refactorable; narrative comments не раздувать (`// hack:`, `@todo` — ок)
II	Слои	Service / Repository / Controller / Entity / DTO — без cross-layer shortcuts
III	PHP 8.3 typing	Типы везде; `validate`/`check` бросают; getters без префикса `get`
IV	Cycle ORM	Нет ad-hoc SQL в контроллерах/сервисах (кроме миграций)
V	Twig	HTML только через Twig; данные готовятся в PHP
VI	Metro UI	Паттерны из примеров Metro UI, без параллельных CSS-фреймворков
VII	DRY	Одна точка истины для повторяющейся логики
VIII	Code style	Tabs, margin 150, вертикальное выравнивание `=`/`=>`, braces on new line
IX	DLE 20	`DLEPlugins::Check()`, prefix, topics 72–75; DevCraft: AJAX только через `devcraft/ajax.php`
X	No CLI	Нет `devcraft/bin` и shell entry points
XI	No unsolicited docs	README/docs только по явному запросу

Комментарии, PHPDoc и UI/ошибки в PHP — на русском. Это не отменяет запрет на «воду» в комментариях (I).

Граф	Роль
`graphify-out/` у legacy `mhadmin`	PRIMARY для старой раскладки модулей
`graphify-out/` у host DLE	Состояние хоста; `graphify update .` после правок `engine/` (не после чистого `devcraft/`)