phpEnv 默认启用 calendar 扩展，因 Windows 版 PHP 官方构建已内建支持；但需通过 php -m | findstr calendar 或 php --ri calendar 确认当前版本实际加载，且 php.ini 中 extension=calendar 未被注释、extension_dir 路径正确。
phpEnv 默认不启用 calendar 扩展，必须手动开启；Windows 下通常已编译进 PHP，Linux/macOS 需确认编译参数或重装时加 --enable-calendar。
phpEnv 中 calendar 扩展是否已启用？
phpEnv 是基于 Windows 的多版本 PHP 环境管理工具，其打包的 PHP 二进制默认启用了 calendar 扩展（因 Windows 版 PHP 官方构建已内建支持）。但实际是否可用，得看当前选中的 PHP 版本是否真加载了该模块：
- 运行
php -m | findstr calendar（Windows 命令行），有输出即表示已启用 - 若无输出，或调用
cal_info(CAL_GREGORIAN)报错Call to undefined function cal_info()，说明未启用 - 注意：phpEnv 的「切换 PHP 版本」操作不会自动重载扩展配置，需检查对应版本的
php.ini
如何在 phpEnv 中手动启用 calendar 扩展
即使 phpEnv 自带的 PHP 二进制已含 calendar，仍需确保 php.ini 中未禁用它。打开 phpEnv 控制面板 →「PHP 设置」→「编辑 php.ini」，搜索以下两处：
- 确认
extension=calendar这一行存在且未被注释（即前面没有分号;） - 检查
extension_dir路径是否正确指向当前 PHP 版本的ext目录（例如C:\phpenv\versions\8.2.12\ext） - 保存后重启 Web 服务（如 Apache/Nginx）或命令行终端，再执行
php --ri calendar查看模块信息
calendar 扩展不可用的常见原因
即使配置看起来没问题，仍可能失败，关键点在于：
立即学习“PHP免费学习笔记（深入）”；
- phpEnv 切换 PHP 版本后，
php.ini文件可能被覆盖或未同步 —— 建议每次切换后手动验证该版本下的php.ini路径（用php --ini查）并重新检查extension=calendar - 某些 phpEnv 镜像（尤其精简版或自定义编译版）会显式禁用非核心扩展，此时
extension=calendar行可能被删掉或注释掉 - 函数调用时传错常量值：比如误用
CAL_GREGORIAN但拼成CAL_GREGORION，会导致Warning: cal_info(): Unknown calendar ID - 历法转换必须经儒略日（Julian Day Count）中转 —— 直接调用
jewishtojd()却传入非法犹太历年份（如负数或超大值），会返回0或 false，而非报错
calendar 函数能做什么、不能做什么
calendar 扩展只做历法间数值转换，不处理时区、本地化、农历、事件计算等：
- ✅ 支持：公历（
CAL_GREGORIAN）、儒略历（CAL_JULIAN）、犹太历（CAL_JEWISH）、法国共和历（CAL_FRENCH）之间的日期互转 - ✅ 提供
cal_days_in_month()、cal_from_jd()、jdmonthname()等基础工具函数 - ❌ 不支持：中文农历（阴历）、节气、闰月逻辑、节假日推算
- ❌ 不支持：时区转换（得靠
DateTimeZone）、格式化输出（得用date()或strftime()） - ⚠️ 注意：
jewishtojd()和jdtoujewish()的年份参数是犹太历年，起始为公元前 3761 年（即犹太历元年），不是公元年 —— 混用会导致结果偏移数百年
真正容易被忽略的是：所有转换都依赖儒略日计数（JDN）作为中间桥梁，而 JDN 是从公元前 4713 年 1 月 1 日开始的连续整数。一旦你跳过这一步直接想「把犹太历某天转成公历」，函数就无法工作 —— 不是 bug，是设计前提。
