如何在 PHP 中通过Composer安装 PHP-Holiday 库自动识别全球法定节假日-composer-PHP中文网

官方没有 php-holiday 包，应使用 spatie/holidays：执行 composer require spatie/holidays 安装，通过 holidays('cn')->getforyear(2024) 获取中国节假日，isholiday() 可判断日期是否为法定假日（不含调休），调休需人工维护映射表。

如何在 php 中通过composer安装 php-holiday 库自动识别全球法定节假日

Composer 安装 php-holiday 失败：找不到包

官方没有名为 php-holiday 的 Composer 包。你搜到的可能是个人 fork、过期项目，或混淆了其他类似名称（如 spatie/holidays、simshaun/recurr 之类）。直接运行 composer require php-holiday 会报错：Could not find package php-holiday。

目前稳定可用、维护活跃、支持多国节假日的主流选择是 spatie/holidays：

支持超 100 个国家/地区，含中国（含港澳台）、美国、日本、德国等
返回标准 PHP DateTime 对象，可直接参与日期计算
不依赖外部 API，纯本地数据（内置 JSON），离线可用

正确安装 spatie/holidays 并加载中国节假日

执行以下命令安装：

composer require spatie/holidays

使用时注意两点：一是必须显式指定国家代码（中国是 'CN'），二是需调用 getForYear() 获取具体年份数据：

$holidays = new \Spatie\Holidays\Holidays('CN');
$cnHolidays2024 = $holidays->getForYear(2024); // 返回 DateTime[]

常见疏漏：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

忘了传国家码，导致默认用 'US'，查不到春节
直接调用 getForYear() 但没捕获异常——若国家码拼错（如 'Chn'），会抛出 InvalidCountryCode
误以为自动包含调休日：该库只返回法定假日（国务院公告日），不含补班日；需自行比对工作日历

判断某天是否为中国法定假日的最小可行代码

别写循环遍历数组比对——spatie/holidays 提供了 isHoliday() 方法，内部已优化查找逻辑：

$holidays = new \Spatie\Holidays\Holidays('CN');
$date = new DateTime('2024-10-01');
if ($holidays->isHoliday($date)) {
    echo "国庆节";
}

注意边界情况：

isHoliday() 返回 true 仅当日期精确匹配假日（不含调休日）
传入时间部分（如 '2024-10-01 15:30'）会被截断为日期，不影响结果
若日期超出库内置年份范围（当前支持 2020–2030），会返回 false 且不报错——建议加兜底提示

想支持调休日？得自己维护补班表

没有通用库能自动同步国务院每年发布的调休通知。所有“智能识别调休”的方案，本质都是人工维护一张映射表：

// 示例：2024 年中秋+国庆调休（9月28日、10月11日上班）
$makeupDays = [
    '2024-09-28' => '2024-10-04', // 补 10 月 4 日（周五）
    '2024-10-11' => '2024-10-07', // 补 10 月 7 日（周一）
];

实际判断逻辑需组合：