萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 字串每 N 字元插入分隔符:千分位格式化與通用分組實作

前言

將數字字串每三位插入逗號(千分位格式)是金融、報表常見需求。本文從簡單的內建函數進階到通用的分組函數,涵蓋各種邊界情況。

方法一:number_format() - 專為數字設計(最推薦)

<?php
$number = 1234567890.12345;

// 基本用法:整數部分每三位逗號,小數點預設為點
echo number_format($number);        // 1,234,567,890
echo number_format($number, 2);     // 1,234,567,890.12
echo number_format($number, 2, ',', '.'); // 歐洲格式:1.234.567.890,12

// 注意:超大數字會科學記號法,建議字串處理
$big = '12345678901234567890';
echo number_format($big); // 可能不準確
?>

方法二:通用字串分組函數(支援任意長度、任意分隔符)

<?php
/**
 * 從右向左每 $length 字元插入 $separator
 * 適用於數字字串、身分證字號、信用卡號等格式化
 * 
 * @param string $str  原始字串
 * @param int    $length 分組長度
 * @param string $separator 分隔符
 * @return string 格式化後字串
 */
function chunkString(string $str, int $length = 3, string $separator = ','): string {
    if ($length <= 0) {
        throw new InvalidArgumentException('分組長度必須大於 0');
    }
    
    // 處理負號與小數點
    $prefix = '';
    if (str_starts_with($str, '-')) {
        $prefix = '-';
        $str = substr($str, 1);
    }
    
    // 分離整數與小數部分
    $parts = explode('.', $str, 2);
    $integerPart = $parts[0];
    $decimalPart = $parts[1] ?? '';
    
    // 從右向左分組整數部分
    $reversed = strrev($integerPart);
    $chunks = str_split($reversed, $length);
    $formattedInteger = strrev(implode($separator, $chunks));
    
    // 組合結果
    $result = $prefix . $formattedInteger;
    if ($decimalPart !== '') {
        $result .= '.' . $decimalPart;
    }
    
    return $result;
}

// 測試
echo chunkString('1234567890') . "\n";        // 1,234,567,890
echo chunkString('1234567890.123', 3, ',') . "\n"; // 1,234,567,890.123
echo chunkString('-1234567890', 3, ',') . "\n";    // -1,234,567,890
echo chunkString('1234567890', 4, ' ') . "\n";     // 1 2345 6789 (四位一組)
echo chunkString('A123456789', 3, '-') . "\n";     // A12-345-6789 (身分證格式)
?>

方法三:正則表達式單行解法

<?php
function formatWithRegex(string $number): string {
    // 從右向左每三位插入逗號(不影響小數部分)
    return preg_replace('/(\d)(?=(\d{3})+(?!\d))/', '$1,', $number);
}

echo formatWithRegex('1234567890');       // 1,234,567,890
echo formatWithRegex('1234567890.123');   // 1,234,567,890.123
echo formatWithRegex('-1234567890');      // -1,234,567,890

// 解釋正則:
// (\d)           捕獲一個數字
// (?=            正向前瞻
//   (\d{3})+     後面跟著 3 的倍數個數字
//   (?!\d)       但後面不能再有數字(確保是整數部分結尾)
// )
?>

原始碼問題分析

原文程式碼使用雙層迴圈手動翻轉字串,存在以下問題:

  • 邏輯過度複雜,難以維護
  • 變數 $j 在內層迴圈後狀態不明確
  • 手動翻轉字串效能低且易出錯
  • 未處理負號、小數點、非數字字元

效能比較(百萬次迴圈基準)

方法相對速度適用場景
number_format()最快(C 層實作)純數字格式化
preg_replace()中等字串已知為純數字、需簡潔程式碼
strrev + str_split + implode中等通用字串分組、自訂分隔符
雙層迴圈手動翻轉最慢教學示範、極特殊邏輯

實務應用範例

1. 信用卡號格式化(每 4 位空格)

function formatCreditCard(string $number): string {
    // 移除所有非數字
    $digits = preg_replace('/\D/', '', $number);
    return chunkString($digits, 4, ' ');
}

echo formatCreditCard('4242-4242-4242-4242'); // 4242 4242 4242 4242

2. 台灣身分證字號格式化

function formatTwId(string $id): string {
    $id = strtoupper(preg_replace('/\s+/', '', $id));
    if (strlen($id) !== 10) return $id;
    return substr($id, 0, 1) . chunkString(substr($id, 1), 3, '-');
}

echo formatTwId('A123456789'); // A123-456-789

3. 電話號碼格式化

function formatPhone(string $phone): string {
    $digits = preg_replace('/\D/', '', $phone);
    // 09xx-xxx-xxx 或 02-xxxx-xxxx
    if (str_starts_with($digits, '09')) {
        return chunkString($digits, 3, '-', 0, 3); // 需擴充函數支援首段長度
    }
    return chunkString($digits, 4, '-');
}

總結

  • 純數字千分位:首選 number_format(),效能最好、功能最完整
  • 通用字串分組:使用 strrev() + str_split() + implode() 模式,清晰且效能佳
  • 簡潔單行:preg_replace() 適合已知純數字字串
  • 避免手動迴圈翻轉:程式碼複雜、易錯、效能差
  • 實務建議:封裝為工具函數,統一處理負號、小數、非數字字元等邊界情況
copyright © 萬盛學電腦網 all rights reserved