萬盛學電腦網

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

PHP MySQL 中文亂碼徹底解決:編碼統一四步法與實戰案例

亂碼本質:編碼鏈路任一環節不一致

數據庫默認編碼 → 表編碼 → 字段編碼 → 連接編碼 → PHP 文件編碼 → 頁面輸出編碼 → 瀏覽器解碼
     ↑              ↑          ↑           ↑            ↑              ↑              ↑
   必須一致      必須一致    必須一致     必須一致      必須一致       必須一致       必須一致

四步統一法

步驟 1:數據庫/表/字段統一 UTF-8 (推薦 utf8mb4)

-- 創建數據庫
CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 創建表 (指定表級編碼)
CREATE TABLE useradmin (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(20) NOT NULL,
    userpass VARCHAR(40) NOT NULL,
    logins INT DEFAULT 0,
    logintime TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    mid CHAR(1) DEFAULT '0'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- 修改現有表/字段
ALTER TABLE useradmin CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE useradmin MODIFY username VARCHAR(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

步驟 2:連接建立時設置編碼 (最關鍵、最常被忽略)

<?php
// mysqli 面向對象
$mysqli = new mysqli('localhost', 'user', 'pass', 'mydb');
$mysqli->set_charset('utf8mb4');  // ★★★ 關鍵一行 ★★★

// mysqli 過程式
$link = mysqli_connect('localhost', 'user', 'pass', 'mydb');
mysqli_set_charset($link, 'utf8mb4');

// PDO (推薦)
$pdo = new PDO('mysql:host=localhost;dbname=mydb;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_EMULATE_PREPARES => false,
]);

// 老式 mysql_* (已移除,僅參考)
mysql_connect(...);
mysql_query("SET NAMES 'utf8mb4'");  // 相當於 SET character_set_client/connection/results

步驟 3:PHP 文件保存為 UTF-8 無 BOM

  • 編輯器 (VS Code/PhpStorm/Notepad++) 右下角編碼選 **UTF-8** (非 UTF-8 with BOM)
  • BOM 會導致 `header()` 失效、輸出異常空白

步驟 4:HTTP 響應頭 + HTML Meta 雙重聲明

<?php
// PHP 頭部 (必須在任何輸出前)
header('Content-Type: text/html; charset=utf-8');
?>
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">  <!-- HTML5 簡寫 -->
    <!-- 兼容舊瀏覽器 -->
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
...

實戰案例:頁面為 GBK、數據庫為 UTF-8 的兼容方案

<?php
// 1. 連接設置為 UTF-8
$mysqli = new mysqli('localhost', 'user', 'pass', 'mydb');
$mysqli->set_charset('utf8mb4');

// 2. 頁面聲明 GBK
header('Content-Type: text/html; charset=gbk');
// 或 

// 3. 查詢數據 (從 UTF-8 數據庫讀取)
$result = $mysqli->query('SELECT * FROM useradmin');

// 4. 輸出前轉碼
while ($row = $result->fetch_assoc()) {
    // 數據庫 UTF-8 → 頁面 GBK
    $name = iconv('UTF-8', 'GBK//IGNORE', $row['username']);
    echo $name;
}

// 5. 寫入前轉碼 (頁面 GBK → 數據庫 UTF-8)
$input = $_POST['username'];  // GBK
$name = iconv('GBK', 'UTF-8//IGNORE', $input);
$mysqli->query("INSERT INTO useradmin (username) VALUES ('{$mysqli->real_escape_string($name)}')");

AJAX 專項:強制 UTF-8

<?php
// API 介面統一輸出 UTF-8 JSON
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

// 前端 JS 發送時默認 UTF-8,無需額外處理
// jQuery: $.ajax({url, data: {name: '中文'}}) 自動 UTF-8 編碼

常見誤區避坑

誤區正確做法
以為 `SET NAMES utf8` 就夠了必須配合數據庫/表/字段編碼、PHP文件編碼、頁面輸出編碼
用 `utf8` 而非 `utf8mb4``utf8` 只支持 BMP (3字節),無法存 Emoji/生僻字,**必須用 utf8mb4**
只設置數據庫默認編碼表、字段可單獨指定編碼,**必須顯式指定表/字段為 utf8mb4**
忽略 PHP 文件 BOM**嚴禁 BOM**,導致輸出異常、header 失效、Session 啟動失敗

總結

中文亂碼 = **編碼不一致**。解決核心:**全鏈路 utf8mb4**。新項目:數據庫/表/字段 utf8mb4 + 連接 `set_charset('utf8mb4')` + PHP 文件 UTF-8 無 BOM + 頁面 ``。老項目 GBK 共存:連接層轉碼 `iconv`。PDO + `charset=utf8mb4` 是現代最省心方案。

copyright © 萬盛學電腦網 all rights reserved