centrdev / development-docker

CS-Cart development environment based on Docker containers

CS-Cart Development Environment

• English manual
  • Installation
  • MySQL connection
  • Working with different PHP versions
  • Sending e-mails
  • Working with multiple applications
  • Enabling xDebug for PHP containers
• Русская инструкция
  • Установка
  • Подключение к MySQL
  • Работа с разными версиями PHP
  • Отправка e-mail'ов
  • Работа с несколькими приложениями
  • Поддержка xDebug для PHP

English manual

Docker-based development environment:

• PHP versions: 8.0, 7.4, 7.3 and 5.6.
• MySQL 5.7 database server.
• nginx web server.

Installation

1. Install git, docker and docker-compose.

2. Clone the environment repository:

   $ git clone [e-mail]:cscart/development-docker.git ~/srv
   $ cd ~/srv

3. Create the directory to store CS-Cart files:

   $ mkdir -p app/www

4. Clone CS-Cart repository or unpack the distribution archive into the app/www directory.

5. Enable the default application config for nginx:

   $ cp config/nginx/app.conf.example config/nginx/app.conf

6. Run application containers:

   $ make -f Makefile run

MySQL connection

• DB host: mysql5.7.
• User: root.
• Password: root.

Working with different PHP versions

PHP 7.4 is used by default.

To use the specific PHP version for your requests, add the following prefix to the domain you request:

• php5.6. for PHP 5.6.
• php7.3. for PHP 7.3.
• php7.4. for PHP 7.4.
• php8.0. for PHP 8.0.

Sending e-mails

PHP containers do not send actual e-mails when using the mail() function.

All sent emails will be caught and stored in the app/log/sendmail directory.

Working with multiple applications

See comments in the config/nginx/app.conf.example file if you need to host multiple PHP applications inside single Docker PHP container.

Enabling xDebug for PHP containers

xDebug 3 is already configured for PHP7 and PHP8 containers. All you have to do is to uncomment the extension installation in the config/php*/Dockerfile files.

You can read about configuring PHPStorm to work with Docker and xDebug 3 in the "Debugging PHP" article.

Русская инструкция

Среда для разработки на базе Docker:

• Версии PHP: 8.0, 7.4, 7.3 и 5.6.
• Сервер баз данных MySQL 5.7.
• Веб-сервер nginx.

Установка

1. Установите git, docker and docker-compose.

2. Склонируйте репозиторий с окружением:

   $ git clone [e-mail]:cscart/development-docker.git ~/srv
   $ cd ~/srv

3. Создайте папку для файлов CS-Cart:

   $ mkdir -p app/www

4. Склонируйте репозиторий CS-Cart или распакуйте дистрибутив в папку app/www.

5. Включите приложение со стандартным конфигом nginx:

   $ cp config/nginx/app.conf.example config/nginx/app.conf

6. Запустите контейнеры приложения:

   $ make -f Makefile run

Подключение к MySQL

• Хост БД: mysql5.7.
• Пользователь: root.
• Пароль: root.

Работа с разными версиями PHP

По умолчанию используется PHP 7.4.

Чтобы явно указать версию PHP для конкретного запроса, добавьте к домену следующую приставку:

• php5.6. для PHP 5.6.
• php7.3. для PHP 7.3.
• php7.4. для PHP 7.4.
• php8.0. для PHP 8.0.

Отправка e-mail'ов

PHP по умолчанию не отправляют настоящих писем при вызове функции mail().

Все исходящие e-mail'ы перехватываются и пишутся в папку app/log/sendmail.

Работа с несколькими приложениями

См. комментарии в файле config/nginx/app.conf.example.

Поддержка xDebug для PHP

xDebug уже настроен для использования в контейнерах с PHP7 и PHP8. Для его включения нужно раскомментировать установку модуля в config/php*/Dockerfile.

О настройке PHPStorm для работы с Docker и xDebug 3 можно прочитать в статье "PHP: Настраиваем отладку".