Поиск
Справочник

php artisan about: как проверить проект Laravel на сервере

Команда php artisan about показывает сводку о проекте Laravel: версии Laravel и PHP, окружение, режим отладки, собран ли кеш, где хранятся кеш, сессии и очереди. Это быстрый способ проверить сайт после установки или выкладки. Ниже — что значит каждая строка, какие значения должны быть на рабочем сайте и как проверить сайт снаружи через адрес /up.

≈ 7 мин чтения
Содержание 14

Что сделать прямо сейчас

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Выполните: php artisan about.
  3. Сверьте строки с таблицей для рабочего сайта.
  4. Проверьте сайт снаружи: 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 / singleLOG_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 — как создать ссылку.

Что должно быть на рабочем сайте

СтрокаЗначениеЕсли не так
Environmentproductionпоправьте APP_ENV — .env на сервере
Debug ModeOFFпоставьте APP_DEBUG=false: с ENABLED посетители видят подробности ошибок
URLваш доменпоправьте APP_URL
Maintenance ModeOFFоткройте сайт: sudo -u www-data php artisan up — Режим обслуживания
Config, Events, Routes, ViewsCACHEDsudo -u www-data php artisan optimize
строка в StorageLINKEDсоздайте ссылку

После правки .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 --json

Laravel выведет те же сведения одной строкой в формате JSON. В нём вместо ENABLED и OFF стоят true и false, а названия строк записаны маленькими буквами через подчёркивание: debug_mode, maintenance_mode. Чтобы прочитать ответ глазами, разбейте его на строки:

php artisan about --json | python3 -m json.tool

JSON удобен в скриптах: например, проверить после выкладки, что режим отладки выключен.

Версия Laravel одной строкой

php artisan --version

Ответ: Laravel Framework 13.42.0 — с номером вашей версии.

Проверка снаружи: адрес /up

Команда about проверяет проект изнутри. Чтобы проверить, что сайт отвечает посетителям, откройте адрес /up:

curl -I https://example.com/up
ОтветЧто значит
код 200, на странице Application upnginx, PHP-FPM и Laravel работают
код 500, на странице Application experiencing problemsLaravel запустился, но дополнительная проверка в проекте не прошла — причина в журнале
код 404адреса /up в проекте нет
код 502PHP-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 — ENABLEDAPP_DEBUG=trueAPP_DEBUG=false и sudo -u www-data php artisan config:cache
Environment — localAPP_ENV=localAPP_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.

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше