Установка

• Знакомитесь с Darklyy
• Подготовка к развертыванию
  • Настройка Open Server Panel
  • Рекомендацию к IDE
• Установка

Знакомитесь с Darklyy

Darklyy — это фреймворк для веб-приложений. Веб-фреймворк обеспечивает структуру и отправную точку для создания вашего приложения, позволяя вам сосредоточиться на создании а не над базовыми функциями.

Подготовка к развертыванию

Для развертывание среды разработки и дальнейшего использования Darklyy необходимо выполнить следующие действия

1. Получить доступ к закрытому репозиторию Github
2. Скачать и установить Open Server Panel
3. Скачать и установить Git
4. Скачать и установить Node.js (рекомендуется v18.18.0)
5. При необходимости установить необходимою версию Python для отладки скриптов

Настройка Open Server Panel

Для того чтобы открыть настройки запустите Open Server Panel, далее в трее нажмите правой кнопкой на флажок и выберите пункт настройки. В настройках выполните следующие действия:

1. На вкладке "Основное"
   • Поставьте галочку (если не стоит) "Автозапуск Сервера"
   • Поставьте галочку (если не стоит) "Запускать вместе с Windows"
2. На вкладке "Модули"
   • В разделе "HTTP" выберите Nginx 1.21 или Nginx 1.23 или Nginx 1.23.1
   • В разделе "PHP" выберите PHP 8.1
   • В разделе "MySQL/MariaDB" выберите MariaDB 8.6 win 10
3. На вкладке "Домены" в разделе "Управления доменами" должно стоять Ручное + Автопоиск

Рекомендацию к IDE

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

В данном редакторе множество расширений что позволяет удобно редактировать код. Ниже представлен список рекомендуемых расширений:

• PHP Intelephense - Проверка кода PHP
• PHPDoc Comment - Создание документации в коде
• PHP Namespace Resolver - Работа с namespace в коде
• SCSS Formatter - Форматирование CSS
• Git Graph - Просмотр графика Git репозитория
• Laravel Blade formatter - Форматирован шаблонов Blade
• Russian Language Pack for Visual Studio Code - Русский язык для VSCode
• Thunder Client - Эмуляция запросов, аналог Postman

Установка

1. В директории установленной Open Server Panel (обычно C:\OSPanel\domains) создать папку с будущим доменом (рекомендуется ae.ru)
2. Открыть Git Bush в созданной директории
3. Выполнить команду git clone https://github.com/darkeum/ATRIENERGO.git . и дождаться развертывания проекта
4. В папке проекта переименовать .env.example в .env
5. Открыть файл .env и заполнить настройки окружения или запросить готовый .env файл с настройками:
   • Строки APP_URL=https://ae.ru и API_URL=https://api.ae.ru заполнить согласно имени домена который вы указали на 1 пункте
   • Заполнить раздел с подключение к базе данных (данные по запросу)
   • Также вы можете заполнить другие настройки по своему усмотрению
6. Теперь необходимо запустить Open Server Panel (если он еще не запущен), для этого правой кнопкой нажмите на значок Open Server Panel (флажок), и нажмите на пункт "Запустить"
7. Далее необходимо открыть консоль Open Server Panel, для этого правой кнопкой нажмите на значок Open Server Panel (флажок), выберите пункт "Дополнительно", а в нем пункт "Консоль"
8. В консоли перейдите в папку домена командой cd domains\ae.ru (если на первом пункте вы создали другое имя домена то укажите его)
9. Теперь выполните команду composer install
10. Далее откройте папку с проектом в VSCode, для этого нажмите правой кнопкой в папке проекта и выберите пункт "Открыть с помощью Code"
11. Откройте терминал в VSCode, для этого внизу окна нажмите на раздел "Сведения" и выберите вкладку "Терминал" или создайте новый терминал и верхнего меню (Терминал->Новый терминал)
12. В терминале пропишите команду npx mix
13. Откройте в браузере https://ae.ru/ (если на первом пункте вы создали другое имя домена то откройте его), подтвердите ошибку безопасности и убедитесь что проект работает