如何正確使用PHP的money_format函數與setlocale搭配來處理本地化貨幣格式？

gitbox 2025-09-16

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 本文僅為演示代碼示例，與正文內容無關。</span></span><span>
</span><span><span class="hljs-comment">// 使用時請根據實際情況調整。</span></span><span>

</span><span><span class="hljs-title function_ invoke__">setlocale</span></span><span>(LC_MONETARY, </span><span><span class="hljs-string">'en_US.UTF-8'</span></span><span>);
</span><span><span class="hljs-variable">$amount</span></span><span> = </span><span><span class="hljs-number">1234567.89</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%i'</span></span><span>, </span><span><span class="hljs-variable">$amount</span></span><span>);

</span><span><span class="hljs-meta">?&gt;</span></span><span>

---

</span><span><span class="hljs-comment"># 如何正確使用PHP的money_format函數與setlocale搭配來處理本地化貨幣格式？</span></span><span>

在涉及金融或電商類應用的開發中，貨幣格式化是一個常見的需求。PHP 中的 `money_format` 函數配合 `setlocale` 可以幫助開發者根據不同的地區設置，輸出符合本地習慣的貨幣字符串。然而，很多初學者在使用這兩個函數時容易遇到一些困惑。本文將詳細介紹其使用方法與註意事項。

</span><span><span class="hljs-comment">## 1. 基本原理</span></span><span>

- **`setlocale`**  
  用來設定程序的區域信息（Locale），影響數字、日期、貨幣等格式化規則。  
  常見的設置方式為：
  ```php
  </span><span><span class="hljs-title function_ invoke__">setlocale</span></span><span>(LC_MONETARY, </span><span><span class="hljs-string">'en_US.UTF-8'</span></span><span>);
</span></span>

上述代碼表示將貨幣格式設為美國英語（UTF-8 編碼）。

money_format
用來根據當前的Locale 格式化貨幣值。
例如：

 <span><span><span class="hljs-variable">$amount</span></span><span> = </span><span><span class="hljs-number">1234.56</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%i'</span></span><span>, </span><span><span class="hljs-variable">$amount</span></span><span>);
</span></span>

在美國Locale 下會輸出： USD 1234.56 。

2. 常用格式化參數

money_format的第一個參數為格式控製字符串。常見的有：

%i ：根據區域輸出本地化的國際格式貨幣（含貨幣符號）。
%n ：根據區域輸出本地化的國家格式貨幣。
%!n ：禁止貨幣符號，僅輸出數值部分。

示例：

 <span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%n'</span></span><span>, </span><span><span class="hljs-number">1234.56</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%i'</span></span><span>, </span><span><span class="hljs-number">1234.56</span></span><span>);
</span></span>

3. 跨平台兼容性

需要注意的是：

money_format在Windows 平台上不可用。它主要在類Unix 系統（Linux、macOS）上才有效。
在Windows 或更高版本的PHP 中，推薦使用NumberFormatter （Intl 擴展）來實現跨平台的貨幣格式化。

例如：

 <span><span><span class="hljs-variable">$fmt</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">NumberFormatter</span></span><span>(</span><span><span class="hljs-string">'en_US'</span></span><span>, </span><span><span class="hljs-title class_">NumberFormatter</span></span><span>::</span><span><span class="hljs-variable constant_">CURRENCY</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$fmt</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">formatCurrency</span></span><span>(</span><span><span class="hljs-number">1234.56</span></span><span>, </span><span><span class="hljs-string">'USD'</span></span><span>);
</span></span>

4. 實際應用場景

假設你在開發一個國際電商系統，需要根據用戶所在國家輸出不同的貨幣顯示方式，可以這樣做：

 <span><span><span class="hljs-variable">$locale</span></span><span> = </span><span><span class="hljs-string">'fr_FR.UTF-8'</span></span><span>;
</span><span><span class="hljs-title function_ invoke__">setlocale</span></span><span>(LC_MONETARY, </span><span><span class="hljs-variable">$locale</span></span><span>);

</span><span><span class="hljs-variable">$amount</span></span><span> = </span><span><span class="hljs-number">987654.32</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%i'</span></span><span>, </span><span><span class="hljs-variable">$amount</span></span><span>);
</span></span>

輸出結果可能為： 987 654,32 EUR （法語習慣）。

5. 總結與最佳實踐

使用setlocale來控制貨幣的本地化規則。
在類Unix 環境下可直接使用money_format來快速輸出本地化貨幣。
在Windows 或需要跨平台的環境中，推薦使用Intl擴展的NumberFormatter 。
在開發中，務必明確目標平台與用戶的地區設置，避免因Locale 不存在而導致函數失效。

通過正確搭配money_format與setlocale ，可以顯著提高應用在不同地區的用戶體驗，使貨幣顯示更符合當地用戶的閱讀習慣。