Шпаргалка Artisan: Довідник необхідних команд

• Довідка та інфо
• Запуск та maintenance
• Кеші та оптимізація
  • Кеш застосунку
  • Config
  • Routes
  • Views
  • Events
• Генерація коду (make:*)
• База даних та міграції
• Черги (Queue)
• Планувальник (Scheduler)
• Тести та дев-інструменти
• Файли та публікації
• Типові “комбо”

Ваш швидкий помічник у роботі з консольним інтерфейсом Laravel 12. Ми зібрали всі актуальні команди Artisan в одному місці: від базової генерації файлів до складного налаштування бази даних та роботи з чергами. Більше не потрібно шукати документацію — просто скопіюйте потрібну команду та пришвидшуйте свою розробку.

Довідка та інфо

Список доступних команд

Показує всі Artisan-команди, доступні у вашому проєкті (включно з пакетами).

php artisan list

Довідка по конкретній команді

Показує опції, аргументи й приклади для конкретної команди.

php artisan help migrate

Інформація про проєкт (версії, середовище, драйвери)

Швидке резюме конфігурації Laravel-застосунку.

php artisan about

Поточне середовище (environment)

Показує активне середовище (наприклад, local, production).

php artisan env

Запуск та maintenance

Запуск локального сервера

Піднімає dev-сервер (корисно для простого локального запуску).

php artisan serve

Запуск сервера з хостом/портом

Корисно для Docker/VM або якщо потрібен інший порт.

php artisan serve --host=0.0.0.0 --port=8000

Увімкнути режим обслуговування (maintenance)

Переводить застосунок у “down” режим (для деплою/міграцій).

php artisan down

Maintenance з “секретним” доступом

Дозволяє зайти у застосунок за спеціальним токеном.

php artisan down --secret="my-secret"

Вимкнути режим обслуговування

Повертає застосунок у звичайний режим.

php artisan up

Кеші та оптимізація

Кеш застосунку

Очистити кеш застосунку

Скидає кеш, який ви записували через Cache API.

php artisan cache:clear

Очистити кеш конкретного store

Корисно, якщо використовуєте кілька кеш-сховищ.

php artisan cache:clear --store=redis

Очищення “всього важливого” одним махом

Найкраща команда “коли щось дивно працює”: чистить основні кеші (config/routes/views тощо).

php artisan optimize:clear

Оптимізація для продакшну

Збирає/кешує те, що можна кешувати для швидкодії (використовуйте при деплої).

php artisan optimize

Config

Закешувати конфіг (prod-friendly)

Збирає всі конфіги в один кеш-файл для швидшого завантаження.

php artisan config:cache

Очистити кеш конфігурації

