Attention
Mautic 3 引入了定时任务的新路径 `bin/console` - 如果您使用的是旧版 Mautic 2.x 系列，应将其替换为旧版本 `app/console`
Mautic 需要一些 `cron jobs` 来处理维护任务，例如更新联系人或营销活动、执行营销活动操作、发送邮件等。 您必须手动将所需的定时任务添加到服务器。 大多数网络主机都提供通过 SSH、cPanel 或其他自定义面板添加定时任务的方式。 如果您不确定如何设置定时任务，请查阅主机的文档或联系技术支持。
如果您不熟悉 Linux 或定时任务，Apache 基金会提供了 `an excellent guide` ，建议您通过各技术支持渠道提问前先阅读。
设置定时任务时，您需要选择运行频率。许多共享主机倾向于每 15 或 30 分钟运行一次脚本，甚至可能为满足这些限制而覆盖预定时间。请查阅主机文档了解是否存在此类限制。
**强烈建议将以下必需任务错开执行时间，避免在同一分钟运行。**
例如：
- 0,15,30,45 <— mautic:segments:update
- 5,20,35,50 <— mautic:campaigns:update
- 10,25,40,55 <— mautic:campaigns:trigger
## 必需任务
Mautic 需要按以下方式定期运行一些强制性的定时任务：
### 分组定时任务
**保持分组数据最新：**
``` php
php /path/to/mautic/bin/console mautic:segments:update
```
默认情况下，脚本每批处理 300 个联系人。如果对服务器资源而言数量过多，请使用 `--batch-limit=X` 选项，将 X 替换为每批处理的联系人数量。
您还可以使用 `--max-contacts` 限制每次脚本执行处理的联系人数量，以进一步控制资源使用。
### 营销活动定时任务
**保持营销活动与适用的联系人同步更新：**
``` php
php /path/to/mautic/bin/console mautic:campaigns:update
```
默认情况下，脚本每批处理 300 个联系人。如果对服务器资源而言数量过多，请使用 `--batch-limit=X` 选项，将 X 替换为每批处理的联系人数量。
您还可以使用 `--max-contacts` 限制每次脚本执行处理的联系人数量，以进一步控制资源使用。
**执行营销活动事件：**
``` php
php /path/to/mautic/bin/console mautic:campaigns:trigger
```
默认情况下，脚本每批处理 100 个事件。如果对服务器资源而言数量过多，请使用 `--batch-limit=X` 选项，将 X 替换为每批处理的事件数量。
您还可以使用 `--max-events` 限制每次脚本执行处理的事件数量，以进一步控制资源使用。
自 Mautic 5.1 起，Mautic 按从最新到最旧的顺序触发营销活动。这样您就可以优先处理较新的营销活动。
**发送频率规则重新排期的营销活动消息：** 如果系统范围内或针对每个联系人设置了频率规则，标记为\*营销消息\*的消息（例如作为营销活动一部分的邮件）将被保留在消息队列中。要处理此队列并重新排期发送这些消息，请添加此定时任务：
`mautic:messages:send`
> [!NOTE]
> 这些消息仅在系统范围内或针对每个联系人应用频率规则时才会被添加到队列中。
### 自定义字段定时任务
**保持联系人和公司自定义字段更新**
``` php
php /path/to/mautic/bin/console mautic:custom-field:create-column
php /path/to/mautic/bin/console mautic:custom-field:delete-column
```
## 可选任务
根据您的服务器配置，您可以设置用于发送邮件、导入联系人等任务的可选定时任务。可选定时任务如下：
### 处理邮件队列定时任务
如果系统配置将邮件加入队列，则定时任务会处理它们。如果您计划使用定时任务运行 `messenger:consume`，则应至少包含以下参数之一：`--memory-limit`、`--limit`（邮件数量）或 `--time-limit`。这将会启动一个长期运行的进程，如果没有这些参数，进程将持续运行。
``` bash
php /path/to/mautic/bin/console messenger:consume email --time-limit=160
```
### 获取并处理受监控邮件定时任务
如果您使用退信管理，请设置以下命令来获取并处理消息：
``` php
php /path/to/mautic/bin/console mautic:email:fetch
```
### 社交监控定时任务
如果您使用社交监控，请将以下命令添加到您的定时任务配置中：
``` php
php /path/to/mautic/bin/console mautic:social:monitoring
```
### 导入联系人定时任务
要在后台导入特别大量的联系人或者公司，请使用以下命令：
``` php
php /path/to/mautic/bin/console mautic:import
```
此命令的执行时间取决于 CSV 文件中的联系人数量。然而，导入操作成功完成后，Mautic 仪表盘上会出现一条通知。
### 导出联系人定时任务
要导出联系人到 CSV 并通过邮件发送结果，请使用以下命令：
``` bash
php /path/to/mautic/bin/console mautic:contacts:scheduled_export
```
此命令的执行时间取决于 CSV 文件中的联系人数量。然而，导出操作成功完成后，Mautic 会发送一封包含 CSV 下载链接的邮件。
### Webhooks 定时任务
如果 Mautic 配置设置包含 Webhook 批处理，请使用以下命令发送负载：
``` php
php /path/to/mautic/bin/console mautic:webhooks:process
```
自 Mautic 5.1 起，还可以在“范围模式”下运行 Webhooks 定时任务。这允许您指定在单次运行中处理的 Webhook 事件范围。如果您有大量 Webhook 事件需要处理，并且希望避免内存耗尽，这会很有用。
要使用此模式，您可以指定 `--min-id` 和 `--max-id` 选项。例如，要处理 ID 为 5 的 Webhook 的事件，您可以指定只处理该 Webhook 中 ID 在 1000 到 2000 之间的事件，使用以下命令：
``` bash
bin/console mautic:webhooks:process --webhook-id=5 --min-id=1000 --max-id=2000
```