PHPackages                             hejunjie/fortune-analyzer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hejunjie/fortune-analyzer

ActiveLibrary[Utility & Helpers](/categories/utility)

hejunjie/fortune-analyzer
=========================

一款简洁易用的 PHP 八字排盘工具库，提供阳历与农历的相互转换、精准的节气时间计算、四柱排盘（八字）分析及五行推演等功能。代码注释清晰，结构简洁，适合开发者快速上手并理解命理计算原理。无论是个人使用，还是作为命理学工具的开发基础，都能为您的项目提供稳定可靠的支持。

v1.5.1(4mo ago)19556MITPHPPHP >=8.1

Since Jun 7Pushed 4mo agoCompare

[ Source](https://github.com/zxc7563598/php-fortune-analyzer)[ Packagist](https://packagist.org/packages/hejunjie/fortune-analyzer)[ RSS](/packages/hejunjie-fortune-analyzer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)DependenciesVersions (8)Used By (0)

hejunjie/fortune-analyzer
=========================

[](#hejunjiefortune-analyzer)

八字排盘工具库，支持 1900-2100 年间阳历与农历的相互转换，内置秒级精度的 24 节气时间计算，提供四柱（年、月、日、时）排盘、五行推演等核心命理功能。

**本项目已经经由 Zread 解析完成，如果需要快速了解项目，可以点击此处进行查看：[了解本项目](https://zread.ai/zxc7563598/php-fortune-analyzer)**

你可以在这个 demo 中简单查看这个包可以提供的信息 👉 [点击前往](https://hejunjie.life/composer/fortune-analyzer)

---

初衷
--

[](#初衷)

在开发这款八字排盘工具时，我意识到市面上已经有许多相关的 PHP 库，但大部分的实现都存在一个共同问题：代码结构复杂且注释不足，导致理解和维护起来非常困难。对于需要用到命理分析的开发者来说，工具的正确性固然重要，但易用性和可读性同样是不可忽视的。

因此，我决定开发一个简洁、清晰、易于理解的八字排盘工具。每个方法的实现都在代码中进行了详细的注释，清楚地标明了每个步骤的计算逻辑和思路，确保使用者不仅能使用这个工具，还能理解它的内部机制。这不仅有助于开发者在使用过程中避免误解和错误，也让他们能够更好地定制或扩展功能。

在我看来，代码的清晰度远比复杂的结构更加重要。简单明了的接口和注释清晰的实现，可以让每一个开发者都能轻松上手并快速理解命理学的核心计算方法。希望这款工具不仅能帮助大家在实践中高效完成需求，也能作为学习和理解八字命理计算的一份良好资料。

主要功能
----

[](#主要功能)

- 阳历与农历的相互转换，支持 1900-2100 年范围
- 精确计算 24 节气时间，秒级精度，由 [Jet Propulsion Laboratory](https://www.jpl.nasa.gov) 提供
- 四柱排盘（八字）计算，支持年柱、月柱、日柱、时柱
- 五行统计及五行局计算，辅助命理分析
- 后续版本计划支持十神分布、排大运、流年推算等功能

---

安装
--

[](#安装)

使用 Composer 安装：

```
composer require hejunjie/fortune-analyzer
```

目前支持的方法
-------

[](#目前支持的方法)

方法说明FortuneAnalyzer::convertSolarToLunar()阳历转农历FortuneAnalyzer::convertLunarToSolar()农历转阳历FortuneAnalyzer::getSolarTerms()获取指定年份的 24 节气时间FortuneAnalyzer::analyzeFourPillars()获取八字FortuneAnalyzer::getYearPillar()获取年柱FortuneAnalyzer::getMonthPillar()获取月柱FortuneAnalyzer::getDayPillar()获取日柱FortuneAnalyzer::getHourPillar()获取时柱FortuneAnalyzer::getWuXingBreakdown()获取五行信息FortuneAnalyzer::analyzeWuXingSimple()获取五行统计（不含藏干）FortuneAnalyzer::analyzeWuXingFull()获取五行统计（包含藏干）FortuneAnalyzer::detectWuXingJu()获取五行局FortuneAnalyzer::getShiShenDistribution计算十神FortuneAnalyzer::interpretShiShen分析十神FortuneAnalyzer::calculateStartAge计算起运信息FortuneAnalyzer::getLuckCycles排出大运列表快速开始
----

[](#快速开始)

```