msav/bitrix-php-apache repository overview

⁠PHP-Apache для 1C-Битрикс

Docker-образы PHP с Apache, оптимизированные для разработки и production-развёртывания 1C-Битрикс CMS и Битрикс24.

⁠Поддерживаемые теги

Теги 8.1 и 8.2 поддерживаются в полном паритете (одинаковый набор расширений и конфигураций).

⁠Архивные версии (7.4 / 7.2)

Образы PHP 7.4 и 7.2 перемещены в архив (bitrix-env/images/archive/), не поддерживаются и не обновляются; PHP 7.2 достиг EOL. Для новых проектов используйте 8.1 или 8.2.

⁠Быстрый старт

⁠Docker Run

docker run -d \
  --name bitrix \
  -p 80:80 \
  -v $(pwd)/www:/var/www/html \
  -e MEMORY_LIMIT=1024M \
  -e PHP_INI_TYPE=development \
  msav/bitrix-php-apache:8.1

⁠Docker Compose

services:
  php:
    image: msav/bitrix-php-apache:8.1
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./www:/var/www/html
      - ./session:/var/www/session
    environment:
      MEMORY_LIMIT: "1024M"
      PHP_INI_TYPE: "development"
      USER_ID: "1000"
      GROUP_ID: "1000"

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

⁠PHP

⁠Пользователь

⁠Сайт и прокси

⁠SMTP

⁠Права и отладка

⁠PHP расширения

⁠Встроенные

bz2, calendar, exif, ftp, gd (WebP, JPEG, PNG, XPM, FreeType, AVIF), gettext, imap, intl, ldap, mysqli, opcache, pdo_mysql, pspell, shmop, sockets, sodium, sysvmsg, sysvsem, sysvshm, xsl, zip

⁠PECL

amqp, apcu, igbinary, imagick, lz4, lzf, mcrypt, memcache, memcached, msgpack, rdkafka, redis (с igbinary, lz4, lzf, msgpack, zstd), rrd, ssh2 (1.5.0), xlswriter, zstd

⁠Особенности

⁠Multi-stage сборка

Образ использует двухэтапную сборку: компиляция расширений с dev-пакетами, затем только runtime-библиотеки. Уменьшение размера на 40-50%.

⁠Российские сертификаты

Включены сертификаты Минцифры РФ (Russian Trusted Root CA, Russian Trusted Sub CA) для работы с российскими сервисами.

⁠Автоустановка Битрикс

При первом запуске с пустым /var/www/html автоматически загружается bitrixsetup.php.

⁠Health Check

Файл /var/www/html/health.php возвращает HTTP 200 для проверки состояния контейнера.

⁠Xdebug и XHProf

Xdebug 3.5.1 и XHProf 2.3.10 скомпилированы в образ, но по умолчанию выключены (нулевой overhead в production). Активация в runtime: XDEBUG_ENABLED=1 (режим через XDEBUG_MODE) и XHPROF_ENABLED=1.

⁠Индексация документов

Включены CLI-инструменты для полнотекстовой индексации и search.title Битрикс: catdoc (DOC), poppler-utils/pdftotext (PDF), aspell (орфография), msmtp (SMTP-клиент).

⁠OPcache JIT отключён

JIT-компиляция отключена намеренно (opcache.jit=disable): команда 1С-Битрикс официально не использует JIT и не гарантирует стабильность продукта с ним. Включать только осознанно.

⁠Development vs Production

В обоих режимах opcache.validate_timestamps=1 (Битрикс динамически перезаписывает PHP-файлы). Различие — в revalidate_freq: в development файлы проверяются на каждом запросе (0), в production — не чаще раза в 2 секунды (2).

⁠Тома

⁠Порты

⁠Решение проблем

⁠Ссылки

• GitHub: mvandrew/bitrix-env⁠
• Полная документация: README.md⁠