> For the complete documentation index, see [llms.txt](https://docs.johncms.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.johncms.com/10.0/konsol/planirovshchik-zadach-schedule.md).

# Планировщик задач (schedule)

Для периодических задач в JohnCMS используется встроенный планировщик:

* `schedule:list` — посмотреть список зарегистрированных задач
* `schedule:run` — выполнить задачи, которые должны сработать в текущую минуту

## Быстрый старт

### Показать задачи

```bash
php system/bin/console schedule:list
```

### Выполнить due-задачи

```bash
php system/bin/console schedule:run --no-interaction
```

## Как зарегистрировать задачу

Задачи описываются атрибутом `AsScheduledTask` прямо на классе консольной команды:

```php
#[AsCommand(name: 'sitemap:generate', description: 'Generate sitemap')]
#[AsScheduledTask(expression: '0 3 * * *', withoutOverlapping: true)]
final class SitemapGenerateCommand extends Command
{
    // ...
}
```

Поддерживаемые параметры:

* `expression` — cron-выражение (обязательно)
* `timezone` — таймзона для вычисления расписания
* `arguments` — аргументы/опции, передаваемые в команду при запуске планировщиком
* `withoutOverlapping` — запрет параллельного запуска одной и той же задачи
* `description` — описание задачи для вывода в `schedule:list`

## withoutOverlapping

При `withoutOverlapping: true` используется file-lock. Lock-файлы создаются в:

```
data/cache/schedule
```

Это защищает от повторного запуска одной задачи, если предыдущий запуск еще не завершился.

## Запуск по cron

Планировщик рассчитан на запуск раз в минуту любым внешним cron-механизмом (системный cron, scheduler панели хостинга, контейнерный scheduler и т.д.).

Рекомендуемая команда:

```
php /app/system/bin/console schedule:run --no-interaction
```

`/app/system/bin/console` — это пример пути для docker-окружения. В вашем cron нужно указать корректный абсолютный путь к файлу `system/bin/console` для вашего размещения проекта (с учетом document root/рабочей директории на сервере).

## Работает ли cron

Панель управления следит за планировщиком сама. Каждый запуск `schedule:run` записывает время в файл `data/schedule/last-run` — до выполнения задач, так что зависшая задача не выглядит как остановленный cron. Файл лежит вне `data/cache`: очистка кэша его не трогает.

На главной панели, в блоке «Система», видно состояние планировщика и время последнего запуска. Если запусков не было больше 10 минут, там написано «Остановлен», а если не было вовсе — «Не запускался»; в обоих случаях в блоке «Требует внимания» появляется красная строка, а в блоке «Система» — готовая строка для crontab с путём вашего сайта. Блок и строку видят те, кто управляет настройками сайта.

Если cron настроен, а панель пишет, что планировщик не запускался:

* проверьте, что задача действительно выполняется — например, запустите команду из crontab вручную под тем же пользователем;
* проверьте, что этот пользователь может писать в `data/schedule/` — без этого время запуска не сохранится, хотя задачи выполняются.

## Типовые cron-выражения

* Каждую минуту: `* * * * *`
* Каждый час (в начале часа): `0 * * * *`
* Каждый день в 03:00: `0 3 * * *`

## Частые проблемы

* Неверное cron-выражение — задача пропускается, ошибка уходит в лог.
* Команда не найдена — проверьте `#[AsCommand(name: ...)]`.
* Задача постоянно пропускается с overlap — проверьте, не висит ли старый процесс.
* Панель пишет, что планировщик остановлен — см. «Работает ли cron» выше.

## См. также

* [Консольные команды](https://docs.johncms.com/10.0/konsol/konsolnye-komandy.md)
* [Проблемы и их решение](https://docs.johncms.com/10.0/obshie-svedeniya/problemy-i-ikh-reshenie.md)
