Установка Drupal: что проверить до запуска сайта

Drupal 11 можно установить примерно за 30–60 минут, если заранее подготовлены PHP, база данных, доступ к серверу и домен. В конце вы получите рабочий сайт с административной панелью, но только при одном условии: корневой каталог веб-сервера будет указывать на папку web, а не на весь проект.

Что подготовить до установки Drupal

Инструкция рассчитана на Drupal 11.x и установку через Composer на Linux-хостинге или VPS. Для Drupal 10 шаги похожи, но требования к PHP и зависимостям могут отличаться, поэтому версию нужно проверять отдельно.

• домен или временный адрес сайта;
• PHP 8.3 или более новая версия, совместимая с выбранным выпуском Drupal 11;
• расширения PHP, перечисленные в системных требованиях Drupal, включая работу с базой данных, XML, архивами и многобайтовыми строками;
• MySQL 8.0 или MariaDB 10.6 и новее либо другая поддерживаемая СУБД;
• Composer 2.x;
• доступ по SSH или панель хостинга с установкой CMS;
• отдельная база данных, имя пользователя и пароль к ней;
• SSL-сертификат для домена.

Точные версии расширений и поддерживаемых СУБД сверяйте в официальных требованиях именно для вашей ветки Drupal. На shared-хостинге часть параметров может быть недоступна: например, нельзя сменить версию PHP или задать корневой каталог домена.

Самая дорогая ошибка при установке Drupal — открыть для веба весь проект вместо папки web. Так можно случайно раскрыть файлы зависимостей и конфигурации.

Document root¹ — каталог, из которого веб-сервер отдает файлы посетителю. В проекте Drupal, созданном рекомендуемым шаблоном Composer, им должна быть папка web.

Шаг 1. Проверьте сервер и доступы

До загрузки Drupal войдите на сервер по SSH или откройте панель хостинга. Проверьте версии PHP и Composer командами:

php -v
composer --version

Для Drupal 11 в выводе PHP должна быть версия 8.3 или выше, а Composer должен запускаться без ошибки. Название команды может отличаться на конкретном хостинге: иногда используется php83 вместо php. Если PHP старше, переключите версию в панели или обратитесь к провайдеру.

Проверка. В терминале отображаются версии PHP и Composer, а не сообщения «command not found» или «permission denied».

Шаг 2. Создайте проект Drupal через Composer

Перейдите в каталог, где хранятся сайты, и создайте проект из официального шаблона Drupal. Команда ниже устанавливает актуальную минорную версию из ветки Drupal 11:

composer create-project drupal/recommended-project:^11.0 my-drupal-site

Замените my-drupal-site на имя каталога проекта латиницей без пробелов. Composer скачает ядро Drupal, зависимости и создаст структуру, в которой публичные файлы находятся в web. Не загружайте зависимости вручную из случайных архивов: так сложнее обновлять ядро и проверять состав проекта.

Проверка. В каталоге проекта появились папки web и vendor, а команда завершилась без красных сообщений об ошибках.

Шаг 3. Направьте домен в папку web

В панели хостинга найдите настройку корневого каталога домена и укажите путь вида:

/home/USER/my-drupal-site/web

Путь зависит от хостинга, поэтому копируйте его из панели, а не вставляйте этот пример буквально. Для Nginx или Apache настройка делается в конфигурации виртуального хоста. Если вы не управляете сервером самостоятельно, попросите поддержку установить document root именно на web.

Проверка. При открытии домена загружается стартовая страница Drupal или мастер установки. Содержимое каталогов vendor и самого проекта не отображается в браузере.

Шаг 4. Подготовьте базу данных

Создайте отдельную базу для сайта и пользователя с правами на эту базу. Запишите четыре значения:

1. тип базы данных, например MySQL или MariaDB;
2. имя базы;
3. имя пользователя;
4. адрес сервера базы данных и пароль.

На том же хостинге адресом часто служит localhost, но это не универсальное правило. На VPS база может работать в отдельном контейнере или на другом сервере. Не используйте учетную запись администратора СУБД для Drupal: при компрометации сайта ее права будут слишком широкими.

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

Шаг 5. Запустите веб-установщик

Откройте в браузере адрес домена с путем /core/install.php. Выберите язык, затем профиль установки. Для первого сайта обычно подходит стандартный профиль: он добавляет базовую конфигурацию и не требует ручного выбора каждого компонента.

На шаге выбора базы укажите подготовленные реквизиты. Если хостинг предлагает отдельное поле для префикса таблиц, оставьте его пустым, если на этой базе работает только один сайт. Для нескольких установок лучше использовать разные базы или понятные префиксы.

Проверка. После отправки формы Drupal создает таблицы и переводит вас к настройкам сайта, а не показывает ошибку подключения к базе.

Шаг 6. Заполните сведения о сайте и администраторе

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

Электронная почта нужна не только для контактов. Drupal использует ее для уведомлений и восстановления доступа, поэтому после установки настройте отправку писем через почтовый сервис или SMTP-провайдера. Проверка почты — отдельная задача; сама установка сайта не включает проверку доставки сообщений.

Проверка. Вы вошли в административную панель, видите название сайта и можете открыть страницу управления конфигурацией.

Если установка не прошла

• «Your PHP installation is too old». Версия PHP не подходит для Drupal 11. Переключите PHP на поддерживаемую версию и проверьте обязательные расширения.
• «Could not connect to the database». Проверьте имя базы, пользователя, пароль и адрес сервера. localhost подходит не для каждого хостинга.
• «The website encountered an unexpected error». Включать подробный вывод ошибок на публичном сайте нельзя. Посмотрите журналы PHP и веб-сервера, а диагностику выполняйте на копии сайта или временно ограничьте доступ по IP.
• Белая страница или ошибка 403. Проверьте права файлов, владельца каталогов и соответствие document root папке web. Не исправляйте проблему выдачей прав 777 всему проекту.
• После установки открывается список файлов или скачивается PHP. Домен направлен не в web либо веб-сервер неправильно настроен на обработку PHP. Исправьте виртуальный хост и перезапустите конфигурацию сервера.

Что проверить сразу после запуска

Пустой сайт уже работает, но к публикации его еще рано допускать. Выполните короткую проверку:

1. откройте сайт по HTTPS и убедитесь, что браузер не показывает предупреждение о сертификате;
2. зайдите в отчет о состоянии Drupal и исправьте критические предупреждения;
3. проверьте часовой пояс, язык, формат даты и адрес отправителя писем;
4. создайте резервную копию базы и файлов, а затем попробуйте восстановить ее на тестовой среде;
5. создайте отдельную роль для редактора, если контент будут публиковать не только администраторы;
6. проверьте обновление ядра и модулей в тестовой копии, а не сразу на рабочем сайте.

Drupal хранит код, загружаемые файлы и базу данных отдельно. Резервная копия только каталога сайта не восстановит материалы, пользователей и настройки, которые находятся в базе. Инвалидация кеша и настройка производительности — отдельная тема: до нее сначала нужно добиться корректной установки и резервного копирования.

Что делать дальше

Следующим шагом настройте резервное копирование и отдельную тестовую копию сайта. Затем установите только необходимые модули, включите автоматический контроль обновлений зависимостей и проверьте журналы после первой публикации. На рабочем сервере особенно важно следить за свободным местом, ошибками PHP и временем ответа страниц: эти показатели быстрее всего покажут, что проблема уже вышла за рамки обычной настройки Drupal.