php artisan about: как проверить проект Laravel на сервере
Команда php artisan about показывает сводку о проекте Laravel: версии Laravel и PHP, окружение, режим отладки, собран ли кеш, где хранятся кеш, сессии и очереди. Это быстрый способ проверить сайт после установки или выкладки. Ниже — что значит каждая строка, какие значения должны быть на рабочем сайте и как проверить сайт снаружи через адрес /up.
Содержание 14
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Выполните:
php artisan about. - Сверьте строки с таблицей для рабочего сайта.
- Проверьте сайт снаружи:
curl -I https://example.com/up— в первой строке ответа должен быть код200.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com. Команда about только читает настройки и ничего не записывает, поэтому её можно запускать от своего пользователя.
Как запустить
cd /var/www/example.com
php artisan aboutОтвет разбит на разделы: Environment, Cache, Drivers и Storage. В каждой строке слева — название, справа через точки — значение, например Debug Mode ........ OFF.
Если команда ответила Could not open input file: artisan, вы не в папке проекта — разбор.
Раздел Environment
| Строка | Что показывает | Откуда берётся |
|---|---|---|
Application Name | имя приложения | APP_NAME в .env |
Laravel Version | версия Laravel | папка vendor |
PHP Version | версия PHP, которая выполнила команду | команда php в терминале |
Composer Version | версия Composer; - — Composer не найден | команда composer |
Environment | окружение | APP_ENV в .env |
Debug Mode | режим отладки: ENABLED — включён, OFF — выключен | APP_DEBUG в .env |
URL | адрес сайта без https:// | APP_URL в .env |
Maintenance Mode | сайт закрыт на обслуживание: ENABLED или OFF | файл storage/framework/down |
Timezone | часовой пояс приложения | config/app.php |
Locale | язык приложения | APP_LOCALE в .env |
PHP Version — версия PHP в терминале. Сайт работает через PHP-FPM, и его версия может быть другой, если на сервере стоят две версии PHP. Какую версию берёт nginx, видно в строке fastcgi_pass — fastcgi_pass в nginx.
Раздел Cache
| Строка | Что значит CACHED |
|---|---|
Config | настройки собраны в один файл |
Events | список событий собран |
Routes | маршруты собраны |
Views | шаблоны собраны |
На рабочем сайте во всех четырёх строках должно стоять CACHED. Если где-то NOT CACHED, соберите кеш: sudo -u www-data php artisan optimize — php artisan optimize.
Раздел Drivers
Здесь видно, где Laravel хранит данные и куда пишет журнал.
| Строка | Что показывает | Строка в .env |
|---|---|---|
Cache | где хранится кеш | CACHE_STORE |
Database | какая база данных | DB_CONNECTION |
Logs | канал журнала, например stack / single | LOG_CHANNEL и LOG_STACK |
Mail | как отправляется почта | MAIL_MAILER |
Queue | где лежат очереди | QUEUE_CONNECTION |
Session | где хранятся сессии | SESSION_DRIVER |
После переноса кеша, сессий и очередей в Redis здесь должно стоять redis — Laravel и Redis. Про stack / single и daily — Журналы Laravel.
Раздел Storage
В строке — путь к public/storage и состояние ссылки:
| Значение | Что значит |
|---|---|
LINKED | ссылка на папку с загруженными файлами есть |
NOT LINKED | ссылки нет: картинки, загруженные через сайт, не откроются |
Если NOT LINKED — как создать ссылку.
Что должно быть на рабочем сайте
| Строка | Значение | Если не так |
|---|---|---|
Environment | production | поправьте APP_ENV — .env на сервере |
Debug Mode | OFF | поставьте APP_DEBUG=false: с ENABLED посетители видят подробности ошибок |
URL | ваш домен | поправьте APP_URL |
Maintenance Mode | OFF | откройте сайт: sudo -u www-data php artisan up — Режим обслуживания |
Config, Events, Routes, Views | CACHED | sudo -u www-data php artisan optimize |
| строка в Storage | LINKED | создайте ссылку |
После правки .env соберите кеш настроек: sudo -u www-data php artisan config:cache — и запустите about ещё раз.
Только один раздел
php artisan about --only=environment| Ключ | Что покажет |
|---|---|
--only=environment | раздел Environment |
--only=cache | раздел Cache |
--only=drivers | раздел Drivers |
--only=storage | раздел Storage |
Несколько разделов перечисляются через запятую: php artisan about --only=environment,cache.
Ответ в JSON
php artisan about --jsonLaravel выведет те же сведения одной строкой в формате JSON. В нём вместо ENABLED и OFF стоят true и false, а названия строк записаны маленькими буквами через подчёркивание: debug_mode, maintenance_mode. Чтобы прочитать ответ глазами, разбейте его на строки:
php artisan about --json | python3 -m json.toolJSON удобен в скриптах: например, проверить после выкладки, что режим отладки выключен.
Версия Laravel одной строкой
php artisan --versionОтвет: Laravel Framework 13.42.0 — с номером вашей версии.
Проверка снаружи: адрес /up
Команда about проверяет проект изнутри. Чтобы проверить, что сайт отвечает посетителям, откройте адрес /up:
curl -I https://example.com/up| Ответ | Что значит |
|---|---|
код 200, на странице Application up | nginx, PHP-FPM и Laravel работают |
код 500, на странице Application experiencing problems | Laravel запустился, но дополнительная проверка в проекте не прошла — причина в журнале |
код 404 | адреса /up в проекте нет |
код 502 | PHP-FPM не отвечает — Разбор |
код 503 | ответ дал nginx или PHP-FPM, а не Laravel — Разбор |
Адрес /up задан в файле bootstrap/app.php строкой health: '/up' — она есть в каждом новом проекте. Если проект обновили со старой версии Laravel, строки может не быть, и адрес ответит 404.
В новом проекте /up не проверяет базу данных: код 200 значит, что Laravel запустился без ошибок. Адрес удобно указать в сервисе, который следит за доступностью сайта.
Пока сайт закрыт командой php artisan down, адрес /up по-прежнему отвечает 200: Laravel пропускает его и в режиме обслуживания. Закрыт ли сайт, проверяйте по главной странице — curl -I https://example.com/ ответит 503 — или по строке Maintenance Mode.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Could not open input file: artisan | команда запущена не в папке проекта | Разбор |
Debug Mode — ENABLED | APP_DEBUG=true | APP_DEBUG=false и sudo -u www-data php artisan config:cache |
Environment — local | APP_ENV=local | APP_ENV=production и sudo -u www-data php artisan config:cache |
| в .env поправили, а about показывает старое | в кеше настроек старые значения | sudo -u www-data php artisan config:cache |
Composer Version — - | Composer не найден | Установка Composer |
Config — NOT CACHED | кеш не собран | sudo -u www-data php artisan optimize |
строка в Storage — NOT LINKED | нет ссылки public/storage | Разбор |
Maintenance Mode — ENABLED | сайт закрыт на обслуживание | sudo -u www-data php artisan up |
| /up отвечает 500 | проверка в проекте не прошла | tail -n 50 storage/logs/laravel.log — Журналы Laravel |
| /up отвечает 404 | в bootstrap/app.php нет health: '/up' | проверяйте главную страницу или добавьте строку в код проекта |
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Configuration — на английском: команда about и ключ --only.
- Документация Laravel: Deployment — на английском: адрес /up, коды 200 и 500.
- Исходный код команды about в Laravel 13.42.0 — на английском: разделы, строки, ENABLED, CACHED, LINKED и ключ --json.
- Исходный код HealthCheck в Laravel 13.42.0 — на английском: ответ адреса /up.
- Исходный код ApplicationBuilder в Laravel 13.42.0 — на английском: адрес /up работает и в режиме обслуживания.
- Шаблон bootstrap/app.php — на английском: строка health: '/up'.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- .env на серверекакие строки поменять на рабочем сайте.
- php artisan optimizeкак собрать кеш настроек, маршрутов и шаблонов.