定时任务实战教程：手把手打造企业级项目

在 FastAdmin 中实现定时任务，主要有以下三种主流方式，你可以根据项目的复杂度和服务器环境选择最适合的一种：

1. 原生 Crontab + 控制器(最通用)

这是最基础也最灵活的方式，适合简单的定时逻辑(如每天凌晨备份数据、清理缓存)。

第一步：创建任务控制器

在插件或应用的控制器目录下创建一个专门处理定时任务的控制器(例如 Autotask.php)。为了防止被恶意通过 URL 访问，需要在初始化方法中限制只能从命令行(CLI)执行：php

编辑

1public function _initialize()

2{

3 parent::_initialize();

4 if (!$this->request->isCli()) {

5 $this->error('只允许在终端进行操作!');

6 }

7}

第二步：配置系统定时任务

Linux 环境：使用 crontab -e 命令添加记录，例如每分钟执行一次：

* * * * * /usr/bin/php /你的网站路径/public/index.php /addons/插件名/autotask/index >> /dev/null 2>&1

Windows 环境：建议使用宝塔面板，在“计划任务”中添加一条 Shell 脚本，指向你的 PHP 路径和入口文件。

2. Think-Queue 消息队列(适合高并发/异步)

如果你的定时任务涉及大量数据处理(如批量发送邮件、短信)，或者需要延迟执行，推荐使用队列。

安装与配置：FastAdmin 高版本自带 think-queue，低版本需通过 Composer 安装。在 application/extra/queue.php 中配置驱动(推荐使用 Redis)。

生产与消费：

生产端：在业务逻辑中调用 Queue::push(任务类, 数据, 队列名) 将任务推入队列。

消费端：创建 Job 类，编写 fire 方法处理具体逻辑。

启动监听：在终端运行 php think queue:listen(开发环境)或 nohup php think queue:work --daemon(生产环境守护进程)来持续消费任务。

3. 第三方插件(可视化/免代码)

如果你不想写代码，或者需要更复杂的管理界面，可以在 FastAdmin 插件市场寻找相关插件。

异步任务队列插件：提供可视化的后台界面，支持添加一次性或循环任务，支持 URL 请求和 Redis 队列两种模式，还能查看执行日志和失败重试。

Linux宝塔监控插件：如果你的服务器使用的是宝塔面板，这个插件可以直接托管宝塔的计划任务，让你在 FastAdmin 后台就能统一管理服务器的定时任务。

 避坑指南：

权限问题：定时任务的控制器和方法一定要设置 $noNeedLogin = ['*']，并且不要放在需要鉴权的目录下，否则队列可能无法正确执行。

命名空间冲突：如果在定时任务中调用第三方插件(如支付插件)报错 Class not found，通常是因为命令行环境下命名空间加载顺序与 Web 环境不同，需要手动 require_once 或检查自动加载配置。