miniBB 論壇中文亂碼問題快速解決方案

問題現象

miniBB 作為輕量級論壇系統，因開發者為海外團隊，預設未充分考慮中文編碼環境，導致中文內容顯示亂碼（如亂碼、問號、方塊字符）。

核心解決方法

在 miniBB 目錄下找到 bb_func_txt.php 檔案，找到以下程式碼並註釋掉：

// 原始代碼
$text = wrapText($wrap, $text);

// 修改為
// $text = wrapText($wrap, $text);

原理分析

wrapText() 函數用於自動換行處理，但其內部邏輯按位元組截斷字串。中文編碼（GBK/UTF-8）中，一個漢字佔 2-3 位元組，直接按位元組截斷會將漢字「切一半」，產生無效位元組序列，導致瀏覽器無法正確解碼顯示亂碼。

完整編碼環境配置建議

1. 資料庫連線編碼

在 setup_mysql.php 或資料庫連線初始化處加入：

mysql_query("SET NAMES 'utf8'"); // 或 'gbk'，需與頁面編碼一致

2. 頁面輸出編碼

確保所有輸出頁面包含正確的 Content-Type 標頭：

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
// PHP 頭部
header("Content-Type: text/html; charset=utf-8");

3. PHP 檔案編碼

所有 PHP 檔案請以 UTF-8 無 BOM 格式儲存，避免 BOM 導致 header() 無法發送或頁面頂部出現空白。

4. 表單提交編碼

確保表單頁面編碼與處理頁面一致，或在表單加入 accept-charset="utf-8"。

其他常見亂碼場景對照表

驗證修復結果

1. 發布包含中文、標點、Emoji 的測試貼文
2. 回覆、編輯、引用功能測試
3. 檢查 RSS、搜尋、郵件通知等衍生功能
4. 確認資料庫中實際儲存內容正確（用 phpMyAdmin 查看）

註釋掉 wrapText() 通常能立即解決 90% 的 miniBB 中文亂碼問題。若問題持續，請按上述編碼環境檢查清單逐項排查，務必保證「資料庫連線、資料表欄位、PHP 檔案、頁面輸出」四者編碼完全一致。