Развертывание системы «1С-Битрикс: Управление сайтом» на локальном компьютере — стандартная задача для разработчиков и администраторов. Однако при ручной настройке веб-окружения на операционной системе Windows часто возникают критические ошибки. Веб-установщик Bitrix выдает предупреждения о том, что обязательные модули PHP (такие как функции MySQL, OpenSSL, Multibyte String, а также параметр mbstring.func_overload) не установлены или настроены некорректно. Даже после ручной правки конфигурационного файла php.ini и перезапуска веб-сервера Apache система может продолжать выдавать те же самые ошибки.
В этой статье мы подробно разберем причины возникновения подобных проблем, выясним, почему изменения в php.ini могут «не применяться», и рассмотрим пошаговые сценарии настройки локального окружения: от ручного исправления конфигурации до использования готовых платформ разработки, таких как XAMPP, OpenServer, BitrixVM и Docker в связке с WSL2.
Если мы отредактировали файл php.ini, перезапустили веб-сервер Apache, но установщик «1С-Битрикс» все равно показывает ошибки, наиболее вероятная причина — редактирование не того конфигурационного файла. В Windows-системах при установке Apache и PHP часто сосуществуют несколько файлов конфигурации (например, один для работы PHP из командной строки CLI, другой — для модуля веб-сервера).
Давайте выполним диагностику и найдем правильный конфигурационный файл, выполнив следующие шаги:
info.php.
<?php
phpinfo();
?>
http://localhost/info.php.php.ini, который использует наш веб-сервер Apache.php.ini в системе редактировать бесполезно.После внесения любых изменений в правильный файл конфигурации обязательно перезапускаем службу Apache. Поскольку PHP на локальной машине обычно работает как модуль Apache, изменения не вступят в силу, пока веб-сервер удерживает старую конфигурацию в оперативной памяти.
Проанализируем каждую ошибку установщика «1С-Битрикс» по отдельности и приведем конфигурацию php.ini к требуемым стандартам.
1. Ошибка «функции MySQL — Не установлен»
В современных версиях PHP 7.x и 8.x старое расширение mysql (без суффикса «i») полностью удалено. Вместо него используются современные драйверы. Нам необходимо активировать расширение mysqli или pdo_mysql. Для этого в файле php.ini найдем и раскомментируем (уберем символ точки с запятой ; в начале строки) следующие директивы:
extension=mysqli
extension=pdo_mysql
Также критически важно убедиться, что PHP знает, где физически искать эти библиотеки расширений. Проверим директиву extension_dir. Для операционной системы Windows она должна указывать на папку ext в каталоге с установленным PHP. Раскомментируем и настроим эту строку следующим образом:
extension_dir = "ext"
Или укажем полный путь к папке, например:
extension_dir = "C:/php/ext"
2. Ошибка «OpenSSL — Не установлен»
Модуль шифрования OpenSSL необходим «1С-Битрикс» для отправки почты по защищенным протоколам, обновлений системы и работы с внешними API (например, интеграция с платежными системами и службами доставки). Активируем его, раскомментировав строку:
extension=openssl
3. Ошибка «Multibyte String» и параметр «mbstring.func_overload»
Параметр многобайтовых строк чрезвычайно важен для корректной работы с кодировкой UTF-8 в Битриксе. Настройки будут зависеть от версии PHP, которую мы используем на локальной машине:
mbstring и жестко задать перегрузку функций. В php.ini раскомментируем строку extension=mbstring и отредактируем следующие параметры:
mbstring.func_overload = 2
mbstring.internal_encoding = UTF-8
mbstring.func_overload = 2 указывает интерпретатору заменять стандартные строковые функции их аналогами из библиотеки mbstring, что предотвращает появление «битых» символов в кириллических текстах.
mbstring.func_overload был признан устаревшим в PHP 7.4 и полностью удален в PHP 8.0. Если мы устанавливаем современную версию «1С-Битрикс» на PHP 8.x, настраивать этот параметр больше не нужно. Современное ядро продукта изначально адаптировано под работу без принудительной перегрузки функций, а кодировка UTF-8 используется по умолчанию.Если ручная сборка связки Apache + PHP вызывает затруднения, рассмотрим более простые альтернативы — готовые программные пакеты (WAMP-стеки), которые позволяют развернуть веб-сервер за несколько минут.
Как показывает практика практикующих разработчиков, использование XAMPP позволяет быстро решить проблему с модулями «из коробки». В XAMPP все базовые расширения PHP (включая OpenSSL и mysqli) уже скомпилированы и подключены. Единственное действие, которое нам потребуется выполнить после установки:
php.ini.mbstring.func_overload и установить ей значение 2 (для версий PHP 7.x).Обратите внимание: некоторые специалисты отмечают, что встроенный в XAMPP сервер Apache может нестабильно работать при прямой интеграции веб-сервисов с платформой «1С:Предприятие». Если планируется сложный обмен данными с 1С на локальном компьютере, стоит рассмотреть другие решения.
Для веб-разработки под Windows среди специалистов по Битриксу заслуженной популярностью пользуется локальный сервер OpenServer Panel. Его преимущества неоспоримы:
memory_limit = 512M), время выполнения скриптов (max_execution_time = 60) и активированы все требуемые PHP-модули.Для запуска Битрикса на OpenServer нам достаточно зайти в настройки программы, на вкладке «Модули» выбрать нужную связку (например, Apache + PHP 8.1 + MySQL 8.0) и запустить сервер. Установка Битрикса пройдет без единой ошибки конфигурации.
Еще один современный инструмент — Laragon. Он работает быстрее классических веб-серверов под Windows, автоматически генерирует локальные домены (например, mysite.local) и изолирует конфигурации проектов. Laragon отлично подходит для разработки на современных версиях PHP 8.x, где требования к старым конфигурациям типа mbstring.func_overload уже не актуальны.
Если мы хотим максимально приблизить локальную среду разработки к реальному «боевому» хостингу, правильным решением будет использование официальной виртуальной машины от разработчиков Битрикса — BitrixVM.
Рассмотрим этот процесс по шагам:
root и пользователя bitrix.Важное замечание по поводу операционной системы: Исторически BitrixVM базировалась на ОС CentOS. В связи с прекращением поддержки CentOS 7 со стороны разработчиков, новые версии веб-окружения Битрикс переводятся на стабильные и современные дистрибутивы Rocky Linux и AlmaLinux. При скачивании виртуальной машины всегда выбирайте последнюю версию с официального сайта, чтобы избежать проблем со старыми версиями PHP и уязвимостями операционной системы.
Для опытных веб-разработчиков отличной альтернативой тяжелым виртуальным машинам станет связка подсистемы WSL2 (Windows Subsystem for Linux) и контейнеризации Docker.
WSL2 запускает полноценное ядро Linux внутри Windows 10/11, что обеспечивает колоссальную производительность файловой системы по сравнению с классическими виртуальными машинами. Развернув Docker внутри WSL2, мы можем использовать готовые образы и контейнеры для Битрикса (например, популярный проект с открытым исходным кодом bitrix-docker).
Преимущества работы через Docker:
Даже если все модули PHP успешно прошли проверку установщика, на этапе создания и импорта базы данных локальная установка может прерваться загадочной ошибкой. Чтобы этого не произошло, проанализируем настройки СУБД MySQL (или MariaDB) на локальной машине.
В конфигурационном файле MySQL (обычно это my.ini в Windows или my.cnf в Linux) необходимо настроить следующие параметры:
[mysqld]
max_allowed_packet = 1024M
sql_mode:
sql_mode = ""
Мы подробно разобрали все возможные технические препятствия при установке «1С-Битрикс» на локальный компьютер. Воспользовавшись предложенными инструкциями по настройке php.ini, выбрав правильную локальную платформу (OpenServer, BitrixVM или Docker) и оптимизировав базу данных, мы сможем развернуть быструю и стабильную среду для разработки и тестирования наших веб-проектов.