萬盛學電腦網

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

PHP mysql_fetch_array vs mysql_fetch_assoc 深度對比:回傳結構、效能與遷移建議

前言

mysql_fetch_array() 與 mysql_fetch_assoc() 是早期 ext/mysql 擴展(PHP 5.5 棄用、PHP 7.0 移除)的資料列抓取函式。雖然已淘汰,但理解其差異有助於遷移至 mysqli/PDO 時對應 fetch_assoc()/fetch_array()。本文深度剖析回傳結構、記憶體佔用、參數控制與現代替代方案。

⚠ 重要提醒:mysql_* 函式已從 PHP 7.0 移除。新專案請直接使用 PDO 或 mysqli。本文僅供維護舊專案或教學參考。


一、回傳結構核心差異

1.1 mysql_fetch_assoc()

  • 僅回傳關聯陣列(字串鍵 = 欄位名)。
  • 等同 mysql_fetch_array($result, MYSQL_ASSOC)。
  • 記憶體佔用較小(無數值索引)。

1.2 mysql_fetch_array()

  • 預設回傳雙重陣列:同時包含數值索引(0,1,2...)與關聯索引(欄位名)。
  • 可透過第二參數控制模式:
    • MYSQL_ASSOC:僅關聯(同 fetch_assoc)
    • MYSQL_NUM:僅數值索引
    • MYSQL_BOTH(預設):雙重索引
  • 同名欄位:最後一欄覆蓋前者,需用數值索引或 SQL 別名存取。

1.3 具體回傳結構對比

<?php
// 假設查詢:SELECT username, password FROM users WHERE id=1
// 結果:username='test', password='123456'

// mysql_fetch_assoc()
$row = mysql_fetch_assoc($result);
/*
array(2) {
  'username' => 'test',
  'password' => '123456'
}
*/

// mysql_fetch_array() 預設 MYSQL_BOTH
$row = mysql_fetch_array($result);
/*
array(4) {
  0 => 'test',
  'username' => 'test',
  1 => '123456',
  'password' => '123456'
}
*/

// mysql_fetch_array($result, MYSQL_NUM)
$row = mysql_fetch_array($result, MYSQL_NUM);
/*
array(2) {
  0 => 'test',
  1 => '123456'
}
*/
?>

二、效能與記憶體分析

函式記憶體佔用速度適用場景
fetch_assoc低(單一索引)最快僅需欄位名存取(最常見)
fetch_array(MYSQL_NUM)低略快於 BOTH需數值索引迭代、效能敏感
fetch_array() (BOTH)高(雙索引,約 2 倍記憶體)較慢同時需要數值與關聯存取(罕見)

建議:99% 場景下 直接使用 fetch_assoc,語意明確、記憶體效率最高、程式碼可讀性最佳。


三、常見陷阱與避坑指南

3.1 同名欄位覆蓋問題

<?php
// SQL: SELECT users.id, posts.id FROM users JOIN posts ...
$row = mysql_fetch_array($result); // MYSQL_BOTH
echo $row['id']; // 只能取得 posts.id(最後一欄)
echo $row[0];    // users.id(數值索引 0)
echo $row[1];    // posts.id(數值索引 1)

// 解決:SQL 使用別名
// SELECT users.id AS user_id, posts.id AS post_id ...
$row = mysql_fetch_assoc($result);
echo $row['user_id'];
echo $row['post_id'];
?>

3.2 欄位名大小寫敏感

mysql_fetch_assoc 回傳鍵名保留 SQL 欄位原始大小寫。資料庫若為小寫欄位名,陣列鍵即為小寫。

3.3 重複呼叫推進指標

<?php
while ($row = mysql_fetch_assoc($result)) {
    // 每次呼叫指標前進一行,直到 false
}
// 指標已在末尾,再次呼叫回傳 false
// 若需重頭:mysql_data_seek($result, 0);
?>

四、現代替代方案:PDO / mysqli 對應表

舊 mysql_* 函式mysqli (程序式)mysqli (物件導向)PDO
mysql_fetch_assoc($res)mysqli_fetch_assoc($res)$res->fetch_assoc()$stmt->fetch(PDO::FETCH_ASSOC)
mysql_fetch_array($res)mysqli_fetch_array($res)$res->fetch_array()$stmt->fetch(PDO::FETCH_BOTH)
mysql_fetch_array($res, MYSQL_NUM)mysqli_fetch_array($res, MYSQLI_NUM)$res->fetch_array(MYSQLI_NUM)$stmt->fetch(PDO::FETCH_NUM)
mysql_fetch_row($res)mysqli_fetch_row($res)$res->fetch_row()$stmt->fetch(PDO::FETCH_NUM)
mysql_fetch_object($res)mysqli_fetch_object($res)$res->fetch_object()$stmt->fetch(PDO::FETCH_OBJ)

4.1 PDO 推薦模式:FETCH_ASSOC + 預處理

<?php
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // 預設關聯模式
    PDO::ATTR_EMULATE_PREPARES => false, // 真實預處理
]);

$stmt = $pdo->prepare('SELECT id, username, email FROM users WHERE status = ?');
$stmt->execute([1]);

while ($row = $stmt->fetch()) { // 直接拿關聯陣列
    echo "{$row['username']} <{$row['email']}>\n";
}

// 一次取全部
$all = $stmt->fetchAll(); // 陣列的陣列
?>

4.2 mysqli 物件導向風格

<?php
$mysqli = new mysqli('localhost', $user, $pass, 'test');
$mysqli->set_charset('utf8mb4');

$stmt = $mysqli->prepare('SELECT id, username FROM users WHERE status = ?');
$stmt->bind_param('i', $status);
$status = 1;
$stmt->execute();
$result = $stmt->get_result(); // 需 mysqlnd

while ($row = $result->fetch_assoc()) {
    echo "{$row['username']}\n";
}
$stmt->close();
?>

五、遷移檢查清單

  1. 全專案搜尋 mysql_ 替換為 mysqli_ 或 PDO。
  2. 移除 mysql_connect/mysql_select_db,改用新連線物件。
  3. 所有查詢改為預處理語句(Prepared Statements),杜絕 SQL 注入。
  4. 統一預設抓取模式為 FETCH_ASSOC(PDO 可全域設定)。
  5. 錯誤處理改用 try-catch + PDO::ERRMODE_EXCEPTION。
  6. 字元集統一設定 utf8mb4(支援 emoji)。

結語

mysql_fetch_assoc 以單一關聯陣列、低記憶體、高效能勝出,是舊 API 中的最佳選擇。現代開發請直接拥抱 PDO(資料庫抽象層、支援多種資料庫、命名參數、例外處理)或 mysqli(MySQL 專用、略高效能),徹底告別已移除的 ext/mysql。

copyright © 萬盛學電腦網 all rights reserved