一、定时任务脚本编写

1. 使用 shebang 声明执行器

#!/usr/bin/env php

• 这是 Unix/Linux 系统中脚本文件的标准开头。
• 表示这个脚本使用系统环境变量中的 php 来执行。

---

2. 定义 ThinkPHP 入口路径并加载框架

define('APP_PATH', __DIR__ . '/../../application/');
require __DIR__ . '/../../thinkphp/start.php';

• APP_PATH：定义了项目的入口目录。
• 加载 ThinkPHP 框架，使你可以使用 Db 类、模型等功能。

---

3. 引入 ThinkPHP 的数据库类

use think\Db;

• 方便后续操作数据库。

---

4. 判断是否是周一的方法

function isMonday() {return date('w') == 1;
}

• 使用 date('w') 获取当前星期几：
  • 0 = 周日
  • 1 = 周一 ✅
• 所以这个函数返回 true 表示今天是 周一

---

5. 获取上周的周标识（格式如：2025-W20）

function getLastWeekIdentifier() {$last_week = strtotime("-1 week");$year = date("Y", $last_week);$week = date("W", $last_week);return "{$year}-W{$week}";
}

• strtotime("-1 week")：获取上周同一时间的时间戳
• date("W", ...)：ISO-8601 周数（从 1 开始）
• 返回值示例：2025-W20

---

6. 日志记录函数

function logMessage($message) {$logFile = __DIR__ . "/update_log.txt";file_put_contents($logFile, "【" . date('Y-m-d H:i:s') . "】" . $message . "\n",     FILE_APPEND);
}

• 把每次运行的信息写入日志文件 update_log.txt
• 便于调试和查看执行情况

---

🧱 主逻辑部分（try-catch 包裹）

try {

用 try-catch 包裹整个逻辑，确保出错时能捕获异常并记录日志。

---

7. 判断是否是周一

if (!isMonday()) {logMessage("不是周一，跳过任务");exit("不是周一，跳过任务\n");
}

• 如果不是周一，直接退出程序，不执行更新操作

---

8. 获取上周标识并记录日志

$lastWeek = getLastWeekIdentifier();
logMessage("🔍正在处理上周周标识：{$lastWeek}");

• 获取上周的周标识（如 2025-W20）
• 记录日志方便后续查看

---

9. 查询上周的数据

$records = Db::table('weekly_emitem_apply_setting')
->where('week', $lastWeek)
->select();

• 查询所有 week = '2025-W20' 的记录
• 准备进行字段更新

---

10. 遍历每条记录并处理

foreach ($records as $record) {$id = $record['id'];$employee_num = $record['employee_num'];$item_no = $record['item_no'];$actual_total = $record['actual_total_qty'];$week_apply = $record['week_apply_qty'];

• 提取每条记录的关键字段
• 如员工编号、料号、累计数量、本周申请量等

---

11. 计算新的累计数量

$newTotal = $actual_total + $week_apply;

• 将本周申请量累加到累计数量中

---

12. 获取当前周标识（如：2025-W21）

$currentWeek = date("Y") . "-W" . str_pad((int)date("W"), 2,