如何使用Composer引入 PHP-Lunar 库实现阳历与阴历的相互转换算法-composer-PHP中文网

php-lunar 并非真实存在的 composer 包，因其未注册于 packagist 且无官方维护，强行安装会报错；实际可用方案为 overtrue/laravel-chinese-calendar（laravel 场景）或 gaozhi/lunar（纯 php），二者均支持 composer 安装并提供可靠农历转换功能。

如何使用composer引入 php-lunar 库实现阳历与阴历的相互转换算法

PHP-Lunar 不是 Composer 可直接安装的公开包，它不存在于 Packagist，强行 composer require 会报错 Package php-lunar/php-lunar not found。

为什么 Composer 找不到 php-lunar/php-lunar

PHP-Lunar 是一个长期被误传的“库名”，实际并不存在官方维护的同名 Composer 包。网上提到的所谓 “PHP-Lunar” 多指以下两类情况：

某个人 fork 或私有仓库里改写的农历转换逻辑（无统一命名、无 Packagist 注册）
对 Python 的 lunardate 或 Java 的 ChineseCalendar 的误称移植
部分中文博客把自写函数或旧版 calendars 类库硬贴上该标签

可用的替代方案：使用 `overtrue/laravel-chinese-calendar`（Laravel 场景）

这是目前最接近需求、稳定维护、支持 Composer 安装的中文农历工具库，底层基于权威农历算法（含节气、闰月校验），适用于 Laravel 项目，也支持纯 PHP 使用。

执行安装命令：

composer require overtrue/laravel-chinese-calendar

基础用法示例：

$calendar = new \Overtrue\ChineseCalendar\Calendar();
// 阳历转阴历
$lunar = $calendar->solarToLunar(2024, 10, 1); // 返回 ['year'=>2024, 'month'=>8, 'day'=>28, 'leap'=>false, ...]
// 阴历转阳历
$solar = $calendar->lunarToSolar(2024, 8, 28, false); // 返回 ['year'=>2024, 'month'=>10, 'day'=>1]

注意点：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

该库默认只支持 1900–2100 年区间，超出会返回 null
阴历日期中的 leap 参数必须明确传 true 或 false，否则可能误判闰月
不支持时辰级精度（即无法精确到几点几分），仅到日粒度

纯 PHP 项目用 `gaozhi/lunar`（轻量无框架依赖）

这是一个专注农历计算、无外部依赖、可直接 require 的单文件方案，已发布在 Packagist，兼容 PHP 7.4+：

composer require gaozhi/lunar

调用方式极简：

use Gaozhi\Lunar\Lunar;
$lunar = new Lunar();
echo $lunar->dateToLunar('2024-10-01'); // "二〇二四年八月廿八"
echo $lunar->lunarToDate('二〇二四年八月廿八'); // "2024-10-01"

关键限制：