PHP无内置农历函数，需用overtrue/chinese-calendar等第三方库或php-ext-chinese-calendar扩展实现；农历转换依赖天文计算，不可简单偏移或查表。
PHP 里没有内置农历函数
PHP 标准库不提供 date() 或 DateTime 的农历支持，所有“直接输出农历”的说法，本质都是调用第三方算法或扩展。官方至今没加，也不太可能加——农历规则复杂（闰月、节气、朔望），且依赖天文计算，不适合塞进核心。
常见错误现象：date('Y年m月d日', time()) 输出永远是公历；有人误以为 IntlDateFormatter 能切农历，其实它只支持「中文格式的公历」，比如把 2025-01-29 显示成“二〇二五年一月二十九日”，但不是农历日期（那天其实是己巳年腊月三十）。
用 overtrue/chinese-calendar 最省事
这是目前最轻量、维护活跃、逻辑清晰的 Composer 包，纯 PHP 实现，不依赖扩展，覆盖 1900–2100 年。它把农历年月日、节气、干支、生肖、是否闰月都封装好了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer require overtrue/chinese-calendar - 初始化：
$calendar = new \Overtrue\ChineseCalendar\Calendar(); - 获取今天农历：
$lunar = $calendar->solarToLunar(date('Y'), date('n'), date('j'));，返回数组含year、month、day、is_leap_month等键 - 注意：月份和日期是数字，要转中文需自己映射（如 1→“正月”，30→“三十”），包里没带渲染逻辑
用 php-ext-chinese-calendar 扩展性能更好但部署麻烦
这是 C 编写的扩展，比纯 PHP 快 5–10 倍，适合高并发查农历的场景（比如节日营销系统每秒几千次转换）。但它需要编译安装，不能用 composer 一键搞定，且 Windows 下基本不可用。
容易踩的坑：
- PHP 版本必须匹配（比如 PHP 8.2 需用对应分支编译）
-
php.ini里漏加extension=chinese_calendar.so，会报Call to undefined function lunar_to_solar() - 函数名是
solar_to_lunar()，参数顺序是(year, month, day)，不是时间戳——传time()直接错
别硬套 strtotime() 或 DateTime::modify() 算农历
农历不是固定偏移，没法靠加减天数推算。网上有些“用公历减去某常量得农历”的代码，全是错的——它们最多拟合某几年，遇到闰四月、闰七月就崩。2025 年有闰六月，2033 年有闰十一月，规则由紫金山天文台发布，每年微调。
真实使用场景中，只要涉及节气判断（比如“芒种后三天发优惠券”）、生日提醒（按农历每年循环）、黄历宜忌，就必须用专业算法，而不是字符串拼接或时间戳偏移。
复杂点在于：农历和公历不是一一映射。同一天可能对应两个农历日期（因时区+朔时刻跨日），而节气时刻精确到分钟，必须用天文算法，不是查表能完全覆盖的。多数项目用 1900–2100 年查表法已够用，但真要严谨，得接天文台 API 或用 libastro 类库——那已经超出 PHP 常规开发范畴了。
