Calendar扩展在phpEnv中默认未启用,需选用含该模块的完整版PHP包(如标注full或all的版本),取消php.ini中extension=calendar注释并重启服务;Windows下无独立DLL,不可下载加载。

phpEnv 中 Calendar 扩展默认是关闭的
Calendar 扩展在 phpEnv 的多数预编译 PHP 版本中是编译进内核但默认不启用的——它不像 mysqli 或 curl 那样开箱即用。直接调用 cal_days_in_month() 会报 Call to undefined function cal_days_in_month(),不是 PHP 版本太低,而是扩展没加载。
确认 PHP 是否支持 Calendar 扩展
先验证当前 PHP 是否含该模块(非仅检查是否启用):
php -m | grep -i calendar
如果无输出,说明你用的 phpEnv PHP 包不含 Calendar(常见于精简版或较新 PHP 8.x 构建)。此时需换包或手动编译,但更现实的做法是:改用 phpEnv 提供的「完整版」PHP 包(如命名含 full 或 all 的版本)。
若输出 calendar,说明已内置,只需启用:
- 打开 phpEnv 安装目录下的
php\php.ini(注意:不是 Apache 或 Nginx 子目录里的) - 搜索
;extension=calendar,去掉分号取消注释 - 保存后重启 phpEnv 的 Web 服务(点面板上的「重启 Apache」或「重启 Nginx」)
Calendar 扩展在 Windows 下没有 DLL 文件可单独加载
这是最容易卡住的地方:phpEnv 基于 Windows,而 PHP 官方自 7.4 起已移除 Windows 独立的 php_calendar.dll。Calendar 功能被合并进主 PHP 二进制,只能通过编译时启用或使用含该模块的完整构建版。
所以别去网上搜 php_calendar.dll 下载——它要么不兼容你的 PHP 版本,要么根本加载失败,错误通常是:
PHP Warning: Cannot load module 'calendar' because required module 'standard' is not loaded in Unknown on line 0
解决路径只有一条:换用 phpEnv 官方提供的、明确标注支持 Calendar 的 PHP 版本(比如 PHP 7.4.33 full、PHP 8.0.28 all),再按上一步启用 extension=calendar。
启用后仍报错?检查 PHP 版本与函数可用性
Calendar 扩展虽启用,但部分函数在不同 PHP 小版本中行为有差异:
-
cal_from_jd()和cal_to_jd()在 PHP 8.2+ 已标记为@deprecated,但未删除,仍可用 -
jdtounix()和unixtojd()更稳定,建议优先用于 Unix 时间戳 ↔ 儒略日转换 - 若用
cal_info()获取农历信息,注意它返回的是阳历日历元数据,不提供农历计算能力——真要农历得另配第三方库(如overtrue/chinese-calendar)
最简验证代码:
<?php if (function_exists('cal_days_in_month')) {
echo cal_days_in_month(CAL_GREGORIAN, 2, 2024); // 输出 29
} else {
echo 'Calendar extension not available';
}
?>
Calendar 扩展本身不复杂,但 phpEnv 的打包策略让它成了个“开关陷阱”——看着存在,一开就失效。关键不在配置技巧,而在选对 PHP 包;一旦选错,改 php.ini 没用,重装才是最快解法。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











