PHPackages                             wilon/php-number2chinese - 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 &amp; Helpers](/categories/utility)
4. /
5. wilon/php-number2chinese

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

wilon/php-number2chinese
========================

PHP数字转为汉字描述、人民币大写方法。

1.0.6(2y ago)14732.4k↑19%181MITPHPPHP &gt;=5.4

Since Mar 10Pushed 2y ago5 watchersCompare

[ Source](https://github.com/wilon/php-number2chinese)[ Packagist](https://packagist.org/packages/wilon/php-number2chinese)[ Docs](https://wilon.github.io)[ RSS](/packages/wilon-php-number2chinese/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (2)DependenciesVersions (11)Used By (1)

PHP number2chinese
==================

[](#php-number2chinese)

点击校验👉👉👉[![Build Status](https://camo.githubusercontent.com/7ba1415c410aedf2ad86a7369e705d1643c3d2f2d6b02e6333ddc61da2913139/68747470733a2f2f7472617669732d63692e6f72672f77696c6f6e2f7068702d6e756d626572326368696e6573652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/wilon/php-number2chinese)

[![Packagist](https://camo.githubusercontent.com/dc2c2d88d720bf46214b18b1d28686253bb07af681d0ebb25b3cf11e88b74799/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b6167652d77696c6f6e2f7068702d2d6e756d626572326368696e6573652d626c75652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wilon/php-number2chinese)[![Packagist Release](https://camo.githubusercontent.com/e5f5abbec69edc88dfe2afe1e1c1511c1011f23492513459659ac014ff483f50/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f77696c6f6e2f7068702d6e756d626572326368696e6573652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wilon/php-number2chinese)[![Packagist Downloads](https://camo.githubusercontent.com/0d4651b9978a23bf068c63e787d521b3da5f9a6455e55548dadf7b3b8354c040/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77696c6f6e2f7068702d6e756d626572326368696e6573652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wilon/php-number2chinese)

PHP 数字转为汉字描述，人民币大写方法。

- 个，十，百，千，万，十万，百万，千万，亿，十亿，百亿，千亿，万亿，十万亿，百万亿，千万亿，兆；此函数亿乘以亿为兆
- 以「十」开头，如十五，十万，十亿等。两位数以上，在数字中部出现，则用「一十几」，如一百一十，一千零一十，一万零一十等
- 「二」和「两」的问题。两亿，两万，两千，两百，都可以，但是20只能是二十，200用二百也更好。22,2222,2222是「二十二亿两千二百二十二万两千二百二十二」
- 关于「零」和「〇」的问题，数字中一律用「零」，只有页码、年代等编号中数的空位才能用「〇」。数位中间无论多少个0，都读成一个「零」。2014是「两千零一十四」，200014是「二十万零一十四」，201400是「二十万零一千四百」
- 参考：
- 人民币写法参考：[正确填写票据和结算凭证的基本规定](http://bbs.chinaacc.com/forum-2-35/topic-1181907.html)

### 安装

[](#安装)

> *php -v &gt;= 5.4*

在 `composer.json` 文件中添加

```
"wilon/php-number2chinese": "~1.0"
```

或者

```
composer require wilon/php-number2chinese
```

### 使用方法

[](#使用方法)

> \#string number2chinese ( mixed $number \[, bollen $isRmb\] )#

*将$number转为汉字念法*

- mixed $number

    输入数字或字符串。 当数字过大或过小时，请输入string 支持负数
- bollen $isRmb

    默认为false，当为true时返回人民币大写汉字 人民币最大单位\[仟兆\]，最小单位\[毫\]

### 代码示例

[](#代码示例)

```
$num1 = 0.1234567890;
echo number2chinese($num1);    // 零点一二三四五六七八九
echo number2chinese($num1, true);    // 零元壹角贰分叁厘肆毫
$num2 = 20000000000000000;
echo number2chinese($num2);    // 两兆
echo number2chinese($num2, true);    // 贰兆元整
$num3 = -1202030;
echo number2chinese($num3);    // 负一百二十万零两千零三十
echo number2chinese($num3, true);    // 负壹佰贰拾万零贰仟零叁拾元整
```

当数字过大时，请输入string

```
$num2 = 1234567890.0123456789;
echo number2chinese($num2);    // 十二亿三千四百五十六万七千八百九十点零一二三
echo number2chinese($num2, true);    // 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾元零壹分贰厘叁毫
$num2 = '1234567890.0123456789';
echo number2chinese($num2);    // 十二亿三千四百五十六万七千八百九十点零一二三四五六七八九
echo number2chinese($num2, true);    // 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾元壹分贰厘叁毫
```

若想精确小数点后两位，请先处理$num1

```
$num1 = 0.1234567890;
echo number2chinese(number_format($num1, 2));    // 零点一二
echo number2chinese(number_format($num1, 2), true);    // 零元壹角贰分
```

### 测试

[](#测试)

```
php vendor/wilon/php-number2chinese/test.php    // 随机一些数据进行测试
php vendor/wilon/php-number2chinese/test.php 2000   // 指定数字

```

---

有问题？[发issues](https://github.com/wilon/php-number2chinese/issues)

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity43

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~263 days

Recently: every ~526 days

Total

10

Last Release

1034d ago

Major Versions

0.2.1 → 1.0.02017-09-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/a36909b7421deb3f515efc44b6288f4391642bc3cfac029b8f322e7020bda9ac?d=identicon)[wilon](/maintainers/wilon)

---

Top Contributors

[![wilon](https://avatars.githubusercontent.com/u/7512755?v=4)](https://github.com/wilon "wilon (24 commits)")[![he426100](https://avatars.githubusercontent.com/u/9689137?v=4)](https://github.com/he426100 "he426100 (1 commits)")[![YiwanGi](https://avatars.githubusercontent.com/u/69124377?v=4)](https://github.com/YiwanGi "YiwanGi (1 commits)")

---

Tags

phpphp-libraryphpnumberChinese

### Embed Badge

![Health badge](/badges/wilon-php-number2chinese/health.svg)

```
[![Health](https://phpackages.com/badges/wilon-php-number2chinese/health.svg)](https://phpackages.com/packages/wilon-php-number2chinese)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
