2.8.4.2.5. Утиліта Artisan

Утиліта Artisan — це консольний інтерфейс для роботи з фреймворком Laravel, що йде з ним у комплекті та встановлюється при створенні проекту. Ця утиліта спрощує роботу з фреймворком і надає величезний спектр можливостей.

Запуск утиліти та її команд здійснюється безпосередньо з каталогу проекту фреймворку. Для використання виконайте наступне:

  1. Перейдіть у каталог проекту, виконавши команду:
    cd ~/example.com/www/

    Замість example.com/www вкажіть кореневий каталог сайту.

  2. За замовчуванням в оточенні SSH на хостингу використовується PHP 5.6. Згідно з вимогами фреймворку потрібна версія не нижче 7.3, тому перевизначте шляхи в змінній $PATH, виконавши команду:
    export PATH=/usr/local/php73/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin
  3. Виконайте команду для перевірки роботи Artisan:
    php artisan
    • Подальший запуск команди artisan можливий тільки з його каталогу. Якщо потрібно створити команду, яка буде викликатися без необхідності переходу в каталог, то виконайте наступну команду:
      echo "alias command='/usr/local/php73/bin/php ~/example.com/www/artisan'" >> ~/.bashrc && source ~/.bashrc

      Змініть вказану команду в залежності від потрібних даних:

      • Замість «command» вкажіть бажану назву команди, яка буде використовуватися. Наприклад, можна вказати назву проекту типу laravel_example.
      • Замість «example.com/www» вкажіть кореневий каталог сайту.
    • Перевірте роботу команди, виконавши:
      command -V

      Стандартним результатом цієї команди буде версія встановленого фреймворку.

Якщо для Artisan створено універсальну команду, використовуйте її замість artisan.

Для виведення списку доступних команд виконайте наступну команду:

php artisan list

Для всіх команд можна отримати довідку щодо їх використання. Для цього використовуйте команду help з назвою команди, про яку хочете отримати інформацію.:

php artisan help list

При неправильному введенні команди будуть запропоновані схожі варіанти, наприклад:

Ознайомитися з роботою команд Artisan можна в офіційній документації.

Команда Опис
Основні команди
clear-compiled Видалити скомпільовані файли класів
down Увімкнути режим обслуговування / демо-режим
env Виведення поточних параметрів оточення фреймворка
help Виведення довідки за командою
inspire Висновок надихаючої цитати
list Отримання списку доступних команд
migrate Запуск міграції бази даних
optimize Оптимізація підключених файлів шляхом створення кеш-файлів
serve Запуск сервера (в рамках віртуального хостингу команда не буде коректно працювати)
test Запустити тести застосунку
tinker Взаємодія з застосунком
up Вимкнути режим обслуговування / демо-режим
Зміст