# Планировщик задач (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-выражения

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

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

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

## См. также

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.johncms.com/konsol/planirovshchik-zadach-schedule.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.