Call to undefined function mysql_connect() 是 PHP 初學者最常遇到的錯誤之一。本文說明錯誤原因、版本演進脈絡、完整解決步驟與現代替代方案。
mysql_* 系列函數已在 PHP 7.0.0 正式移除(PHP 5.5.0 起棄用)。若你的 PHP 版本 ≥ 7.0,直接呼叫 mysql_connect()、mysql_query() 等函數會拋出此致命錯誤。
| PHP 版本 | 狀態 | 建議 |
|---|---|---|
| PHP 4 / 5.0 - 5.4 | 原生支援 mysql_* | 已停止維護,勿使用 |
| PHP 5.5 | 棄用,產生 E_DEPRECATED | 開始遷移 |
| PHP 5.6 | 棄用警告更明顯 | 儘速遷移 |
| PHP 7.0+ | 完全移除,函數不存在 | 必須改用 mysqli 或 PDO |
若你仍在維護舊版 PHP 環境,錯誤通常因:
php.ini 中 ;extension=php_mysql.dll 前的分號未移除ext/php_mysql.dll 不存在extension_dir 設定錯誤php.ini 或 ext 目錄權限不足; php.ini
extension_dir = "ext"
extension=php_mysql.dll ; 移除前面分號
; 確認 ext/php_mysql.dll 存在
; 重啟 Web 服務
<?php
// 連線
$mysqli = mysqli_connect('localhost', 'user', 'password', 'database');
if (!$mysqli) {
die('連線失敗: ' . mysqli_connect_error());
}
mysqli_set_charset($mysqli, 'utf8mb4');
// 查詢
$result = mysqli_query($mysqli, 'SELECT * FROM users');
while ($row = mysqli_fetch_assoc($result)) {
echo $row['username'];
}
mysqli_free_result($result);
// 預處理語句(防 SQL 注入)
$stmt = mysqli_prepare($mysqli, 'SELECT * FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $id);
mysqli_stmt_execute($stmt);
$result = mysqli_stmt_get_result($stmt);
// 關閉
mysqli_close($mysqli);
<?php
$mysqli = new mysqli('localhost', 'user', 'password', 'database');
if ($mysqli->connect_errno) {
die('連線失敗: ' . $mysqli->connect_error);
}
$mysqli->set_charset('utf8mb4');
// 查詢
$result = $mysqli->query('SELECT * FROM users');
while ($row = $result->fetch_assoc()) {
echo $row['username'];
}
$result->free();
// 預處理
$stmt = $mysqli->prepare('SELECT * FROM users WHERE id = ?');
$stmt->bind_param('i', $id);
$stmt->execute();
$result = $stmt->get_result();
<?php
$dsn = 'mysql:host=localhost;dbname=database;charset=utf8mb4';
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
try {
$pdo = new PDO($dsn, 'user', 'password', $options);
// 查詢
foreach ($pdo->query('SELECT * FROM users') as $row) {
echo $row['username'];
}
// 預處理
$stmt = $pdo->prepare('SELECT * FROM users WHERE id = ?');
$stmt->execute([$id]);
$user = $stmt->fetch();
} catch (PDOException $e) {
die('資料庫錯誤: ' . $e->getMessage());
}
| 舊函數 | mysqli (OO) | PDO |
|---|---|---|
| mysql_connect() | new mysqli() | new PDO() |
| mysql_select_db() | 建構子指定 / $mysqli->select_db() | DSN 指定 |
| mysql_query() | $mysqli->query() | $pdo->query() |
| mysql_fetch_assoc() | $result->fetch_assoc() | $stmt->fetch() |
| mysql_num_rows() | $result->num_rows | $stmt->rowCount() (SELECT 不準確,建議另查 COUNT) |
| mysql_real_escape_string() | $mysqli->real_escape_string() | **不需,用 Prepared Statement** |
| mysql_close() | $mysqli->close() | $pdo = null |
| mysql_error() | $mysqli->error | $e->getMessage() |
| mysql_insert_id() | $mysqli->insert_id | $pdo->lastInsertId() |
mysql_* → mysqli 規則php -vcharset=utf8mb4 解決中文編碼問題PDO::ERRMODE_EXCEPTION 統一例外處理棄用 mysql_* 不只是修正錯誤,更是邁向安全、現代化 PHP 開發的必要步驟。