本文介紹 PHP 5 起新增的 API 擴充——MySQLi,用於連接 MySQL 資料庫。
起因是讀《Ajax and PHP: Building Responsive Web Applications》時,發現書中範例改用 MySQLi 連線。如果你照著書做,Ajax 一直沒有反應,問題很可能就出在這個擴充沒開。
先修改 php.ini,找到這一行:
;extension=php_mysqli.dll
去掉前面的分號:
extension=php_mysqli.dll
重新啟動 Apache 或 IIS 即可生效。
補充幾點:PHP 需要獨立的 DLL 來支援這個擴充,通常可以在 PHP 目錄下的 ext 資料夾找到 php_mysqli.dll(PHP 5.0.2 之前的版本名為 libmysqli.dll);php.ini 中的 extension_dir 必須正確指向 ext 目錄;若缺這個檔案,可從 PHP 5 的原始碼包取得。另外,此擴充僅能在 PHP 5 以上版本使用。
MySQLi 是「MySQL, Improved」的縮寫,只適用於 PHP 5,可用於 MySQL 4.1.1 及後續版本。它完整支援 MySQL 5.1 採用的認證協定,也支援預處理陳述式(prepared statements)與多陳述式 API,此外還提供了先進的物件導向介面。
MySQLi 類別代表 PHP 與 MySQL 之間的連線。建構子為 mysqli,用來建立新的連線物件。
常用方法包含:connect/real_connect(建立連線)、query(執行查詢)、prepare(準備陳述式)、multi_query(執行多個查詢)、commit/rollback/autocommit(交易控制)、select_db(切換預設資料庫)、set_charset(設定字元集)、escape_string(跳脫特殊字元)、store_result/use_result(取得結果集)、close(關閉連線)、ping(檢測/重連)、stat(系統狀態)與 info(最近查詢資訊)等。
常用屬性則有 affected_rows、insert_id、errno/error、sqlstate、field_count、host_info、client_version、server_version、protocol_version、thread_id 與 warning_count。
<?php
/* 連接資料庫伺服器 */
$link = mysqli_connect(
'localhost', /* MySQL 位址 */
'user', /* 使用者名稱 */
'password', /* 密碼 */
'world'); /* 預設資料庫 */
if (!$link) {
printf("無法連接 MySQL 伺服器,錯誤碼:%s ", mysqli_connect_error());
exit;
}
/* 向伺服器發送查詢 */
if ($result = mysqli_query($link,
'SELECT Name, Population FROM City ORDER BY Population DESC LIMIT 5')) {
print("人口最多的城市:");
/* 取出查詢結果 */
while ($row = mysqli_fetch_assoc($result)) {
printf("%s (%s) ", $row['Name'], $row['Population']);
}
/* 釋放結果集占用的記憶體 */
mysqli_free_result($result);
}
/* 關閉連線 */
mysqli_close($link);
?>
相比舊的 mysql_* 系列函式,MySQLi 帶來三個關鍵改善:物件導向介面讓程式碼結構更清楚;預處理陳述式把資料與 SQL 分離,是防 SQL 注入的正規做法;交易控制讓跨表操作能確實做到全有或全無。新專案沒有理由再沿用舊介面。