Установка Drupal на FreeBSD: Apache, PHP и MySQL
FreeBSD — надёжная платформа для веб-сервера, и Drupal на ней работает без сюрпризов. Разбираем установку от пакетов до веб-установщика: стек Apache, PHP и MySQL, база данных, виртуальный хост и права на файлы.
Что понадобится
Drupal — PHP-приложение, которому нужны веб-сервер, PHP с набором расширений и СУБД. На FreeBSD всё это ставится из пакетов pkg.
| Компонент | Для Drupal 10/11 | Для Drupal 7 |
|---|---|---|
| Веб-сервер | Apache 2.4 или Nginx | Apache 2.x или Nginx |
| PHP | Актуальная версия 8.x, точные требования — в документации релиза | PHP 7.x–8.x в зависимости от подверсии ядра |
| СУБД | MySQL/MariaDB, PostgreSQL или SQLite | MySQL, PostgreSQL или SQLite |
| Расширения PHP | pdo_mysql (или pdo_pgsql), gd, xml, mbstring, opcache, curl | pdo_mysql, gd, xml, mbstring |
Требования к версиям меняются от релиза к релизу, поэтому перед установкой сверьтесь с разделом System requirements на drupal.org.
Шаг 1. Установка пакетов
Обновите репозиторий и поставьте стек. Номер версии PHP в именах пакетов (php83) подставьте тот, что актуален в вашем репозитории — проверить можно командой pkg search php8.
pkg update
pkg install apache24 mysql80-server php83 mod_php83 \
php83-pdo php83-pdo_mysql php83-gd php83-xml php83-dom php83-mbstring \
php83-opcache php83-curl php83-filter php83-session php83-simplexml \
php83-tokenizer php83-zip php83-zlib
Включите автозапуск и запустите службы:
sysrc apache24_enable=YES mysql_enable=YES
service mysql-server start
service apache24 start
Шаг 2. Подключение PHP к Apache
Создайте файл /usr/local/etc/apache24/Includes/php.conf:
<IfModule dir_module>
DirectoryIndex index.php index.html
<FilesMatch "\.php$">
SetHandler application/x-httpd-php
</FilesMatch>
</IfModule>
В /usr/local/etc/apache24/httpd.conf раскомментируйте строку с mod_rewrite — без неё не заработают «чистые» адреса:
LoadModule rewrite_module libexec/apache24/mod_rewrite.so
Модуль mod_php работает только с MPM prefork: убедитесь, что в том же файле активна строка LoadModule mpm_prefork_module, а mpm_event и mpm_worker закомментированы. Альтернатива — PHP-FPM с любым MPM.
Скопируйте рабочую конфигурацию PHP: cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini.
Шаг 3. База данных
Выполните mysql_secure_installation, затем создайте базу и пользователя. В MySQL 8 пользователь создаётся отдельно от выдачи прав:
CREATE DATABASE drupal CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'drupal'@'localhost' IDENTIFIED BY 'сложный_пароль';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER,
CREATE TEMPORARY TABLES, LOCK TABLES
ON drupal.* TO 'drupal'@'localhost';
FLUSH PRIVILEGES;
Шаг 4. Код Drupal
Современные версии Drupal ставятся через Composer. Установите его (пакет ищется командой pkg search composer, либо по инструкции с getcomposer.org) и создайте проект:
mkdir -p /usr/local/www/drupal
cd /usr/local/www
composer create-project drupal/recommended-project drupal
Корень сайта в такой структуре — подкаталог web, а библиотеки в vendor остаются вне публичного доступа.
Для Drupal 7 архив скачивается со страницы проекта на drupal.org и распаковывается в каталог сайта:
tar -xzf drupal-7.x.tar.gz
mv drupal-7.x /usr/local/www/drupal7
Шаг 5. Виртуальный хост
Добавьте файл /usr/local/etc/apache24/Includes/drupal.conf:
<VirtualHost *:80>
ServerName example.com
DocumentRoot "/usr/local/www/drupal/web"
<Directory "/usr/local/www/drupal/web">
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
AllowOverride All нужен, чтобы работал файл .htaccess из комплекта Drupal. Синтаксис Order deny,allow / Allow from all из Apache 2.2 в версии 2.4 заменён на Require all granted. Проверьте конфигурацию и перезапустите сервер:
apachectl configtest
service apache24 restart
Шаг 6. Файлы и права
Apache на FreeBSD работает от пользователя www. Код должен принадлежать другому пользователю и быть доступен веб-серверу только для чтения, а запись нужна лишь в каталог файлов:
cd /usr/local/www/drupal/web
cp sites/default/default.settings.php sites/default/settings.php
mkdir -p sites/default/files
chown -R root:www /usr/local/www/drupal
find /usr/local/www/drupal -type d -exec chmod 750 {} +
find /usr/local/www/drupal -type f -exec chmod 640 {} +
chown -R www:www sites/default/files
chmod 660 sites/default/settings.php
Права 777 на каталоги, которые часто советуют в старых инструкциях, не нужны и опасны.
Шаг 7. Веб-установщик
Откройте в браузере http://example.com/core/install.php (в Drupal 7 — /install.php) и пройдите шаги:
- Выберите язык. В Drupal 10/11 переводы скачаются автоматически; как перевести интерфейс вручную, рассказано в статье о русификации Drupal.
- Выберите профиль Standard.
- Укажите тип базы, имя базы, пользователя и пароль. В расширенных настройках можно задать хост, порт и префикс таблиц.
- Дождитесь создания таблиц, затем заполните название сайта, e-mail и учётную запись администратора, страну и часовой пояс.
Если на шаге с базой нет пункта MySQL, значит PHP не видит расширение pdo_mysql: проверьте php -m | grep pdo и перезапустите Apache.
Шаг 8. После установки
Верните настройкам защиту от записи и ограничьте допустимые имена хоста в settings.php:
chmod 440 sites/default/settings.php
chmod 550 sites/default
$settings['trusted_host_patterns'] = [
'^example\.com$',
'^www\.example\.com$',
];
Настройте cron Drupal (встроенный или системный через drush cron), включите HTTPS и регулярные резервные копии базы и каталога files.
Если вместо Apache — Nginx
На FreeBSD Drupal часто запускают в связке Nginx и PHP-FPM: такой стек экономнее расходует память под нагрузкой. В этом случае вместо mod_php83 нужен сервис php_fpm (sysrc php_fpm_enable=YES), а файл .htaccess Nginx игнорирует. Правила, которые в Apache берутся из него, — перенаправление запросов на index.php, запрет доступа к служебным файлам и каталогам private, vendor, .git, — придётся описать в конфигурации сервера. Готовый пример конфигурации есть в документации Drupal и в рецептах на сайте nginx.org; используйте его как основу, а не пишите правила с нуля.
Актуальность
Drupal 7 вышел в 2011 году, а его поддержка завершилась в январе 2025-го, так что инструкции под связку Apache 2.2, PHP 5 и MySQL 5.0 устарели вместе с ним. Новые сайты стоит поднимать на Drupal 10 или 11 по шагам выше, а старые на Drupal 7 — переносить, используя встроенный в ядро инструмент миграции. Про SEO на Drupal читайте подборку модулей.
Частые вопросы
Какую версию Drupal ставить на новый сервер?
Актуальную стабильную ветку Drupal 10 или 11. Drupal 7 больше не получает обновлений безопасности, его имеет смысл разворачивать только для переноса старого сайта перед миграцией.
Установщик не видит MySQL — что проверить?
Установлено ли расширение PHP pdo_mysql и перезапущен ли Apache после установки. Проверить список расширений можно командой php -m.
Почему пароль в GRANT ... IDENTIFIED BY не работает?
В MySQL 8 пользователь создаётся отдельной командой CREATE USER, а GRANT только выдаёт права. Старый синтаксис с IDENTIFIED BY внутри GRANT вызывает ошибку.
Можно ли вместо Apache использовать Nginx?
Да, Drupal работает с Nginx и PHP-FPM. Нужно только перенести правила перезаписи URL из .htaccess в конфигурацию Nginx, поскольку .htaccess он не читает.