MySQL mysql_query() 執行 SQL 語句完整指南：語法、返回值與最佳實踐

mysql_query() 是 PHP 早期 MySQL 擴展的核心函數，用於向 MySQL 服務器發送 SQL 查詢或命令。本文系統講解語法、參數、返回值語義、事務行為、緩存特性及現代 mysqli/PDO 遷移指南。

一、 函數定義與語法

resource|bool mysql_query(string $query [, resource $link_identifier = NULL ])

• $query：要執行的 SQL 語句。**字符串不應以分號結尾**。
• $link_identifier：可選，連接標識符。省略時使用最近打開的連接；若無連接，嘗試無參數調用 mysql_connect() 建立。

二、 返回值語義詳解（核心必讀）

關鍵誤區： 返回 true/資源僅表示「語法合法且服務器接受執行」，**不代表有行被影響或返回**。需用 mysql_affected_rows() 或 mysql_num_rows() 確認實際影響。

三、 自動緩存與非緩存查詢

• 默認行為： mysql_query() 自動讀取並緩存**整個結果集**到客戶端內存。大結果集易導致 OOM。
• 非緩存查詢： 使用 mysql_unbuffered_query()，結果逐行從服務器流式讀取，內存佔用極低，但需讀完才能發送下一條查詢（同一連接下）。

四、 實戰代碼範例

1. 基礎查詢

<?php
$con = mysql_connect("localhost", "mysql_user", "mysql_pwd");
if (!$con) die('Connect failed: ' . mysql_error());

$sql = "SELECT * FROM Person";
$result = mysql_query($sql, $con);
// 處理結果集...
mysql_close($con);
?>

2. 執行 DDL：創建數據庫

<?php
$con = mysql_connect("localhost", "mysql_user", "mysql_pwd");
if (!$con) die('Connect failed: ' . mysql_error());

$sql = "CREATE DATABASE my_db";
if (mysql_query($sql, $con)) {
    echo "Database my_db created";
} else {
    echo "Error creating database: " . mysql_error();
}
?>

五、 關鍵限制與遷移指南

遷移對照表：mysqli 面向對象風格

預處理語句（防注入標準寫法）

$stmt = $mysqli->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->bind_param("ss", $name, $email);
$stmt->execute();
echo "新用戶 ID: " . $stmt->insert_id;

六、 總結

mysql_query() 曾是 PHP 操作 MySQL 的入口函數，但**已徹底淘汰**。理解其返回值語義、緩存行為對維護舊代碼有幫助，但所有新開發**必須使用 mysqli 或 PDO**，並採用**預處理語句**作為防注入基線，構建安全、高效、可維護的數據訪問層。

1. 上一篇文章： MySQL mysql_stat() 獲取服務器狀態：語法、返回值與實戰監控
2. 下一篇文章： MySQL ISNULL 與 IS NULL 深度解析：函數差異、索引利用與高效寫法

MySQL 資料庫相關知識

MySQL 環境變數與客戶端程式完整參考手冊

核心環境變數 所有基於 mysqlclient 函式庫的 M

MySQL 資料類型系統基礎：明確類型 vs 隱含類型、表定義與運算式中的類型推導

資料類型無處不在 資料庫管理系統核心使命是管理資料。即使 S

Sybase 資料庫亂碼問題完整解決方案：字符集 CP936 安裝與配置詳解

部署測試環境時常遇到 Sybase 讀取中文出現亂碼，主因是

解決 Java 程式連接 MySQL 時中文亂碼問題的完整指南

在 Java 應用程式開發中，連接 MySQL 資料庫時遇到