| 1 | # Кластер Laravel (миру `software.laravel` / `software.web-backend`) — навигация v1 |
| 2 | |
| 3 | **Назначение:** карта **полного контура** Laravel: версии, экосистема, безопасность, фундамент Symfony, долгоживущие воркеры и фронтенд-стеки. Контракт memory-architecture: **status → playbook-php (при сомнениях по PHP) → playbook-laravel → один целевой kb**. Этот файл — **маршрутизатор**, не заменяет playbook. |
| 4 | |
| 5 | **Статус домена:** `status-php-laravel-v1.md`. |
| 6 | |
| 7 | --- |
| 8 | |
| 9 | ## Порядок чтения (full Laravel pass) |
| 10 | |
| 11 | Выполнять **по запросу** или при онбординге на незнакомый проект; не грузить все kb одновременно. |
| 12 | |
| 13 | 1. `kb-laravel-fundamentals-v1.md` — HTTP-цикл, Eloquent, очереди, конфиг/кеш, тесты (база фреймворка). |
| 14 | 2. `kb-laravel-versions-upgrades-v1.md` — мажоры 8→12+, требования PHP, политика апгрейда, что сверять в docs. |
| 15 | 3. `kb-laravel-first-party-packages-v1.md` — Horizon, Telescope, Scout, Cashier, Socialite, Sail, Dusk, Valet, Pint, Reverb и др. |
| 16 | 4. `kb-laravel-security-auth-apis-v1.md` — Sanctum, Passport, Breeze/Jetstream/Fortify, политики, CSRF, API-контуры. |
| 17 | 5. `kb-laravel-symfony-underpinnings-v1.md` — какие компоненты Symfony под капотом, когда читать symfony.com. |
| 18 | 6. `kb-laravel-async-realtime-deployment-v1.md` — Octane, FrankenPHP, RoadRunner, Swoole-стек, Horizon/worker, подводные камни state. |
| 19 | 7. `kb-laravel-frontend-stacks-v1.md` — Blade-first, Livewire, Filament, Inertia (+ Vue/React). |
| 20 | |
| 21 | **Нижний слой:** при любых низкоуровневых вопросах PHP — `index-knowledge-php-cluster-v1.md` и соответствующие `kb-php-*`. |
| 22 | |
| 23 | --- |
| 24 | |
| 25 | ## Таблица: вопрос → куда смотреть |
| 26 | |
| 27 | | Тип вопроса | Первичный kb | |
| 28 | |-------------|----------------| |
| 29 | | С какой версии Laravel / PHP совместимость, upgrade 10→11→12 | `kb-laravel-versions-upgrades-v1.md` | |
| 30 | | Что сломалось после мажора, `str_*`/`enum`, структура приложения 11+ | `kb-laravel-versions-upgrades-v1.md` + официальный Upgrade Guide ветки | |
| 31 | | Очереди Horizon, Telescope в проде, Scout, Cashier, Socialite | `kb-laravel-first-party-packages-v1.md` | |
| 32 | | SPA API tokens, OAuth2, мобильный клиент, Sanctum vs Passport | `kb-laravel-security-auth-apis-v1.md` | |
| 33 | | Политики, gates, CSRF, шифрование, массовое присвоение | `kb-laravel-security-auth-apis-v1.md` + fundamentals | |
| 34 | | HttpKernel, Console, Process, Mime, Translation — «откуда это в Laravel» | `kb-laravel-symfony-underpinnings-v1.md` | |
| 35 | | Octane / FrankenPHP / RoadRunner, memory leaks, синглтоны | `kb-laravel-async-realtime-deployment-v1.md` | |
| 36 | | WebSockets, Laravel Reverb, broadcasting | `kb-laravel-async-realtime-deployment-v1.md` | |
| 37 | | Livewire vs Inertia vs Filament, когда что выбирать | `kb-laravel-frontend-stacks-v1.md` | |
| 38 | | Базовый маршрут, middleware, Eloquent N+1 | `kb-laravel-fundamentals-v1.md` | |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## Правила нагрузки контекста |
| 43 | |
| 44 | - **Один kb за раз** плюс `playbook-laravel-v1.md`, если нужны операционные контракты. |
| 45 | - **Версия — из `composer.lock`**, не из памяти; нумерация docs на laravel.com/docs/X.x должна совпадать с мажором приложения. |
| 46 | - **Legacy (Laravel ≤9):** отдельно проверять EOL и security-only ветки; матрица в `kb-laravel-versions-upgrades-v1.md`. |
| 47 | |
| 48 | --- |
| 49 | |
| 50 | ## Registry note |
| 51 | |
| 52 | - **world:** software.laravel |
| 53 | - **layer:** router (индекс кластера) |
| 54 | - **status:** active |
| 55 | - **updated_at:** 2026-03-01 |
| 56 | |
| 57 | |