萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 使用 mysql_query() 函數執行 SQL 語句完整指南

MySQL 執行查詢的核心函數:mysql_query()

在 PHP 中操作 MySQL 資料庫時,mysql_query() 是最基礎也最常用的函數,負責將 SQL 語句發送給 MySQL 伺服器執行。雖然 PHP 7.0 以上版本已移除此擴充套件(建議改用 PDO 或 MySQLi),但在維護舊專案或理解歷史程式碼時,掌握其用法仍有必要。

函數語法與參數說明

mysql_query(string $query, resource $connection = null): resource|bool
  • query(必填):要執行的 SQL 查詢字串,不需以分號結尾。
  • connection(選填):MySQL 連線識別碼。若省略,則使用最近一次 mysql_connect() 建立的連線;若無現有連線,函數會嘗試無參數呼叫 mysql_connect() 自動建立。

回傳值詳解

回傳值取決於 SQL 語句類型:

  • SELECT、SHOW、EXPLAIN、DESCRIBE:成功時回傳資源識別碼(供 mysql_fetch_array() 等函數讀取),失敗回傳 false。
  • INSERT、UPDATE、DELETE、CREATE 等:成功回傳 true,失敗回傳 false。

重要提醒:非 false 回傳值僅代表查詢語法合法且伺服器接受執行,不代表影響的列數或回傳列數。查詢可能成功執行但影響 0 列。

常見用法範例

範例 1:基本查詢流程

$con = mysql_connect("localhost", "mysql_user", "mysql_pwd");
if (!$con) {
    die('連線失敗: ' . mysql_error());
}
$sql = "SELECT * FROM Person";
$result = mysql_query($sql, $con);
// 後續處理 $result ...
mysql_close($con);

範例 2:建立資料庫並判斷結果

$con = mysql_connect("localhost", "mysql_user", "mysql_pwd");
if (!$con) {
    die('連線失敗: ' . mysql_error());
}
$sql = "CREATE DATABASE my_db";
if (mysql_query($sql, $con)) {
    echo "資料庫 my_db 建立成功";
} else {
    echo "建立失敗: " . mysql_error();
}
mysql_close($con);

效能提示:非緩存查詢

mysql_query() 預設會自動讀取並緩存整個結果集。若需處理大量資料且不想佔用過多記憶體,可改用 mysql_unbuffered_query(),它會逐列讀取,適合串流式處理。

遷移建議

新專案請直接使用 PDO 或 MySQLi(支援預處理語句),兩者皆提供更好的安全性、物件導向介面與錯誤處理機制。

copyright © 萬盛學電腦網 all rights reserved