PdoTools представляет собой мощный набор сниппетов и библиотеку для MODX Revolution, которая значительно ускоряет работу сайта и упрощает повседневную разработку. Этот компонент был создан как альтернатива стандартным инструментам модекса и сегодня считается обязательным дополнением для любого профессионального проекта на MODX Revo.
Главная особенность PdoTools заключается в использовании прямых PDO-запросов вместо полной загрузки объектов xPDO, что экономит оперативную память и многократно повышает скорость обработки данных. Переход с getResources на pdoResources может сократить время загрузки страницы с 1,1 секунды до 0,76 секунды без каких-либо дополнительных оптимизаций.
Основные возможности компонента
PdoTools обладает уникальным функционалом, который выделяет его среди других дополнений для MODX:
- Построение запросов на
xPDOс выборкой через чистыйPDOдля максимальной производительности. - Предварительная обработка простых плейсхолдеров в чанках, оставляя парсеру модекса только сложные конструкции.
- Подробное логирование каждой операции с отметками времени для быстрого выявления узких мест.
- Возможность создания выборок из любых таблиц базы данных с произвольными условиями и JOIN-запросами.
- Полная совместимость с getPage для постраничного отображения результатов.
- Встроенный шаблонизатор Fenom начиная с версии 2.0, что открывает новые горизонты в разработке.
- Поддержка файловых элементов для удобного хранения чанков и сниппетов вне базы данных.
Важное требование — компонент работает только с PHP версии 7.2 и выше, поэтому перед установкой убедитесь в соответствии вашего хостинга этим требованиям.
Сниппеты в составе PdoTools
Пакет pdoTools включает полный набор инструментов для решения большинства задач веб-разработки на MODX Revolution.
pdoResources — основной сниппет для вывода списков ресурсов, являющийся полноценной заменой getResources. Он поддерживает практически все параметры оригинала, но работает в разы быстрее благодаря оптимизированной обработке данных. Переход на pdoResources в большинстве случаев требует лишь замены префикса get на pdo в вызове сниппета.
pdoMenu — генерирует навигационное меню сайта любой сложности. Сниппет позволяет создавать многоуровневые меню с поддержкой активных классов, скрытых пунктов и гибкой настройкой отображения.
pdoPage — улучшенная альтернатива getPage для создания постраничной навигации. Генерирует корректную пагинацию и предотвращает попытки пользователей подставить некорректные значения в параметры page и limit, что повышает безопасность сайта.
pdoCrumbs — быстрая генерация навигационных хлебных крошек, которая успешно заменяет компонент BreadCrumb. Сниппет автоматически определяет путь от главной страницы до текущего ресурса и формирует правильную структурированную навигацию.
pdoUsers — специализированный инструмент для выборки и отображения пользователей сайта. Поддерживает фильтрацию по группам и ролям, что делает его незаменимым при создании каталогов пользователей или списков авторов.
pdoSitemap — создает XML-карту сайта для поисковых систем. Сниппет автоматически собирает все опубликованные ресурсы и формирует корректный sitemap.xml согласно стандартам Google и Яндекс.
pdoNeighbors — выводит информацию о соседних документах: следующем, предыдущем и родительском ресурсе. Особенно удобен для организации навигации по новостным материалам или статьям блога.
pdoField — универсальный сниппет для получения любого поля ресурса, включая TV-параметры. Может выводить данные как текущего документа, так и его родителей, заменяя сразу несколько стандартных решений вроде getResourcesField и UltimateParent.
pdoTitle — автоматически генерирует тег <title> страницы с учетом иерархии ресурсов, пагинации и GET-параметров. Формирует SEO-дружественные заголовки, включая хлебные крошки родительских разделов, номера страниц при пагинации и поисковые запросы. Избавляет от дублирующихся title на страницах с постраничной навигацией и может использоваться также для генерации мета-описаний.
pdoArchive — создает архив документов с автоматической разбивкой по годам, месяцам и дням. Группирует ресурсы по датам создания, публикации или редактирования, формируя структурированный архив с подсчетом количества материалов в каждом периоде. Незаменим для создания временных архивов блогов, новостных разделов, статей и любого другого датированного контента.
Все перечисленные сниппеты pdoTools используют единый набор общих параметров для работы с базой данных, шаблонами и выводом результатов.
Установка и начало работы
Установка PdoTools выполняется стандартным способом через менеджер пакетов MODX. Откройте раздел «Управление пакетами», найдите pdoTools в списке доступных дополнений и нажмите кнопку установки. Весь процесс занимает не более минуты и не требует дополнительных настроек для базового использования.
После установки все сниппеты сразу готовы к работе и могут использоваться в шаблонах, чанках или контенте ресурсов. Для начала работы достаточно заменить стандартные вызовы сниппетов MODX на их аналоги из pdoTools — в большинстве случаев это работает без каких-либо доработок.
Настройка файловых элементов
PdoTools поддерживает работу с файловыми элементами, что позволяет хранить чанки и сниппеты в виде обычных файлов вне базы данных. Это особенно удобно при работе с системами контроля версий типа Git, так как все изменения автоматически отслеживаются.
По умолчанию элементы загружаются из директории, указанной в системной настройке pdotools_elements_path. Стандартное значение — {core_path}elements/, но его можно изменить на любое удобное, например template/tpl/ для хранения всех шаблонных файлов в одном месте.
Для активации файловых элементов создайте нужную директорию на сервере и измените соответствующую системную настройку в административной панели модекса. После этого вы сможете обращаться к чанкам через специальный синтаксис, указывая путь к файлу вместо имени чанка из базы.
Работа с шаблонизатором Fenom
Начиная со второй версии, pdoTools включает встроенный шаблонизатор Fenom, который предоставляет расширенные возможности для работы с шаблонами. Fenom позволяет использовать условия, циклы, фильтры и другие конструкции прямо в чанках, что делает код более читаемым и поддерживаемым.
Для активации Fenom достаточно указать специальный префикс в параметрах сниппета или настроить его как шаблонизатор по умолчанию в системных настройках. После этого вы получаете доступ ко всему функционалу Фенома, включая собственные модификаторы, функции и блоки.
Архитектура классов
Понимание внутренней кухни поможет вам писать свои кастомные сниппеты эффективнее. Ядро реализует четкое разделение ответственности:
// Базовый функционал: работа с чанками, кеширование, Fenom
$pdoTools = $modx->getService('pdoTools');
// Работа с базой данных: построение запросов, JOIN, выборки
$pdoFetch = $modx->getService('pdoFetch');
// Парсер: обработка шаблонов (если включен в настройках)
$pdoParser = $modx->getService('pdoParser');Важно:
pdoFetchнаследуетpdoTools. Это значит, что если вам нужно выбрать данные и тут же их оформить в чанки, вам достаточно подключить только$pdoFetch.
Преимущества перед стандартными решениями
Сравнение PdoTools со стандартными сниппетами MODX показывает существенную разницу в производительности и удобстве использования. Основное преимущество заключается в оптимизированной работе с базой данных — вместо создания полноценных объектов xPDO компонент использует легковесные PDO-запросы, которые потребляют минимум ресурсов сервера.
Предварительная обработка плейсхолдеров также существенно ускоряет работу — простые подстановки значений выполняются на уровне библиотеки pdoTools, а парсер модекса обрабатывает только сложные конструкции с модификаторами и вложенными вызовами. Это особенно заметно на страницах с большим количеством выводимых элементов.
Встроенное логирование помогает быстро находить узкие места в работе сайта. Каждая операция фиксируется с отметкой времени выполнения, что позволяет точно определить, какой именно элемент или запрос замедляет загрузку страницы.
Использование в собственных разработках
PdoTools изначально создавался как библиотека для использования в других компонентах, и этот подход успешно применяется во многих популярных дополнениях, таких как Tickets. Вы также можете использовать pdoTools в своих разработках для повышения производительности и унификации кода.
Для инициализации класса pdoTools в собственном сниппете используется стандартный код, который проверяет наличие компонента и загружает его с правильными параметрами. Этот способ применяется во всех встроенных сниппетах пакета, поэтому вы можете использовать его как эталон для собственных разработок.
Метод setConfig() позволяет настроить параметры работы библиотеки под конкретные задачи, включая указание классов для работы, подключение моделей сторонних компонентов и настройку логирования. Это дает возможность создавать гибкие решения, которые легко адаптируются под разные проекты.
Совместимость и миграция
Переход на pdoTools с стандартных сниппетов MODX Revolution обычно проходит безболезненно и занимает минимум времени. В большинстве случаев достаточно просто изменить имя вызываемого сниппета с get-префикса на pdo-префикс, оставив все параметры без изменений.
Совместимость с getPage обеспечивает возможность использования постраничной навигации без каких-либо доработок — pdoPage работает по тем же принципам, но генерирует более корректную и безопасную пагинацию. Это особенно важно для больших каталогов и архивов новостей.
Все параметры стандартных сниппетов поддерживаются в их pdo-аналогах, что гарантирует обратную совместимость и плавную миграцию существующих проектов. При этом вы получаете доступ к дополнительным возможностям, которых нет в оригинальных решениях.
Отладка и оптимизация
Одна из сильных сторон PdoTools — развитая система отладки и профилирования. Каждый сниппет может вести подробный журнал своей работы с точными отметками времени выполнения каждой операции, что помогает быстро находить и устранять проблемы производительности.
Для активации режима отладки используйте параметр &showLog в вызове сниппета — после этого в конце страницы появится детальная информация о работе компонента. В логе отображаются все выполненные запросы к базе данных, время их выполнения, количество обработанных ресурсов и другая полезная информация.
Анализ логов позволяет понять, какие именно операции занимают больше всего времени — выборка данных, обработка чанков или дополнительные запросы к ТВ-параметрам. На основе этих данных можно оптимизировать параметры вызова сниппета, упростить структуру чанков или добавить кеширование для повышения производительности.
