2.14.2.5. Утилита Artisan

Утилита Artisan это консольный интерфейс для работы с фреймворком Laravel, идущий с ним в комплекте и устанавливаемый при создании проекта. Данная утилита упрощает работу с фреймворком и даёт огромный спектр возможностей.

Использование Artisan

Запуск утилиты и её команд производится непосредственно из каталога проекта фреймворка. Для использования выполните следующее:

  1. Подключитесь к хостингу по SSH.
  2. Перейдите в каталог проекта, выполнив команду:
    cd ~/example.com/www/

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

  3. По умолчанию в окружении SSH на хостинге используется PHP 5.6. Согласно требованиям фреймворка нужна версия не ниже 7.3, поэтому переопределите пути в переменной $PATH, выполнив команду:
    export PATH=/usr/local/php73/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin
  4. Выполните команду для проверки работы 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 создана универсальная команда, используйте её вместо artisan.

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

php artisan list

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

php artisan help list

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

Ознакомиться с работой команд Artisan можно в документации laravel.su1) или в официальной документации.

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