镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content

fix(scheduler): revive unscheduled recurring tasks + batch token cleanup (#999) - #1005

Open
Ibochkarev wants to merge 3 commits into
modx-pro:betafrom
Ibochkarev:fix/issue-999-token-cleanup
Open

Ibochkarev wants to merge 3 commits into
modx-pro:betafrom
Ibochkarev:fix/issue-999-token-cleanup

Conversation

@Ibochkarev

@Ibochkarev Ibochkarev commented Nov 9, 2026 •

Copy link
Copy Markdown
Member

Описание

Встроенная уборка ms3_customer_tokens не работала: 1 018 088 строк при TTL в сутки, ms3_cleanup_tokens ни разу не запускалась (0 записей в modx_scheduler_run).

  • Резолвер resolver_07_scheduler: при обновлении recurring-задача без pending sTaskRun (status=SCHEDULED) получает первый запуск +1 minute. Раньше schedule() вызывался только при создании задачи.
  • AuthManager::cleanupExpiredTokens(): батевый DELETE ... WHERE expires_at < ? LIMIT 1000 через PDO в цикле (константная память, индекс idx_expires). Фолбэк на getCollection — только для тестов без PDO.

Тип изменений

  • Исправление бага (non-breaking change)
  • Новая функциональность (non-breaking change)
  • Breaking change (изменение, ломающее обратную совместимость)
  • Рефакторинг (без изменения функциональности)
  • Документация
  • Другое (опишите):

Связанные Issues

Closes #999

Как это было протестировано?

  • php -l по изменённым файлам — без ошибок.
  • vendor/bin/phpunit --testsuite Unit — 818 тестов, без падений.
  • php tests/run-smoke.php — OK smoke tests (142).
  • composer stan — [OK] No errors.
  • Деплой на project.test: qa-stand.sh deploy --auto --fast — пакет установлен, healthcheck зелёный (site/test page/product API/manager auth).
cd core/components/minishop3
composer install
composer ci:php
  • Ручное тестирование (деплой + healthcheck на project.test)
  • Автоматические тесты (composer ci:php / composer test, composer stan / GitHub Actions CI)
  • Тестирование на разных версиях PHP/MODX

Конфигурация тестирования:

  • MiniShop3: beta @ 7d53553 + этот PR
  • MODX: 3.x
  • PHP: 8.2+

Скриншоты (если применимо)

До После

Чеклист

  • Код соответствует стилю проекта
  • Добавлены/обновлены комментарии в сложных местах
  • Изменения не ломают существующую функциональность
  • Лексиконы добавлены на двух языках (ru/en) — тексты не менялись
  • PHPStan проходит без новых ошибок (composer stan / CI job PHPStan)
  • ESLint проходит без ошибок (npm run lint:ci для Vue) — JS не менялся
  • Обновлён CHANGELOG.md (для значимых изменений) — багфикс, запись при релизе

Дополнительные заметки

Вопрос выдачи токена (ленивая выдача) — отдельный issue #1000, здесь не затрагивается.

…nup (modx-pro#999)

a) resolver_07_scheduler: on upgrade, revive recurring tasks that have
no pending sTaskRun (status SCHEDULED). Previously schedule() ran only
on creation, so a task created without a run never started again.

b) AuthManager::cleanupExpiredTokens: batched DELETE ... WHERE
expires_at < ? LIMIT N via PDO (constant memory, idx_expires covered).
Fallback to getCollection loop when no PDO handle (test stubs).
@biz87

biz87 commented Nov 15, 2026

Copy link
Copy Markdown
Member

Возвращаю: половина (a) верна, половина (b) ничего не делает.

Резолвер — вопросов нет

Проверил оба места, где легко промахнуться: поле task у sTaskRun существует (схема Scheduler, table="scheduler_run"), STATUS_SCHEDULED = 0 подтверждён в staskrun.class.php:22. Захардкоженный ноль с комментарием корректен.

Запрос отработал на живых задачах стенда — у ms3_send_notification нашлось 2 запуска, у обеих recurring-задач ноль и pending нет. Логика «нет запланированного запуска — запланировать» верная и лишних запусков у здоровой задачи не создаст: после успешного прогона Scheduler сам ставит новый run со статусом 0, и условие не срабатывает.

Пакетный DELETE не выполняется никогда

getTableName() отдаёт имя в обратных кавычках:

getTableName() → '`modx_ms3_customer_tokens`'
preg_match('/^[A-Za-z0-9_]+$/', $table) → false

Валидатор кавычки не пропускает, условие в if всегда истинно, и метод уходит в deleteExpiredTokensObjects() — в ту самую getCollection()-ветку, ради замены которой PR и писался. OOM на большой таблице остаётся там же, где был.

Проверил оба шлюза на стенде, чтобы не гадать:

шлюз 1: $modx->pdo instanceof PDO = true
шлюз 2: регулярка пропускает имя   = false
=> выполнится ветка: старая getCollection()

То есть дело именно в регулярке, а не в отсутствии PDO.

Обиднее всего, что само имя в SQL подставилось бы без проблем — DELETE FROM \modx_ms3_customer_tokens` WHERE expires_at < ? LIMIT 1000` валиден. Достаточно снять кавычки перед проверкой:

$table = trim((string) $this->modx->getTableName(msCustomerToken::class), '`"[] ');
if ($table === '' || !preg_match('/^[A-Za-z0-9_]+$/', $table)) {
    return $this->deleteExpiredTokensObjects($now, $batchSize);
}
$sql = "DELETE FROM `{$table}` WHERE expires_at < ? LIMIT {$batchSize}";

Нужен тест

На cleanupExpiredTokens() сейчас нет ни одного теста — грепнул по tests/, ни одного упоминания. Поэтому весь прогон зелёный при неработающем коде: smoke 142, PHPUnit 952/3275, PHPStan чисто — и ни одна из этих проверок метод не вызывает.

Достаточно теста, который подставляет настоящее имя таблицы (с кавычками, как его отдаёт xPDO) и проверяет, что выбирается пакетная ветка, а не объектная. Именно он поймал бы эту правку.

Мелочь

prepare() внутри do/while можно вынести наружу — запрос один и тот же, меняется только параметр.

@Ibochkarev
Ibochkarev requested a review from biz87 November 15, 2026 14:11
@Ibochkarev

Copy link
Copy Markdown
Member Author

Исправления по ревью

1. Критический баг: таблица с кавычками

$this->modx->getTableName() возвращает имя таблицы в обратных кавычках (`modx_ms3_customer_tokens`). Регулярка /^[A-Za-z0-9_]+$/ их не пропускала, и код всегда падал в fallback getCollection() — OOM на больших таблицах.

Исправление:

$table = trim((string) $this->modx->getTableName(msCustomerToken::class), '\x60"[] ');

2. Оптимизация: prepare() вне цикла

prepare() вынесен из do/while — запрос один и тот же, меняется только параметр.

3. Тесты

Добавлены интеграционные тесты на cleanupExpiredTokens():

  • testCleanupExpiredTokensUsesBatchedDelete() — проверяет, что пакетная ветка (PDO DELETE) работает корректно
  • testCleanupExpiredTokensRespectsBatchSize() — проверяет работу с batch size

Все тесты проходят:

  • vendor/bin/phpunit --testsuite Integration — OK
  • composer stan — [OK] No errors

Commit: b0f29009 — fix: trim backticks from table name in cleanupExpiredTokens (#999b)
Commit: 4c3fee30 — test: add integration tests for cleanupExpiredTokens and fix stub getTableName

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants