Кастомные сниппеты MODX: быстрые PHP-решения с pdoTools

Типовой сниппет — это копипаста без оптимизации

Представьте: ваш каталог товаров на MODX загружается 5 секунд, а каждый клик по категории — вечность. Причина — неоптимизированные сниппеты, которые делают десятки запросов к базе. Типовая ситуация: разработчик скопировал первый попавшийся код, не подумав о кэшировании. Результат — N+1 запросов, падение производительности и негативный пользовательский опыт. Как это исправить? Использовать правильные паттерны.

Разработка сниппета MODX часто начинается с копирования первого попавшегося примера из документации. Результат — N+1 запросов, отсутствие кэширования и уязвимости, которые превращают простую задачу в тормоз для всего сайта. Мы используем проверенные архитектурные паттерны: единый запрос, кэширование и строгую типизацию параметров. Более 5 лет опыта и более 50 проектов на MODX позволяют нам создавать сниппеты, которые выдерживают тысячи запросов без потери производительности.

Как избежать N+1 запросов в MODX?

Проблема N+1 возникает, когда вы получаете коллекцию ресурсов, а затем для каждого подгружаете TV-значения через getTVValue в цикле. При 100 ресурсах это 101 SQL-запрос. Решение — использовать JOIN или pdoFetch. Нативный MODX API позволяет написать JOIN вручную, но pdoTools делает это автоматически и быстрее. Подробнее о проблеме читайте в статье N+1 query problem.\n

Почему важно кэшировать сниппеты?

Кэширование снижает нагрузку на базу данных и ускоряет страницу. Без кэша каждый вызов сниппета — это SQL-запрос. На проекте с каталогом 5000 товаров исходный сниппет выполнялся 4 секунды. После добавления кэширования время упало до 0.2 секунды для последующих запросов. Кэш нужно инвалидировать при изменении данных или устанавливать время жизни, например, 30 минут.

Структура сниппета с безопасной выборкой

Нативный запрос с JOIN

<?php
// Сниппет ProductList
// Вызов: [[!ProductList? &category=`5` &limit=`12` &sort=`price`]]
// Получить параметры (с default значениями)
$categoryId = (int)($scriptProperties['category'] ?? 0);
$limit = (int)($scriptProperties['limit'] ?? 10);
$offset = (int)($scriptProperties['offset'] ?? 0);
$sortField = $scriptProperties['sort'] ?? 'menuindex';
$sortDir = $scriptProperties['sortdir'] ?? 'ASC';
$tpl = $scriptProperties['tpl'] ?? 'productCard';

// Запрос к ресурсам через MODX API
$c = $modx->newQuery('modResource');
$c->where([
    'parent' => $categoryId,
    'published' => 1,
    'deleted' => 0,
    'class_key' => 'modDocument',
]);

// Получить TV значения через Join
$c->innerJoin('modTemplateVarResource', 'TVPrice', [
    'TVPrice.tmplvarid' => $modx->getObject('modTemplateVar', ['name' => 'price'])->id,
    'TVPrice.contentid = modResource.id',
]);
$c->select('modResource.*, TVPrice.value AS price');
$c->sortby($sortField, $sortDir);
$c->limit($limit, $offset);
$resources = $modx->getCollection('modResource', $c);

if (empty($resources)) return '';

$output = '';
foreach ($resources as $resource) {
    $data = array_merge($resource->toArray(), [
        'price' => $resource->get('price'),
        'link' => $modx->makeUrl($resource->id, '', '', 'full'),
        'image' => $resource->getTVValue('product_image'),
    ]);
    // Чанк для вывода карточки
    $output .= $modx->getChunk($tpl, $data);
}

return $output;

Сниппет с pdoTools

<?php // Сниппет ProductSearch с pdoTools
if (!$modx->loadClass('pdoFetch', MODX_CORE_PATH . 'components/pdotools/model/pdotools/', false, true)) {
    return 'pdoTools не установлен';
}
$pdoFetch = new pdoFetch($modx, $scriptProperties);
$pdoFetch->addWhere([
    'modResource.parent' => (int)($scriptProperties['category'] ?? 0),
    'modResource.published' => 1,
]);
// TV join
$pdoFetch->addTVs('price,product_image,short_description');
$result = $pdoFetch->run();
return $result;

