用overtrue/chinese-calendar库可准确判断节假日与调休工作日，需缓存结果、复用实例、避免仅依赖date('N')，并注意地区差异和规则更新。
如何用 Workday 类判断日期是否为节假日
ThinkPHP5.1 自身不提供节假日识别能力，workday 也不是框架内置类——得自己补。官方日历、节假日数据全靠外部维护，最稳妥的做法是引入轻量级第三方库（如 overtrue/chinese-calendar），它把国务院每年发布的调休安排都打包进来了，支持农历、节气、法定假日、调休补班等。
安装后，在需要的地方引入：
composer require overtrue/chinese-calendar
然后这样用：
$calendar = new \Overtrue\ChineseCalendar\Calendar();
$isHoliday = $calendar->isHoliday('2024-10-01'); // true
$isWorkday = $calendar->isWorkday('2024-10-08'); // true（调休上班）
注意：它默认只认国家法定节假日+调休安排，不包含企业自定义假期（比如年假、福利假），这部分得你自己叠加逻辑。
立即学习“PHP免费学习笔记（深入）”；
foreach 循环中跳过节假日的写法
别在循环里反复 new 对象，先实例化一次，再复用。常见错误是每次迭代都初始化 Calendar，性能差还可能触发 autoload 异常。
- 把
$calendar = new \Overtrue\ChineseCalendar\Calendar();放在循环外 - 用
date('Y-m-d', strtotime('+1 day', $timestamp))生成下一天，别用DateTime::modify()链式调用——容易因时区或夏令时出错 - 跳过逻辑写成
if ($calendar->isHoliday($date) || !$calendar->isWorkday($date)) continue;，注意：法定假日和非工作日（如周日）要同时排除
示例片段：
$start = strtotime('2024-09-25');
$end = strtotime('2024-10-10');
$calendar = new \Overtrue\ChineseCalendar\Calendar();
while ($start <= $end) {
$date = date('Y-m-d', $start);
if (!$calendar->isWorkday($date)) {
$start = strtotime('+1 day', $start);
continue;
}
echo $date . "\n"; // 只输出真正的工作日
$start = strtotime('+1 day', $start);
}
为什么不能只用 date('N') 判断周末
date('N') 返回 1~7（周一到周日），但节假日不是简单“周末过滤”能解决的。国庆连休 7 天里有调休上班日（比如 10 月 8 日星期一要上班），而春节前某个周六可能放假——光靠星期几会漏判或误判。
更麻烦的是，不同地区可能有地方性假日（如少数民族节日），overtrue/chinese-calendar 默认只支持全国统一安排；如果业务涉及新疆、西藏等地，得自己扩展 isHoliday() 方法，加白名单数组或查本地数据库。
另外，这个库的数据更新依赖作者发版，每年初要检查是否已同步最新国务院通知，否则 2025 年元旦安排可能没生效。
缓存节假日结果避免重复计算
一个日期查一次节假日就够了，尤其在生成月度排班、批量导出时，同一日期可能被查几十次。直接用 ThinkPHP 的 Cache::tag() 标记 + 过期时间：
$key = 'holiday_' . $date;
$result = Cache::get($key);
if ($result === null) {
$result = $calendar->isWorkday($date);
Cache::tag('holiday')->set($key, $result, 3600); // 缓存 1 小时
}
注意：别用永久缓存，因为节假日规则每年变，缓存时间设太长会导致旧规则残留；也别用文件缓存，高并发下容易锁死，推荐 Redis。
实际项目里，很多人忽略「调休上班日」和「普通工作日」的区别，比如打卡系统里要允许员工在调休日打卡但不计加班——这种业务差异必须在跳过逻辑之前就区分清楚，而不是靠日期是否节假日一刀切。
