Установка платформы
Suggest EditПрежде чем вы сможете использовать платформу, нужно будет установить ее. Это руководство поможет вам выполнить простую установку, чтобы запустить проект.
Создать проект
Платформа является пакетом для фреймворка Laravel, необходимо сначала установить его. Это можно сделать с помощью инструмента управления зависимостями Composer, выполнив в терминале команду:
composer create-project laravel/laravel orchid-project "7.*" --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.
Запустим процесс установки, выполнив команду:
php artisan orchid:install
Создание пользователя
Для создания пользователя с максимальными правами на текущий момент, необходимо выполнить команду передав имя пользователя, электронный адрес и пароль:
php artisan orchid:admin admin admin@admin.com password
Запуск локального сервера
Для запуска проекта можно использовать встроенный сервер:
php artisan serve
Откройте браузер и перейдите к http://localhost:8000/dashboard. Если все работает, вы увидите страницу входа в
панель управления. Позже, когда вы закончите работу, остановите сервер, нажав 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.
Что делать дальше?
В зависимости от того, насколько вы новичок, можете попробовать пошаговый пример работы с пакетом на странице “Быстрый старт” или просто погрузиться в документацию.