calendar扩展在phpEnv中需编译时加--enable-calendar参数启用，非php.ini配置；未启用时cal_days_in_month()等函数报错；验证用php -m | grep calendar或get_extension_funcs('calendar')。
calendar 扩展在 phpEnv 中默认不启用，即使你看到 phpinfo() 里列出了该扩展，也不代表它已加载可用——常见现象是调用 cal_days_in_month() 等函数时直接报 Call to undefined function cal_days_in_month()。
如何确认 calendar 扩展是否真正启用
- 运行
php -m | grep calendar（命令行）或在 Web 环境中输出print_r(get_extension_funcs('calendar')); - 如果返回
bool(false)或空数组，说明扩展未加载，不是“存在但没启”，而是“启了但没生效”或“根本没编译进 PHP”
phpEnv 下开启 calendar 扩展的实操步骤
phpEnv 是基于源码编译的 PHP 多版本管理工具，不走 php.ini 的 extension=calendar.so 路线（因为 calendar 是静态编译进 PHP 核心的，不是独立 .so 模块）：
- 编译时必须显式加
--enable-calendar参数 - phpEnv 的编译脚本（如
build.sh或install.sh）通常默认不包含该参数 - 你需要手动修改构建配置
具体操作：
- 进入 phpEnv 的源码构建目录（通常是
~/.phpenv/plugins/php-build/share/php-build/definitions/） - 找到你正在安装的 PHP 版本定义文件，例如
7.4.33或8.2.12 - 在该文件末尾的
configure_options数组中，追加：--enable-calendar
- 保存后重新执行安装：
phpenv install 8.2.12（以你实际版本为准）
⚠️ 注意：不能对已安装版本“热启用”，必须重装 PHP。重装后需 phpenv global 8.2.12 切换并验证。
立即学习“PHP免费学习笔记（深入）”；
cal_to_jd() 和 jdtogregorian() 配合使用时的典型陷阱
这两个函数是 calendar 扩展最常被误用的一对：
-
cal_to_jd(CAL_GREGORIAN, $month, $day, $year)：月份和日期必须是有效公历值，不校验范围（比如传13月不会报错，但结果错乱） -
jdtogregorian($jd)返回格式为"mm/dd/yyyy"字符串，不是数组；若需拆解，得explode('/', ...)，且注意顺序固定（非 locale 敏感）
常见错误现象：
- 传入
cal_to_jd(CAL_GREGORIAN, 2, 30, 2024)（2 月 30 日）→ 返回一个 JD 值，但后续jdtogregorian()会转成 3 月 1 日左右，容易掩盖输入错误 - 用
date('Y-m-d', jdtounix($jd))替代jdtogregorian()：看似更“现代”，但jdtounix()依赖系统时区，而jdtogregorian()是纯历法计算、与时区无关——两者结果可能差一天
建议做法：
- 输入前先用
checkdate($m, $d, $y)校验合法性 - 若需 Unix 时间戳，明确指定时区：
$dt = new DateTimeImmutable("@".jdtounix($jd)); $dt = $dt->setTimezone(new DateTimeZone('Asia/Shanghai'));
cal_info() 返回的历法数据里哪些字段真有用
cal_info(CAL_JEWISH) 或 cal_info(CAL_FRENCH) 返回数组，但多数字段只是元信息，实际开发中只有几个关键项：
-
months：索引数组，键为 1–12（或更多），值为月份名称（UTF-8，需确保页面编码一致，否则中文环境显示为乱码） -
maxdaysinmonth：最大天数（犹太历有闰月，部分月可到 30 天） -
calname：历法英文名，仅作标识，无逻辑作用
特别注意：cal_info(CAL_GREGORIAN) 的 months 是英文名（"January"…），不是本地化名称；别指望它返回“一月”“二月”。需要中文月份，请自己映射或改用 strftime('%B', ...) + setlocale()。
calendar 扩展真正的复杂点不在函数调用，而在儒略日计数（JD）这个中间态的隐式精度丢失：JD 是整数，但某些历法转换（尤其是犹太历、法国共和历）内部涉及浮点近似。如果你拿 jewishtojd() 得到的 JD 再喂给 jdtojewish()，反复来回几次，日期可能偏移 1 天——这不是 bug，是设计使然。生产环境做跨历法长期存储，务必只存原始历法字段 + 显式 JD，不要靠来回转换保真。
