546 слов | 4 минуты

Битрикс на компьютер — как настроить локальную разработку

Разрабатывать и тестировать изменения прямо на рабочем сайте — плохая практика. Правильный подход: настроить локальное окружение на своём компьютере, работать там, а на сервер выкладывать уже готовый результат. Разберём что нужно установить и как это сделать.

Что нужно для работы Битрикс локально

1С-Битрикс — PHP-приложение, которому нужен стандартный веб-стек:

PHP — версия 7.4, 8.0, 8.1 или 8.2 (уточните в документации вашей редакции)
MySQL или MariaDB — база данных
Apache или Nginx — веб-сервер
Composer — менеджер зависимостей PHP (опционально, но удобно)

Установить всё это можно несколькими способами. Разберём каждый.

Способ 1. BitrixEnv — официальное решение (только Linux/Windows)

Bitrix Virtual Appliance (BitrixEnv) — это официальный образ от 1С-Битрикс с уже настроенным окружением. Самый простой способ получить среду максимально близкую к боевому серверу.

Вариант А: виртуальная машина

Скачайте образ VMware с сайта dev.1c-bitrix.ru
Установите VMware Workstation Player (бесплатно) или VirtualBox
Импортируйте скачанный образ
Запустите виртуальную машину
Откройте в браузере http://192.168.56.101 (IP указан в настройках ВМ)

Внутри уже готово: Apache, PHP, MySQL, phpMyAdmin, настроенные права и cron.

Вариант Б: скрипт установки на Linux

Если у вас уже есть Linux-машина (или WSL на Windows):

wget https://repos.1c-bitrix.ru/yum/bitrix-env.sh
chmod +x bitrix-env.sh
sudo ./bitrix-env.sh

Скрипт установит и настроит весь стек автоматически. Подходит для Debian/Ubuntu и CentOS.

Для Mac: BitrixEnv напрямую не поддерживается. Используйте Docker (способ 2) или MAMP (способ 3).

Способ 2. Docker — универсальный вариант

Docker позволяет запустить Битрикс в контейнерах — работает одинаково на Windows, Mac и Linux. Преимущество: можно держать несколько проектов с разными версиями PHP одновременно.

Установка Docker

Windows и Mac: скачайте Docker Desktop
Linux: установите через пакетный менеджер:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

docker-compose для Битрикс

Создайте файл docker-compose.yml в папке проекта:

version: '3.8'

services:
  web:
    image: php:8.1-apache
    ports:
      - "80:80"
    volumes:
      - ./www:/var/www/html
    depends_on:
      - db
    environment:
      - APACHE_DOCUMENT_ROOT=/var/www/html

  db:
    image: mariadb:10.6
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: bitrix
      MYSQL_USER: bitrix
      MYSQL_PASSWORD: bitrixpass
    volumes:
      - db_data:/var/lib/mysql

  phpmyadmin:
    image: phpmyadmin
    ports:
      - "8080:80"
    environment:
      PMA_HOST: db

volumes:
  db_data:

Запуск:

docker-compose up -d

После запуска:

Сайт: http://localhost
phpMyAdmin: http://localhost:8080

Файлы сайта размещайте в папке ./www рядом с docker-compose.yml.

Расширения PHP для Битрикс

Битрикс требует ряд PHP-расширений. Создайте Dockerfile рядом с docker-compose.yml:

FROM php:8.1-apache

RUN apt-get update && apt-get install -y \
    libzip-dev libpng-dev libjpeg-dev libfreetype6-dev \
    && docker-php-ext-install pdo_mysql mysqli zip gd opcache \
    && docker-php-ext-enable opcache

COPY ./php.ini /usr/local/etc/php/conf.d/bitrix.ini

Минимальный php.ini для Битрикс:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 100M
post_max_size = 100M
mbstring.func_overload = 0
date.timezone = Europe/Moscow

И обновите секцию web в docker-compose.yml:

  web:
    build: .
    # остальные параметры без изменений

Способ 3. MAMP / XAMPP — быстрый старт

Если Docker кажется сложным, можно использовать готовые локальные серверы.

MAMP (Mac и Windows)

MAMP — простое приложение с Apache, MySQL и PHP, которое запускается в один клик.

Скачайте и установите MAMP
Запустите сервер кнопкой «Start»
Положите файлы сайта в папку htdocs (Mac: /Applications/MAMP/htdocs/)
Откройте http://localhost:8888

Версию PHP выбирайте в настройках MAMP: MAMP → Preferences → PHP.

Для Битрикс рекомендуется дополнительно настроить php.ini:

Mac: /Applications/MAMP/bin/php/php8.x/conf/php.ini
Windows: C:\MAMP\bin\php\phpX.X\php.ini

Изменить те же параметры что описаны выше: memory_limit, upload_max_filesize, max_execution_time.

XAMPP (Windows, Mac, Linux)

XAMPP — аналог MAMP, чуть более распространён на Windows.

Установите XAMPP
Запустите Apache и MySQL через панель управления XAMPP
Файлы сайта: C:\xampp\htdocs\
phpMyAdmin: http://localhost/phpmyadmin

Установка Битрикс на локальное окружение

Когда окружение готово — установите Битрикс:

Скачайте дистрибутив с 1c-bitrix.ru (нужна учётная запись)
Распакуйте в корневую папку сайта (htdocs, www или ./www для Docker)
Создайте базу данных и пользователя (через phpMyAdmin или командную строку)
Откройте http://localhost в браузере
Следуйте мастеру установки:
- Введите данные базы данных
- Выберите редакцию и демо-данные
- Укажите данные администратора

Установка занимает 3–5 минут.

Перенос существующего сайта на локальное окружение

Если хотите работать с копией реального сайта:

# 1. Скачать файлы сайта через rsync или FTP
rsync -avz user@server:/var/www/site/ ./www/

# 2. Сделать дамп базы данных на сервере
mysqldump -u bitrix -p bitrix_db > backup.sql

# 3. Импортировать базу локально
mysql -u bitrix -p bitrix < backup.sql

После этого обновите файл подключения к БД /bitrix/php_interface/dbconn.php:

$DBHost     = "localhost";   // или "db" для Docker
$DBLogin    = "bitrix";
$DBPassword = "bitrixpass";
$DBName     = "bitrix";

И очистите кэш:

rm -rf /путь/к/сайту/bitrix/cache/*
rm -rf /путь/к/сайту/bitrix/managed_cache/*