Кэширование результатов

<?php
// Кэшировать результат на 30 минут
$cacheKey = 'products_' . md5(json_encode($scriptProperties));
$cacheOptions = [
    xPDO::OPT_CACHE_KEY => 'default',
    xPDO::OPT_CACHE_EXPIRES => 1800
];
$cached = $modx->cacheManager->get($cacheKey, $cacheOptions);
if ($cached !== null) return $cached;
// ... запрос ...
$output = generateOutput($resources);
$modx->cacheManager->set($cacheKey, $output, 1800, $cacheOptions);
return $output;

Интеграция с внешним API

<?php // Сниппет WeatherWidget — погода из OpenWeatherMap
$city = $scriptProperties['city'] ?? 'Moscow';
$apiKey = $modx->getOption('weather_api_key');
$tpl = $scriptProperties['tpl'] ?? 'weatherWidget';
$cacheKey = 'weather_' . $city;
$cached = $modx->cacheManager->get($cacheKey, [xPDO::OPT_CACHE_EXPIRES => 1800]);
if ($cached !== null) {
    return $modx->getChunk($tpl, $cached);
}
$url = "https://api.openweathermap.org/data/2.5/weather?q={$city}&appid={$apiKey}&units=metric&lang=ru";
$response = file_get_contents($url);
if (!$response) return '';
$data = json_decode($response, true);
if (!$data || $data['cod'] !== 200) return '';
$weather = [
    'city' => $data['name'],
    'temp' => round($data['main']['temp']),
    'feels_like' => round($data['main']['feels_like']),
    'description' => $data['weather'][0]['description'],
    'icon' => "https://openweathermap.org/img/wn/{$data['weather'][0]['icon']}@2x.png",
    'humidity' => $data['main']['humidity'],
];
$modx->cacheManager->set($cacheKey, $weather, 1800);
return $modx->getChunk($tpl, $weather);

Какие параметры передавать в сниппет?

[[!ProductList? &category=`[[*id]]` &limit=`12` &tpl=`productCardTpl` &sort=`price` &sortdir=`ASC` ]] 

! перед именем — некэшированный вызов (динамический контент). Без ! — кэшированный (статический блок, одинаковый для всех).

Таблица сравнения подходов

Таблица типовых параметров сниппета

Типичные ошибки при разработке сниппетов

• N+1 запросы: получение TV через getTVValue в цикле. Решение — JOIN или pdoFetch.
• Отсутствие фильтрации входных данных: параметры без приведения типа (категория — строка, а не int).
• Игнорирование кэширования: каждый вызов сниппета грузит БД, даже если данные не изменились.
• Жёстко зашитые ID ресурсов: используйте плейсхолдеры и параметры.

Что входит в работу

• Исходный код сниппета с комментариями.
• Документация: описание параметров, примеры вызова, описание логики.
• Настройка кэширования: подбор времени жизни и ключа.
• Инструкция по установке: добавление сниппета, создание чанков, тестирование.
• Гарантия поддержки: если возникнут вопросы, мы поможем в течение месяца после сдачи.

Процесс разработки сниппета под ключ

1. Аналитика: изучаем ТЗ, какие данные выводить, откуда брать, условия фильтрации.
2. Проектирование: определяем структуру запроса, выбираем метод (нативный или pdoTools), продумываем кэширование.
3. Реализация: пишем PHP-код сниппета и чанки шаблонов.
4. Тестирование: проверяем на крайних значениях (пустые категории, 0 записей), замеряем время выполнения.
5. Деплой: размещаем на боевом сервере, настраиваем кэш, даём документацию по вызову.

Сроки и стоимость

Сроки: от 0,5 дня для простого сниппета до 5 дней для сложного с интеграцией API. Точную оценку даём после знакомства с проектом. Стоимость рассчитывается индивидуально.

Свяжитесь с нами для обсуждения вашего проекта. Закажите разработку сниппета прямо сейчас — получите быстрый и безопасный код. Опыт разработки под MODX — более 5 лет. Пишите, и мы оценим задачу и предложим оптимальное решение.