Главная / Документация / Полное руководство / Разработчикам / Архитектура diafan.CMS / Как устроен модуль /

Прямое обращение к файлам модуля

Для работы вне структуры сайта описывается файл modules/модуль/модуль.функция.php. Этот файл можно вызвать напрямую так: http://site.ru/модуль/функция/.

Прямое обращение к модулю может понадобится в следствии следующих причинам:

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

Файл modules/модуль/модуль.функция.php подключается в классе инициализации системы. Поэтому основной класс системы доступен через переменную $this.

Через эту переменную можно получить доступ к классам пользователей, кэширования, маршрутизатора и подключения шаблонов, а также к подключениям модулей.

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

Если запрошен адрес http://site.ru/модуль/функция/какие-то_данные/, то данные, переданные в URL будут доступны в модуле в виде: $_GET["rewrite"] = 'какие-то_данные';

Примеры реализации прямого обращения к модулю в diafan.CMS:

modules/captcha/captcha.get.php – http://site.ru/captcha/get/ – генерирует изображение защитного кода;
modules/news/news.rss.php – http://site.ru/news/rss/ – генерирует RSS-ленту новостей;
modules/order/oder.payment.php – http://site.ru/order/payment/ – работа с платежными системами;
modules/useradmin/useradmin.edit.php – http://site.ru/useradmin/edit/ – форма редактирования данных из пользовательской части;
modules/attachments/attachments.get.php – http://site.ru/attachments/get/ – отдает прикрепленный файл.

Не понятно? Уточните