Установка Drupal: частые ошибки новичков и как их избежать

Установка Drupal 11.x обычно занимает от получаса, если на хостинге уже есть подходящая версия PHP, база данных и доступ к Composer. Чаще всего новичок получает не готовый сайт, а страницу с ошибкой: проект распакован не в ту папку, веб-сервер смотрит не в тот каталог или PHP не хватает расширения. Ниже — последовательность установки и проверки, которая помогает найти причину до того, как вы начнёте менять настройки наугад.

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

Инструкция рассчитана на Drupal 11.x. Для него нужны совместимые версии PHP, базы данных и расширений; требования могут меняться между минорными и патч-релизами. Перед началом сверьте их с официальной страницей Drupal 11 requirements. На сервере также понадобятся Composer и доступ к созданию базы данных.

• Доступ к панели хостинга или серверу, чтобы создать базу данных и пользователя.
• Composer версии, совместимой с Drupal 11, и PHP из списка официальных требований.
• Данные базы: имя, пользователь, пароль и адрес сервера базы данных.
• Домен или тестовый адрес, который можно направить на каталог сайта.
• Возможность настроить корневой каталог сайта и разрешения на файлы.

Корень сайта — папка, содержимое которой веб-сервер отдаёт посетителям. В проекте, созданном через Composer, это обычно web, а не папка проекта целиком. Если направить домен выше, посетители потенциально увидят служебные файлы проекта.

Установка через Composer

Composer загружает Drupal и его зависимости, а также создаёт структуру проекта. Команду запускайте в каталоге, где хотите разместить проект; my_site замените на имя своей папки.

1. Проверьте версии. Выполните в терминале php -v и composer --version. Сверьте PHP с требованиями выбранного релиза Drupal 11.x. Проверка успешна, если команды выводят версии, а PHP подходит по официальной таблице.
2. Создайте проект. Выполните composer create-project drupal/recommended-project:^11.0 my_site. Команда устанавливает ветку Drupal 11.x, а Composer выбирает доступный совместимый релиз. Убедитесь, что команда завершилась без сообщения об ошибке и внутри my_site появился каталог web.
3. Настройте корневой каталог домена. Укажите для сайта my_site/web, следуя инструкции хостинга или веб-сервера. Не меняйте корневую папку наугад, если используете общий хостинг: уточните настройку у провайдера. Проверка — домен открывает страницу Drupal, а не список файлов.
4. Создайте базу данных. В панели хостинга создайте базу и отдельного пользователя с правами на неё. Запишите имя базы, пользователя, пароль и адрес сервера. Проверка — эти данные позволяют подключиться к базе средствами панели или инструмента хостинга.
5. Запустите мастер установки. Откройте домен в браузере, выберите язык и профиль установки, затем укажите данные базы. Заполните имя сайта и учётную запись администратора. Проверка — мастер завершился, и вы можете войти в административную часть.
6. Проверьте сайт после установки. Откройте главную страницу и административную часть, затем проверьте статус сайта в интерфейсе. Убедитесь, что сайт работает по HTTPS и не показывает предупреждение о небезопасном соединении. Проверка — страницы открываются без ошибок, а в отчёте о состоянии нет критичных проблем.

Частые ошибки новичков

Composer запускается не той версией PHP

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

Домен смотрит не в каталог web

Признак ошибки — вместо сайта открывается список файлов, сообщение о запрете доступа или пустая страница. Проверьте корневой каталог домена: для структуры, созданной командой выше, это my_site/web. Не переносите файлы вручную, пока не выяснили, куда именно смотрит веб-сервер: так легко создать две копии сайта и редактировать не ту.

Не хватает PHP-расширения

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

Неправильно указаны данные базы

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

Права на файлы изменены слишком широко

Ошибка записи может появиться, если Drupal не может создать или изменить нужный файл. Не решайте её, открывая права на запись для всех пользователей. Уточните, от имени какого пользователя работает веб-сервер, и настройте права по инструкции хостинга и документации Drupal. Не оставляйте установочные файлы и каталоги доступными для записи без необходимости.

Если Drupal не открывается, сначала проверьте связку «версия PHP — корневой каталог — подключение к базе». Это быстрее и безопаснее, чем переустанавливать CMS после каждой ошибки.

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

• Домен направлен именно на каталог web.
• Версия PHP сайта соответствует требованиям установленной ветки Drupal.
• В панели хостинга включены необходимые расширения PHP.
• Данные базы указаны без опечаток, у пользователя есть нужные права.
• Административная учётная запись защищена надёжным уникальным паролем.
• Сайт открывается по HTTPS, а Drupal не сообщает о критических проблемах в статусе.

Инвалидация кеша и настройка резервного копирования — отдельные задачи; здесь рассматриваем только установку и первичную проверку.

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

После входа в Drupal настройте резервное копирование и проверьте, что можете восстановить сайт из копии. Затем обновите ядро и модули по документации Drupal, сначала на тестовой копии, если сайт уже принимает посетителей. В продакшене следите за отчётом о состоянии сайта, журналами ошибок веб-сервера и сроком действия HTTPS-сертификата.

Если установка не проходит, запишите точный текст ошибки, версию PHP для сайта и командной строки, версию Composer и путь к корневому каталогу домена. Эти данные дадут хостингу или специалисту больше информации, чем сообщение «Drupal не работает».