Установка платформы

Редактировать страницу

Прежде чем вы сможете использовать платформу, нужно будет установить ее. Это руководство поможет вам выполнить простую установку, чтобы запустить проект.

Создать проект

Платформа является пакетом для фреймворка Laravel, необходимо сначала установить его. Это можно сделать с помощью инструмента управления зависимостями Composer, выполнив в терминале команду:

$ composer create-project laravel/laravel orchid-project "8.*" --prefer-dist

У вас нет Composer? Его легко установить, следуя инструкциям на странице загрузки.

Это создаст новый каталог orchid-project, загрузит в него зависимости и сгенерирует основные каталоги и файлы, которые понадобятся для начала работы. Другими словами, установит ваш новый проект фреймворка.

Не забывайте - Установить права «chmod -R o+w» на каталоги storage и bootstrap/cache - Отредактировать .env файл

Добавить зависимость

Перейдите в созданный каталог проекта и выполните команду:

$ composer require orchid/platform

Примечание. Если вы устанавливали Laravel иначе, то возможно, вам придется сгенерировать ключ используя комманду php artisan key:generate

Примечание. Вам также необходимо создать новую базу данных и обновить .env файл с учетными данными и добавить URL-адрес вашего приложения в переменную APP_URL.

Установка платформы

Примечание. При установке будет перезаписана модель app/Models/User.

Запустим процесс установки, выполнив команду:

php artisan orchid:install

Создание пользователя

Для создания пользователя с максимальными правами на текущий момент, необходимо выполнить команду передав имя пользователя, электронный адрес и пароль:

php artisan orchid:admin admin admin@admin.com password

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

Для запуска проекта можно использовать встроенный сервер:

php artisan serve

Откройте браузер и перейдите к http://localhost:8000/admin. Если все работает, вы увидите страницу входа в панель управления. Позже, когда вы закончите работу, остановите сервер, нажав Ctrl+C в используемом терминале.

Примечание. Если используемая среда выполнения настроена на другой домен (например orchid.loc), то панель администратора будет недоступна. В этом случае требуется указать используемый домен в файле конфигурации config/platform.php или в .env. Это позволяет делать доступной панель администратора на другом домене или поддомене, например platform.example.com.

Публикация статических ресурсов

По умолчанию раздача статических файлов (css/js) происходит через маршруты приложения, это наилучший баланс между настройкой и отслеживанием изменений, но вы можете указать использовать для раздачи веб-серверы. Для этого необходимо выполнить команду, которая создаст символическую ссылку в публичном каталоге. Пожалуйста применяйте её, только если ваш веб-сервер испытывает трудности:

php artisan orchid:link

Возникли проблемы во время установки? Возможно, что у кого-то уже была такая проблема https://github.com/orchidsoftware/platform/issues . Если нет, вы можете отправить сообщение или обратиться за помощью.

Обновление

Находясь в директории проекта используйте Composer для обновления пакета:

composer update orchid/platform --with-dependencies

Примечание. Вы так же можете обновить все ваши зависимости перечисленные в файле composer.json запустить composer update.

Что делать дальше?

В зависимости от Вашего уровня, Вы можете попробовать повторить пошаговый пример работы с пакетом на странице "Быстрый старт" или просто погрузиться в документацию.