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。本文僅供維護舊專案或教學參考。
mysql_fetch_array($result, MYSQL_ASSOC)。MYSQL_ASSOC:僅關聯(同 fetch_assoc)MYSQL_NUM:僅數值索引MYSQL_BOTH(預設):雙重索引<?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,語意明確、記憶體效率最高、程式碼可讀性最佳。
<?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'];
?>
mysql_fetch_assoc 回傳鍵名保留 SQL 欄位原始大小寫。資料庫若為小寫欄位名,陣列鍵即為小寫。
<?php
while ($row = mysql_fetch_assoc($result)) {
// 每次呼叫指標前進一行,直到 false
}
// 指標已在末尾,再次呼叫回傳 false
// 若需重頭:mysql_data_seek($result, 0);
?>
| 舊 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) |
<?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(); // 陣列的陣列
?>
<?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();
?>
mysql_ 替換為 mysqli_ 或 PDO。mysql_connect/mysql_select_db,改用新連線物件。FETCH_ASSOC(PDO 可全域設定)。try-catch + PDO::ERRMODE_EXCEPTION。utf8mb4(支援 emoji)。mysql_fetch_assoc 以單一關聯陣列、低記憶體、高效能勝出,是舊 API 中的最佳選擇。現代開發請直接拥抱 PDO(資料庫抽象層、支援多種資料庫、命名參數、例外處理)或 mysqli(MySQL 專用、略高效能),徹底告別已移除的 ext/mysql。