Установка платформы
- Создать проект
- Добавить зависимость
- Установка платформы
- Создание пользователя
- Запуск локального сервера
- Публикация статических ресурсов
- Обновление
- Что делать дальше?
Прежде чем вы сможете использовать платформу, нужно будет установить ее. Это руководство поможет вам выполнить простую установку, чтобы запустить проект.
Создать проект
Платформа является пакетом для фреймворка 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
.
Что делать дальше?
В зависимости от Вашего уровня, Вы можете попробовать повторить пошаговый пример работы с пакетом на странице "Быстрый старт" или просто погрузиться в документацию.