Потрібно, якщо змінили .env або config/*.php і хочете повернутися до “живих” конфігів.

php artisan config:clear

Показати конфіг (секція)

Швидко подивитися значення конфігів, не відкриваючи файли.

php artisan config:show app

Routes

Список маршрутів

Діагностика маршрутів: method, URI, name, action, middleware.

php artisan route:list

Список маршрутів з фільтром по шляху

Зручно для адмінок / API.

php artisan route:list --path=admin

Закешувати маршрути

Рекомендовано для продакшну (якщо сумісно з вашим роутінгом).

php artisan route:cache

Очистити кеш маршрутів

Повертає маршрути в режим “з файлів”.

php artisan route:clear

Views

Закешувати Blade-шаблони

Компілює й кешує представлення (корисно на проді).

php artisan view:cache

Очистити кеш Blade

Корисно після правок у Blade, якщо бачите “старі” представлення.

php artisan view:clear

Events

Закешувати event/listener мапінг

Збирає події/слухачі в кеш, щоб не сканувати їх на кожному запуску.

php artisan event:cache

Очистити кеш подій

Потрібно, якщо додали/змінили події або слухачі.

php artisan event:clear

Генерація коду (make:*)

Створити модель

Створює Eloquent модель (за потреби додайте міграцію/фабрику/сіди).

php artisan make:model Post -mfs

Створити контролер

Генерує контролер для HTTP-логіки.

php artisan make:controller PostController

Створити Form Request

Клас для валідації та авторизації запиту.

php artisan make:request StorePostRequest

Створити middleware

Перехоплює HTTP-запит для перевірок/модифікацій.

php artisan make:middleware DetectRegion

Створити job

Завдання для черги або синхронного виконання.

php artisan make:job ProcessOrder

Створити console-команду

Власна Artisan-команда для автоматизації.

php artisan make:command SyncRates

Створити policy

Правила доступу до ресурсів (authorization).

php artisan make:policy PostPolicy --model=Post

База даних та міграції

Запустити міграції

Застосовує нові міграції до бази даних.

php artisan migrate

Статус міграцій

Показує, які міграції вже виконані, а які — ні.

php artisan migrate:status

Відкотити останній “батч” міграцій

Откат останнього набору виконаних міграцій.

php artisan migrate:rollback

Відкотити певну кількість кроків

Контрольований rollback на N міграційних “кроків”.

php artisan migrate:rollback --step=1

Refresh міграцій

Откат і повторний запуск міграцій (зручно для dev).

php artisan migrate:refresh

Fresh міграцій з сідами

Видаляє всі таблиці й створює заново, потім запускає сіди.

php artisan migrate:fresh --seed

Запуск сідів

Запускає заповнення БД даними (seeding).

php artisan db:seed

Запуск конкретного сідера

Корисно для точкового оновлення довідників/демо-даних.

php artisan db:seed --class=UsersTableSeeder

Черги (Queue)

Запустити воркер черги

Обробляє завдання з черги у фоновому режимі (поки процес живий).

php artisan queue:work

Воркер з параметрами (tries/timeout/queue)

Корисно для продакшну та контролю “поганих” задач.

php artisan queue:work --queue=default --tries=3 --timeout=90

Перезапустити воркери (після деплою)

Сигнал воркерам перезапуститися й підхопити новий код.

php artisan queue:restart

Показати failed jobs

Виводить список задач, які впали й потрапили у failed_jobs.

php artisan queue:failed

Повторити всі failed jobs

Повторно ставить у чергу всі провалені завдання.

php artisan queue:retry all

Планувальник (Scheduler)

Список запланованих задач

Показує, що саме заплановано в App\Console\Kernel (або відповідному місці).

php artisan schedule:list

Запустити планувальник один раз

Виконує due-задачі прямо зараз (аналог cron-тригеру).

php artisan schedule:run

Запустити планувальник як процес

Тримає scheduler “живим” і виконує задачі без системного cron (зручно локально/в контейнері).

php artisan schedule:work

Тести та дев-інструменти

Запустити всі тести

Запускає PHPUnit/Pest тести проєкту.

php artisan test

Запустити тести з фільтром

Корисно для швидкої перевірки одного тесту/класу.

php artisan test --filter=UserTest

Інтерактивна консоль

Запускає REPL для виконання PHP-коду в контексті застосунку.

php artisan tinker

Файли та публікації

Створити символічне посилання на storage

Робить публічним доступ до storage/app/public через public/storage.

php artisan storage:link

Публікація файлів пакетів

Публікує конфіги/в’юхи/ассети пакетів у ваш проєкт (дивіться доступні теги).

php artisan vendor:publish

Публікація по тегу

Публікує тільки ресурси з конкретного тега пакету.

php artisan vendor:publish --tag=filament-config

Типові “комбо”

“Щось не те після правок”: швидкий сброс кешів

Безпечний спосіб повернути проєкт у “чистий” стан кешів.

php artisan optimize:clear

Типовий деплой (консервативно)

Maintenance → міграції → оптимізація → повернення онлайн.

php artisan down && php artisan migrate --force && php artisan optimize && php artisan up

Деплой з перезапуском воркерів

Після оновлення коду воркерам треба підхопити нову версію.

php artisan queue:restart