PHP8中判断法定节假日需依赖外部数据源，推荐使用overtrue/chinese-holidays库，支持调休识别、自动更新、Asia/Shanghai时区适配，避免手动实现农历转换。
PHP8 中判断日期是否为法定节假日（含调休）
PHP8 本身不内置节日计算逻辑，date() 或 DateTime 只能处理公历日期，无法识别春节、国庆、调休等规则。真正可行的方式是：用外部节假日数据源 + 本地逻辑匹配。国内最稳定的是「国务院每年发布的节假日安排通知」，但需人工维护；更实用的是接入轻量级开源库或 API。
- 优先推荐使用
overtrue/chinese-holidaysComposer 包（支持 PHP8，数据年份更新及时，含调休标记） - 避免自己写农历转换——
GregorianToJD()和jdtogregorian()在 PHP8 中仍存在精度问题，且春节日期依赖农历闰月规则，手动实现极易出错 - 注意时区：必须用
Asia/Shanghai，否则DateTime('2025-01-29')在 UTC 时区下可能跨日，导致误判为“1月28日”
用 overtrue/chinese-holidays 判断某天是否放假
该库返回数组含 is_offday（是否放假）、name（节日名）、is_adjust（是否调休上班）等字段，直接对应业务需求。
<?php
require 'vendor/autoload.php';
use Overtrue\ChineseHolidays\Holiday;
$date = new DateTime('2025-01-29'); // 春节除夕
$result = Holiday::isHoliday($date);
// 输出示例：
// [
// 'date' => '2025-01-29',
// 'is_offday' => true,
// 'name' => '春节',
// 'is_adjust' => false,
// ]
?>
-
Holiday::isHoliday()接收DateTime对象，不接受字符串，传'2025-01-29'会抛TypeError - 默认只加载当前年和前后一年（共三年），查 2030 年需手动调用
Holiday::loadYear(2030) - 调休日（如 2025 年 2 月 8 日星期六上班）的
is_offday为false，但is_adjust为true，需按需处理
纯 PHP8 实现固定节日（无调休）
如果只要元旦、劳动节、国庆节这类公历固定日期节日，且不关心调休，可手写判断。但注意：国庆节是 10 月 1–7 日，不是单日；清明节是节气，每年公历日期浮动（4 月 4–6 日之间），不能硬编码为 4 月 4 日。
- 元旦：
$date->format('m-d') === '01-01' - 劳动节：
in_array($date->format('m-d'), ['05-01', '05-02', '05-03'])（2025 年放 5 月 1–3 日） - 清明节：需用
date_sunset()类函数？不行。正确做法是调用date('z', ...)计算当年春分后第 15 天，但误差常达 ±1 天 —— 建议仍走overtrue/chinese-holidays - 所有手写逻辑必须配合
setTimezone(new DateTimeZone('Asia/Shanghai'))，否则format('m-d')在服务器时区为 UTC 时会错乱
常见报错与绕过方式
装 overtrue/chinese-holidays 后运行报 Class 'Overtrue\ChineseHolidays\Holiday' not found，大概率是未执行 composer install 或 autoloader 未生效；若用 Swoole 或 RoadRunner，还需确认 composer autoload 是否在 worker 进程中重新加载。
立即学习“PHP免费学习笔记（深入）”；
- 错误信息
DateTime::__construct(): Failed to parse time string：传给构造函数的字符串含非法字符（如中文空格、全角横线），统一用trim($input)+ 正则/^\d{4}-\d{2}-\d{2}$/校验 - 查 2024 年节日返回空数组：检查是否用了
Holiday::loadYear(2024)，该库默认不预载全部年份 - CI/CD 环境中测试失败：因数据文件通过 GitHub Release 下载，需确保构建机可访问 raw.githubusercontent.com，或提前 vendor publish 数据
