Расположение файлов

Знание структуры каталогов, создаваемой при стандартной установке Drupal, позволит усвоить несколько важных правил. В частности, вы будете знать, где должны размещаться загруженные модули и темы и как использовать различные профили инсталляции Drupal. Стандартная структура каталогов Drupal показана на рис. 1.4.

Ниже приведены пояснения относительно каждого элемента этой структуры.

• Папка includes содержит библиотеки общих функций, которые использует Drupal.


• Папка misc хранит сценарии JavaScript и различные пиктограммы и изображения, входящие в дистрибутив Drupal.


• Папка modules содержит модули ядра, причем каждый модуль хранится в отдельной папке. Лучше ничего не изменять в этой папке (и в любой другой, кроме profiles и sites). Дополнительные модули должны добавляться в каталог sites.


• Папка profiles содержит различные профили инсталляции для сайта. Если в этом подкаталоге имеются другие профили, помимо профиля по умолчанию, при первоначальной установке сайта Drupal будет появляться вопрос, какой именно профиль вы хотите использовать. Основное назначение профиля инсталляции — автоматическое включение доступа к определенным модулям ядра и сторонним модулям. Примером может служить профиль электронной торговли, который автоматически настраивает Drupal как платформу для Интернет-магазина.


• Папка scripts содержит сценарии, используемые для проверки синтаксиса, очистки кода, запуска Drupal из командной строки, обработки особых случаев с помощью cron и запуска тестовых наборов (только в Drupal 7). Они не применяются при выполнении запросов к Drupal, а являются командными сценариями, написанными на языке командной оболочки и Perl.


• Каталог sites (рис. 1.5) содержит изменения в Drupal в виде параметров, модулей и тем. При добавлении в Drupal модулей из хранилища дополнительных модулей или в случае создания собственного модуля они помещаются в подкаталог sites/all/modules. Благодаря этому все модификации Drupal хранятся в единственной папке. В каталоге sites должен быть подкаталог с именем default, содержащий файл стандартной конфигурации сайта Drupal — default.settings.php. Инсталлятор Drupal модифицирует эти исходные параметры на основе предоставленной вами информации и запишет файл settings.php для вашего сайта. Обычно стандартный каталог копируется и переименовывается в соответствии с URL сайта лицом, выполняющим развертывание сайта, поэтому ваш файл настроек может иметь имя вроде sites/www.example.com/settings.php.


• Папка sites/default/files создается при базовой инсталляции Drupal по умолчанию. Она необходима для хранения любых файлов, которые загружаются на сайт и впоследствии обслуживаются. Папка создается, например, при применении особого логотипа, разрешении использования посетителями “аватаров” или загрузке других медиафайлов, связанных с новым сайтом. Для этого подкаталога требуются права на чтение и запись со стороны сервера, на котором выполняется Drupal. Инсталлятор Drupal создаст (если сможет) этот подкаталог, и проверит, заданы ли необходимые права доступа. Кроме папки sites/default/files может быть создан каталог sites/default/private для хранения конфиденциальных файлов, которые не следует разрешать просматривать посетителям сайта без надлежащих полномочий. Для создания этого каталога нужно выбрать пункт меню Configuration > File System (Конфигурация > Файловая система) и ввести в текстовом поле Private file system path (Путь в приватной файловой системе) имя каталога, где должны храниться конфиденциальные файлы.


• Папка themes содержит механизмы шаблонов и стандартные темы для Drupal. Дополнительные темы — загруженные или созданные самостоятельно — не должны попадать сюда; они помещаются в каталог sites/all/themes.


• cron.php используется для выполнения регулярных задач, таких как сжатие таблиц баз данных и сбор статистики.


• index.php — главная точка входа для обслуживания запросов.


• install.php — главная точка входа для инсталлятора Drupal.


• update.php обновляет схему базы данных после модернизации до новой версии Drupal.


• xmlrpc.php принимает запросы XML-RPC и может быть безопасно удален из развертываний, где не нужно принимать такие запросы.


• robots.txt — реализация по умолчанию стандарта исключения роботов.


• authorize.php — административный сценарий для выполнения авторизованных операций обработки файлов — например, загрузки и установки новой темы или модуля с сайта Drupal.org.

Другие файлы, которые здесь не перечислены — это файлы документации.