PHP实现人民币金额转中文大写：三种常用方法与代码示例
发布时间：2026-10-13 |
1人浏览过
在Web开发中，经常需要将小写人民币金额转换为中文大写格式，以防止篡改并满足财务规范。本文整理了三种常见的PHP实现方式：从功能完善的类库到简洁的脚本函数，详细解析了数字拆分、单位匹配及零值处理的逻辑，帮助开发者快速集成金额转换功能。
方法一：面向对象的标准转换类
该方案提供了一个完整的 Num2RmbClass 类，支持自定义币种单位（如“元”或“圆”），并可配置小数位的四舍五入、进位以及额外的零值补全逻辑，适合对格式要求严格的业务场景。
第1步：定义核心转换逻辑
该类通过静态方法 num2rmb 执行转换。主要处理步骤包括：
- 数据预处理：将输入数字按小数点拆分为整数和小数部分，处理多余的小数位（根据是否开启四舍五入决定是截断还是进位）。
- 整数部分转化：从右向左每4位一组，匹配对应的中文单位（拾、佰、仟、万、亿等），并合并连续的零为单个“零”。
- 小数部分转化：从左向右匹配“角”、“分”，同样处理去零逻辑。
- 结果拼接：组合整数和结果，若小数部分为空则追加“整”字，并处理负数情况。
class Num2RmbClass{
/**
* 人民币数值转中文大写
* @param string $number 数值 默认为0
* @param string $int_unit 币种单位，默认"元"
* @param bool $is_round 是否对小数进行四舍五入
* @param bool $is_extra_zero 是否对整数部分以0结尾附加零
* @param bool $dec_to_int 是否对让小数部分进位到个位
* @return string
*/
public static function num2rmb($number = 0, $int_unit = '元', $is_round = TRUE, $is_extra_zero = FALSE, $dec_to_int = FALSE) {
// 将数字切分成两段
$parts = explode('.', $number, 2);
$int = isset($parts[0]) ? strval($parts[0]) : '0';
$dec = isset($parts[1]) ? strval($parts[1]) : '';
// 如果小数点后多于2位，不四舍五入就直接截，否则就处理
$dec_len = strlen($dec);
if (isset($parts[1]) && $dec_len > 2) {
if($is_round){
if(round(floatval("0.".$dec), 2) == 1 && $dec_to_int){//小数进位到个位
$int = empty($int)?1: strval($parts[0]+1);
$dec = 0;
}elseif(round(floatval("0.".$dec), 2) == 1){//小数不进位到个位
$dec = "99";
}else{
$dec = substr(strrchr(strval(round(floatval("0.".$dec), 2)), '.'), 1);
}
}else{
$dec = substr($parts[1], 0, 2);
}
}
// 当number为0.001时，小数点后的金额为0元
if (empty($int) && empty($dec)) {
return '零';
}
// 定义字符和单位数组
$chs = array('0','壹','贰','叁','肆','伍','陆','柒','捌','玖');
$uni = array('','拾','佰','仟');
$dec_uni = array('角', '分');
$exp = array('', '万');
$res = '';
// 整数部分从右向左找
for ($i = strlen($int) - 1, $k = 0; $i >= 0; $k++) {
$str = '';
// 按照中文读写习惯，每4个字为一段进行转化
for ($j = 0; $j < 4 && $i >= 0; $j++, $i--) {
$u = $int{$i} > 0 ? $uni[$j] : ''; // 非0的数字后面添加单位
$str = $chs[$int{$i}] . $u . $str;
}
$str = rtrim($str, '0');// 去掉末尾的0
$str = preg_replace("/0+/, "零", $str); // 替换多个连续的0
if (!isset($exp[$k])) {
$exp[$k] = $exp[$k - 2] . '亿'; // 构建单位
}
$u2 = $str != '' ? $exp[$k] : '';
$res = $str . $u2 . $res;
}
// 如果小数部分处理完之后是00，需要处理下
$dec = rtrim($dec, '0');
// 小数部分从左向右找
if (!empty($dec)) {
$res .= $int_unit;
// 是否要在整数部分以0结尾的数字后附加0
if ($is_extra_zero) {
if (substr($int, -1) === '0') {
$res.= '零';
}
}
for ($i = 0, $cnt = strlen($dec); $i < $cnt; $i++) {
$u = $dec{$i} > 0 ? $dec_uni[$i] : '';
$res .= $chs[$dec{$i}] . $u;
}
$res = rtrim($res, '0');
$res = preg_replace("/0+/, "零", $res);
} else {
$res .= $int_unit . '整';
}
return $number < 0 ? "(负)".$res : $res;
}
}第2步：调用示例
直接调用静态方法即可获取结果，支持传入布尔参数控制行为。
// 输出：壹拾陆亿零零贰佰万叁仟玖佰玖拾捌圆玖角玖分
echo Num2RmbClass::num2rmb('1600020039.9989', '圆', false, false, false);方法二：基于递归映射的简洁实现
此方法代码量较少，利用辅助函数 _cny_map_unit 进行单位映射，逻辑更偏向函数式编程风格，适合追求代码简洁的场景。
function cny($ns)
{
static $cnums = array("零","壹","贰","叁","肆","伍","陆","柒","捌","玖"),
$cnyunits = array("圆","角","分"),
$grees = array("拾","佰","仟","万","拾","佰","仟","亿");
list($ns1,$ns2) = explode(".",$ns,2);
$ns2 = array_filter(array($ns2[1],$ns2[0]));
$ret = array_merge($ns2,array(implode("", _cny_map_unit(str_split($ns1), $grees)), ""));
$ret = implode("",array_reverse(_cny_map_unit($ret,$cnyunits)));
return str_replace(array_keys($cnums), $cnums,$ret);
}
function _cny_map_unit($list,$units)
{
$ul = count($units);
$xs = array();
foreach (array_reverse($list) as $x)
{
$l = count($xs);
if($x!="0" || !($l%4))
{
$n=($x=='0'?'':$x).($units[($l-1)%$ul]);
}
else
{
$n=is_numeric($xs[0][0]) ? $x : '';
}
array_unshift($xs, $n);
}
return $xs;
}
$value='23058.04';
print cny($value);echo'
';
// 输出：贰万叁仟零伍拾捌圆肆角方法三：传统字符串截取与循环法
这是一种较早期的实现思路，通过将金额乘以100转为整数，然后逐位截取汉字并拼接，最后清理多余的“零”。该方法不依赖复杂的数据结构，但需注意UTF-8编码下的字符长度处理。
/**
* 数字金额转换成中文大写金额的函数
* String Int $num 要转换的小写数字或小写字符串
* return 大写字母
*/
function num_to_rmb($num){
$c1 = "零壹贰叁肆伍陆柒捌玖";
$c2 = "分角元拾佰仟万拾佰仟亿";
//精确到分
$num = round($num, 2);
$num = $num * 100;
if (strlen($num) > 10) {
return "金额太大，请检查";
}
$i = 0;
$c = "";
while (1) {
if ($i == 0) {
$n = substr($num, strlen($num)-1, 1);
} else {
$n = $num % 10;
}
$p1 = substr($c1, 3 * $n, 3);
$p2 = substr($c2, 3 * $i, 3);
if ($n != '0' || ($n == '0' && ($p2 == '亿' || $p2 == '万' || $p2 == '元'))) {
$c = $p1 . $p2 . $c;
} else {
$c = $p1 . $c;
}
$i = $i + 1;
$num = (int)($num / 10);
if ($num == 0) {
break;
}
}
$j = 0;
$slen = strlen($c);
while ($j < $slen) {
$m = substr($c, $j, 6);
if ($m == '零元' || $m == '零万' || $m == '零亿' || $m == '零零') {
$left = substr($c, 0, $j);
$right = substr($c, $j + 3);
$c = $left . $right;
$j = $j-3;
$slen = $slen-3;
}
$j = $j + 3;
}
if (substr($c, strlen($c)-3, 3) == '零') {
$c = substr($c, 0, strlen($c)-3);
}
if (empty($c)) {
return "零元整";
}else{
return $c . "整";
}
}
// 测试
// echo num_to_rmb(23000000.00); // 贰仟叁佰万元整总结与注意事项
以上三种方法均可实现人民币金额的大写转换，开发者可根据项目需求选择： 1. 功能完整性：方法一提供了最细致的配置项，适合复杂的金融业务。 2. 代码简洁性：方法二和二的方法代码短小，易于维护。 3. 兼容性：所有方法均假设输入为合法数字格式，使用前建议对输入数据进行合法性校验。 以上就是PHP人民币数值转中文大写的详细内容，更多关于PHP货币转换的资料请关注本站其它相关文章！
本站声明
本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。
