Shkerka.ruзаметки админа
Drupal

Установка Drupal на FreeBSD: Apache, PHP и MySQL

Опубликовано: Обновлено: 5 мин чтенияАвтор: Редакция Shkerka.ru

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) и пройдите шаги:

  1. Выберите язык. В Drupal 10/11 переводы скачаются автоматически; как перевести интерфейс вручную, рассказано в статье о русификации Drupal.
  2. Выберите профиль Standard.
  3. Укажите тип базы, имя базы, пользователя и пароль. В расширенных настройках можно задать хост, порт и префикс таблиц.
  4. Дождитесь создания таблиц, затем заполните название сайта, 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 он не читает.