萬盛學電腦網

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

解決 PHP「Call to undefined function mysql_connect()」錯誤

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 5.6 以下)的常見誤設

若你仍在維護舊版 PHP 環境,錯誤通常因:

  1. 未啟用擴展: php.ini 中 ;extension=php_mysql.dll 前的分號未移除
  2. 擴展檔案缺失: ext/php_mysql.dll 不存在
  3. 路徑錯誤: extension_dir 設定錯誤
  4. 權限問題: php.ini 或 ext 目錄權限不足

舊環境修正步驟

; php.ini
extension_dir = "ext"
extension=php_mysql.dll  ; 移除前面分號

; 確認 ext/php_mysql.dll 存在
; 重啟 Web 服務

現代解決方案:遷移至 mysqli 或 PDO

方案一:mysqli(程式風格,最接近 mysql_*)

<?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);

方案二: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();

方案三:PDO(資料庫抽象層,最推薦)

<?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()

自動化遷移工具

  • php-shift/php-shift:付費自動化升級服務
  • Rector:開源程式碼重構工具,支援 mysql_* → mysqli 規則
  • 正則批次取代:僅適用簡單專案,需人工審查

總結

  1. 確認 PHP 版本:php -v
  2. 若 ≥ 7.0,**必須重寫資料庫存取層**,改用 mysqli 或 PDO
  3. 採用 Prepared Statements 徹底防止 SQL 注入
  4. 設定 charset=utf8mb4 解決中文編碼問題
  5. 啟用錯誤模式 PDO::ERRMODE_EXCEPTION 統一例外處理

棄用 mysql_* 不只是修正錯誤,更是邁向安全、現代化 PHP 開發的必要步驟。

copyright © 萬盛學電腦網 all rights reserved