Webasyst Development Environment

📜 Описание

Этот проект предоставляет удобную среду разработки для приложений Webasyst, основанную на Docker. Включены основные инструменты: PHP, MySQL, Nginx и PhpMyAdmin, обеспечивая гибкость и консистентность в процессе разработки.

⚠️ ВАЖНО: Данная среда предназначена исключительно для разработки. Ни в коем случае не используйте её для продакшн-серверов, поскольку конфигурации оптимизированы для удобства, а не для безопасности.

---

📋 Основные возможности

• PHP (версия настраивается, по умолчанию: 7.4)
• MySQL (версия настраивается, по умолчанию: 5.7)
• Nginx (последняя версия)
• PhpMyAdmin (последняя версия)
• Поддержка Xdebug для отладки
• Гибкое управление с помощью переменных окружения

---

🛠️ Требования

Перед началом работы убедитесь, что у вас установлены следующие инструменты:

• Docker
• Docker Compose

---

🚀 Быстрый старт

1. Склонируйте репозиторий:

   git clone https://github.com/shaba5h/webasyst-dev.git
   cd webasyst-dev

2. Выполните скрипт начальной настройки:

   ./scripts/setup.sh

3. Запустите контейнеры через Docker Compose:

   docker compose up -d --build

4. Откройте Webasyst в браузере по адресу http://localhost и следуйте инструкциям по установке.

---

⚙️ Конфигурации

Переменные окружения

Для настройки доступны следующие переменные (указаны их значения по умолчанию):

• MYSQL_VERSION: Версия MySQL (5.7)
• MYSQL_ROOT_PASSWORD: Пароль для пользователя root (root)
• MYSQL_DATABASE: Имя базы данных (wa)
• MYSQL_USER: Имя пользователя базы данных (webasyst)
• MYSQL_PASSWORD: Пароль пользователя базы данных (webasyst)
• PHP_VERSION: Версия PHP (7.4)

Эти переменные можно изменить в файле .env или через скрипт ./scripts/configure.sh.

Подключение к базе данных

Используйте следующие значения при установке Webasyst:

• Host: mysql
• Имя пользователя: (значение переменной MYSQL_USER)
• Пароль: (значение переменной MYSQL_PASSWORD)
• Имя базы данных: (значение переменной MYSQL_DATABASE)

---

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

В проекте уже включена поддержка Xdebug, которая позволяет удобно отлаживать PHP-код в вашей IDE. Для корректной работы Xdebug используется порт 9003. В некоторых случаях необходимо открыть этот порт в настройках фаервола для успешного соединения при отладке.

⚠️ ВНИМАНИЕ: В некоторых случаях необходимо открыть порт Xdebug (по умолчанию 9003) в вашем фаерволе, чтобы отладочные соединения работали корректно.

---

✨ Доступ к сервисам

• Webasyst: http://localhost
• PhpMyAdmin: http://localhost:8080

---

📂 Структура проекта

• .docker/: Конфигурации для Docker
  • nginx/: Конфигурационные файлы для Nginx
  • php-fpm/: Dockerfile и настройки для PHP
• scripts/: Утилитарные скрипты:
  • setup.sh: Автоматизация начальной настройки
  • configure.sh: Помогает изменить конфигурацию проекта
• docker-compose.yml: Определение Docker-сервисов
• .env: Переменные окружения для проекта

---

🛠️ Скрипты

setup.sh

Скрипт начальной настройки автоматизирует следующие шаги:

1. Конфигурирует переменные окружения.
2. Клонирует репозиторий Webasyst.
3. По желанию, добавляет Shop-Script и другие приложения.
4. Устанавливает корректные права на файлы.

Чтобы запустить скрипт:

chmod +x scripts/setup.sh
./scripts/setup.sh

configure.sh

С помощью этого скрипта вы можете легко изменить базовые настройки проекта. Для запуска:

chmod +x scripts/configure.sh
./scripts/configure.sh

Если нужно пропустить все вопросы и использовать стандартные значения, добавьте флаг --default:

./scripts/configure.sh --default

---

❗ Уведомление о безопасности

ЭТОТ ПРОЕКТ ПРЕДНАЗНАЧЕН ТОЛЬКО ДЛЯ ИСПОЛЬЗОВАНИЯ В РАЗРАБОТКЕ.

Он не подходит для запуска в продакшне, поскольку конфигурации не гарантируют надлежащего уровня безопасности и оптимизации. Для реальных серверов настройте окружение вручную с учетом всех требований к безопасности и производительности.

---

🤝 Вклад в проект

Ваши идеи и предложения по улучшению приветствуются! Оставляйте Pull Request.

---

📜 Лицензия

Этот проект распространяется под лицензией MIT.