phpEnv 默认不启用 calendar 扩展，需手动在 php.ini 中取消 extension=calendar 注释并确认 php_calendar.dll 存在；启用后需注意函数参数边界及儒略日以 UTC 正午为基准。
phpEnv 默认不启用 calendar 扩展，必须手动开启；否则调用 gregoriantojd()、cal_days_in_month() 等函数会直接报 Call to undefined function 错误。
确认 phpEnv 当前 PHP 版本是否支持 calendar
calendar 扩展在 PHP 5.0+ 就已内置，但 phpEnv（基于 Windows 的集成环境）默认编译时未启用 --enable-calendar。即使你看到 phpinfo() 页面里有 “calendar” 字样，也不代表已加载——它可能只是编译时保留了代码，但未启用。
- 运行
php -m | findstr calendar（Windows 命令行），无输出即未启用 - 或新建
test.php：，返回bool(false)即不可用 - phpEnv 的 PHP 版本若为 8.x，calendar 扩展仍需手动开启，不因版本新而自动激活
phpEnv 中启用 calendar 扩展的实操步骤
phpEnv 使用的是独立打包的 PHP 二进制，不能像源码编译那样加 --enable-calendar，而是靠修改 php.ini 并确保对应 DLL 存在。
- 打开 phpEnv 安装目录 →
php\版本号\（如php\8.2.12\）→ 找到php.ini - 搜索
;extension=calendar，去掉前面的分号，改为extension=calendar - 检查该目录下是否存在
ext\php_calendar.dll：若不存在，说明此 phpEnv 版本未打包该扩展，需更换版本或手动补全 DLL（极不推荐，易引发兼容问题） - 重启 phpEnv 的 Apache/Nginx 服务，再执行
php -m验证输出中含calendar
calendar 函数常见误用与边界注意点
即使扩展启用了，cal_days_in_month()、jdtogregorian() 这类函数对参数极其敏感，稍错就返回 false 或静默出错。
立即学习“PHP免费学习笔记（深入）”；
-
cal_days_in_month(CAL_GREGORIAN, 2025, 2)返回 28 —— 但cal_days_in_month(CAL_JULIAN, 2025, 2)是 29，历法类型常量必须准确（CAL_GREGORIAN= 1，CAL_JULIAN= 0） -
gregoriantojd(13, 1, 2025)会返回 0（无效）：月份必须是 1–12，不能传 13；年份支持负数（公元前），但月份/日期越界不报错，只返回 0 -
jdtounix()只接受儒略日数 ≥ 1721426（对应公元 1 年 1 月 1 日），小于此值会返回 false，且不触发 warning - 所有
jd*系列函数输入的儒略日数是整数，浮点数会被截断，例如jdtogregorian(2451545.9)和jdtogregorian(2451545)结果相同
calendar 扩展真正的复杂点不在开启，而在“儒略日计数”这个中间态——它不是时间戳，不带时区，也不对应任何本地时间，所有转换都默认以 UTC 正午（12:00）为基准。比如 gregoriantojd(2026, 4, 23) 得到的是 2461089，这代表的是 2026-04-23T12:00:00Z 的儒略日起点，而不是当天 00:00。这点极易被忽略，却直接影响复活节计算、跨历法比对等场景的结果。
