webslon/bitrix-env repository overview

⁠Установка docker для MacOS

1. Ставим doker:
   • Инструкция (на английском): https://docs.docker.com/docker-for-mac/install/⁠
2. Можно также поставить Kinematic или https://dockstation.io⁠ для визуального управления контейнерами.
3. Если гит еще не был установлен (может понадобиться в инструкции по установке Bitrix Environment ниже), тогда делаем:

   xcode-select --install
   

   Copy

⁠Установка Bitrix Environment под Docker

1. Создаем папку для docker-compose и переходим в нее, например:

   mkdir ~/Work/bitrix && cd ~/Work/bitrix
   

   Copy
   В дальнейшем все проекты будут располагаться в папке ~/Work/bitrix/ext_www⁠.
2. Скачиваем git-репозиторий:

   git clone [email protected]:VictorKrasnov/bitrix-env.git .
   

   Copy
3. Останавливаем штатный апач. При запуске докер-контейнера потребуется 80-й порт (мы не хотим использовать нестандартные порты, так как может вызывать неудобства при работе Bitrix), так что он должен быть свободен.

   # Для MacOS:
   sudo apachectl stop
   

   Copy
4. Настраиваем файл окружения.

   cp .env.dist .env
   

   Copy
   Далее редактируем файл .env, указываем там IP-адрес хост-машины в локальной сети, обычно начинается на 192 или 10, найти адрес можно или в настройках сетевой карты в интерфейсе настройки сети в ОС, или выполнив команду ifconfig | grep 192 или ifconfig | grep 10.
5. Запускаем контейнер:

   docker-compose up -d
   

   Copy
6. Заходим в контейнер:

   docker-compose exec webslon-bitrix-env bash --login
   

   Copy
   Произойдет запуск установки Bitrix Environment. Процесс может занимать от 10 до 20 минут. Повторный запуск этой же команды приведет к залогиниванию в контейнер и запуску меню Bitrix Environment (повторной установки не произойдет).

⁠Полезное

⁠Как быстро развернуть сайт из архива, созданного с помощью резервного копирования Bitrix

1. Скачать архив в корень сайта. Быстрее всего с помощью команды wget.
2. Записать (запомнить) логин / пароль / имя базы данных (посмотреть можно в bitrix/.settings или bitrix/php_interface/dbconn.php)
3. Перейти в папку сайта и выполнить:

   cat *.tar.* | tar xzpvf -
   

   Copy
4. После распаковки архива запустить restore.php и там выбрать "Архив уже распакован". На этапе восстановления БД ввести настройки, записанные в начале этого руководства.

⁠Подключение x-debug

1. Убедиться, что в контейнере в файле /etc/php.d/15-xdebug.ini в строке xdebug.remote_host указан IP-адрес локальной сети хост-машины (вашего компьютера). Например, адрес WiFi или LAN в настройках сети. Этот же адрес если правильно настроили файл .env должен выводиться командой в контейнере:

   echo ${DOCKER_HOST_IP}
   

   Copy
2. В настройках PhpStorm
   1. Preferences | Languages & Frameworks | PHP: указываем CLI Interpreter PHP 7.
   2. Preferences | Languages & Frameworks | PHP | Debug: в секции XDebug указываем XDebug port = 9001 и ставим все галочки.
   3. Preferences | Languages & Frameworks | PHP | Debug | DBGp Proxy: IDE Key: PHPSTORM, Host: Ваш IP-адрес локальной сети хост-машины, Port: 9001.
   4. Preferences | Languages & Frameworks | PHP | Servers: добавляем сервер, Host указываем Ваш IP-адрес локальной сети хост-машины, ставим галочку Use path mappings и настраиваем пути.

⁠Источники

1. Денис Бондарь. PhpStorm + Docker + Xdebug⁠
2. Документация по Docker. Инструкция по установке Centos⁠
3. Infoservice. Аналогичный образ в Docker⁠
4. Документация 1С-Битрикс. Подключение IDE⁠