PHP如何初始化PDO及原始SQL語句操作

PDO 實例

首先來看看一個 PDO 實例是如何初始化的。

$dns = 'mysql:host=localhost;dbname=blog_test;port=3306;charset=utf8';
$pdo = new PDO($dns, 'root', '');

普通情況下,我們直接實例化的時候傳遞構造參數就可以獲得一個 PDO 對象。這樣,我們就和數據庫建立瞭連接。如果連接失敗,也就是參數寫得有問題的時候,在實例化時直接就會報異常。

PDO 對象的參數包括 DNS 信息、用戶名、密碼,另外還有一個參數就是可以設置 PDO 連接的一些屬性,我們將在後面看到它的使用。

dns 參數

PDO 構造參數的第一個參數是一個 DNS 字符串。在這個字符串中使用分號 ; 分隔不同的參數內容。它裡面可以定義的內容包括:

  • DSN prefix,也就是我們要連接的數據庫類型,MySQL 數據庫一般都是直接使用 mysql: 這樣來定義即可。
  • host,連接的地址,在這裡我們連接的是本地數據庫 localhost
  • port,端口號,MySQL 默認為 3306 ,可以不寫
  • dbname,要連接的數據庫名稱
  • unix_socket,可以指定 MySQL 的 Unix Socket 文件
  • charset,連接的字符集

我們可以通過一個函數來查看當前 PHP 環境中所支持的數據庫擴展都有哪些:

print_r(PDO::getAvailableDrivers());exit;
// Array
// (
//     [0] => dblib
//     [1] => mysql
//     [2] => odbc
//     [3] => pgsql
//     [4] => sqlite
// )

PDO 對象屬性

PDO 構造參數的最後一個參數可以設置連接的一些屬性,如:

$pdo = new PDO($dns, 'root', '', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
showPdoAttribute($pdo);
// ……
// PDO::ATTR_ERRMODE: 2
// ……

showPdoAttribute() 方法是我們自己封裝的一個展示所有連接屬性的函數。

// 顯示pdo連接屬性
function showPdoAttribute($pdo){
    $attributes = array(
        "DRIVER_NAME", "AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS",
        "ORACLE_NULLS", "PERSISTENT", "SERVER_INFO", "SERVER_VERSION"
    );
    
    foreach ($attributes as $val) {
        echo "PDO::ATTR_$val: ";
        echo $pdo->getAttribute(constant("PDO::ATTR_$val")) . "\n";
    }
}

在這個函數中,我們使用 PDO 實例的 getAttribute() 方法來獲取相應的屬性值。在沒有設置 PDO::ATTR_ERRMODE 時,它的默認值為 0 ,也就是 PDO::ERRMODE_SILENT 常量所對應的值。在上述代碼中,我們將它設置為瞭 PDO::ERRMODE_EXCEPTION ,查看屬性輸出的結果就變成瞭 2 。

除瞭在構造函數的參數中設置屬性外,我們也可以使用 PDO 實例的 setAttribute() 方法來設置 PDO 的屬性值。

pdo2 = new PDO($dns, 'root', '', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);

echo $pdo2->getAttribute(PDO::ATTR_DEFAULT_FETCH_MODE), PHP_EOL;
// 4

// 設置屬性
$pdo2->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
echo $pdo2->getAttribute(PDO::ATTR_DEFAULT_FETCH_MODE), PHP_EOL;
// 2

在這段代碼中,我們設置 PDO::ATTR_DEFAULT_FETCH_MODE 為 PDO::FETCH_ASSOC 。這樣,在使用這個 $pdo2 的連接進行查詢時,輸出的結果都會是以數組鍵值對形式返回的內容。我們馬上就進入查詢方面相關函數的學習。

查詢語句

大多數情況下,使用 PDO 我們都會用它的預處理能力來編寫 SQL 語句,一來是性能更好,二來是更加安全。不過我們今天先不講預處理方面的問題,還是以最原始的直接操作 SQL 語句的方式學習相關的一些函數。

普通查詢及遍歷

// 普通查詢 - 遍歷1
$stmt = $pdo->query('select * from zyblog_test_user limit 5');
foreach ($stmt as $row) {
    var_dump($row);
}

// array(8) {
//     ["id"]=>
//     string(3) "204"
//     [0]=>
//     string(3) "204"
//     ["username"]=>
//     string(5) "three"
//     [1]=>
//     string(5) "three"
//     ["password"]=>
//     string(6) "123123"
//     [2]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "ccc"
//     [3]=>
//     string(3) "ccc"
//   }
//   ……

// 普通查詢 - 遍歷2
$stmt = $pdo->query('select * from zyblog_test_user limit 5');

while ($row = $stmt->fetch()) {
    var_dump($row);
}

// array(8) {
//     ["id"]=>
//     string(3) "204"
//     [0]=>
//     string(3) "204"
//     ["username"]=>
//     string(5) "three"
//     [1]=>
//     string(5) "three"
//     ["password"]=>
//     string(6) "123123"
//     [2]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "ccc"
//     [3]=>
//     string(3) "ccc"
//   }
//   ……

PDO 實例的 query() 方法就是執行一條查詢語句,並返回一個 PDOStatement 對象。通過遍歷這個對象,就可以獲得查詢出來的數據結果集。

在代碼中,我們使用瞭兩種方式來遍歷,其實它們的效果都是一樣的。在這裡,我們要關註的是返回的數據格式。可以看出,數據是以數組格式返回的,並且是以兩種形式,一個是數據庫定義的鍵名,一個是以下標形式。

查詢結果集(數組、對象)

其實大部分情況下,我們隻需要數據庫鍵名的那種鍵值對形式的數據就可以瞭。這個有兩種方式,一是直接使用上文中我們定義好默認 PDO::ATTR_DEFAULT_FETCH_MODE 屬性的 $pdo2 連接,另一個就是在查詢的時候為 query() 方法指定屬性。

$stmt = $pdo2->query('select * from zyblog_test_user limit 5');
foreach ($stmt as $row) {
    var_dump($row);
}
// array(4) {
//     ["id"]=>
//     string(1) "5"
//     ["username"]=>
//     string(3) "two"
//     ["password"]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "bbb"
//   }
//   ……

$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_ASSOC);
foreach ($stmt as $row) {
    var_dump($row);
}
// array(4) {
//     ["id"]=>
//     string(1) "5"
//     ["username"]=>
//     string(3) "two"
//     ["password"]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "bbb"
//   }
//   ……

當然,我們也可以直接讓數據返回成對象的格式,同樣的也是使用預定義的常量來指定 query() 或者 PDO 實例連接的屬性就可以瞭。

$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_OBJ);
foreach ($stmt as $row) {
    var_dump($row);
}
// object(stdClass)#4 (4) {
//     ["id"]=>
//     string(1) "5"
//     ["username"]=>
//     string(3) "two"
//     ["password"]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "bbb"
//   }
//   ……

查詢結果集(類)

上面返回對象形式的結果集中的對象是 stdClass 類型,也就是 PHP 的默認類類型。那麼我們是否可以自己定義一個類,然後在查詢完成後直接生成它的結果集呢?就是像是 ORM 框架一樣,完成數據到對象的映射。既然這麼說瞭,那當然是可以的啦,直接看代碼。

class user
{
    public $id;
    public $username;
    public $password;
    public $salt;

    public function __construct()
    {
        echo 'func_num_args: ' . func_num_args(), PHP_EOL;
        echo 'func_get_args: ';
        var_dump(func_get_args());
    }
}

class user2
{

}
// 返回指定對象
$u = new user;
$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_INTO, $u);
foreach ($stmt as $row) {
    var_dump($row);
}
// object(user)#3 (4) {
//     ["id"]=>
//     string(1) "5"
//     ["username"]=>
//     string(3) "two"
//     ["password"]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "bbb"
//   }
//   ……

// 空類測試
$u = new user2;
$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_INTO, $u);
foreach ($stmt as $row) {
    var_dump($row);
}

// object(user2)#2 (4) {
//     ["id"]=>
//     string(1) "5"
//     ["username"]=>
//     string(3) "two"
//     ["password"]=>
//     string(6) "123123"
//     ["salt"]=>
//     string(3) "bbb"
//   }
//   ……

在這段代碼中,我們定義瞭兩個類,user 類有完整的和數據庫字段對應的屬性,還定義瞭一個構造方法(後面會用到)。而 user2 類則是一個空的類。通過測試結果來看,類的屬性對於 PDO 來說並不重要。它會默認創建數據庫查詢到的字段屬性,並將它賦值給對象。那麼假如我們定義瞭一個 const 常量屬性並給予相同的字段名稱呢?大傢可以自己嘗試一下。

對於 user 和 user2 來說,我們將它實例化瞭並傳遞給瞭 query() ,並且指定瞭結果集格式為 PDO::FETCH_INTO ,這樣就實現瞭獲取對象結果集的能力。但是 PDO 遠比你想象的強大,我們還可以直接用類模板來獲取查詢結果集。

// 根據類返回指定對象
$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_CLASS, 'user', ['x1', 'x2']);
foreach ($stmt as $row) {
    var_dump($row);
}
// func_num_args: 2
// func_get_args: array(2) {
//   [0]=>
//   string(2) "x1"
//   [1]=>
//   string(2) "x2"
// }
// object(user)#4 (4) {
//   ["id"]=>
//   string(1) "5"
//   ["username"]=>
//   string(3) "two"
//   ["password"]=>
//   string(6) "123123"
//   ["salt"]=>
//   string(3) "bbb"
// }
// ……

query() 方法直接使用查詢結果集模式為 PDO::FETCH_CLASS ,並傳遞一個類模板的名稱,PDO 就會在當前代碼中查找有沒有對應的類模板,獲得的每個結果都會實例化一次。在這裡,我們又多瞭一個參數,最後一個參數是一個數組,並且給瞭兩個元素。估計有不少小夥伴已經看出來瞭,這個參數是傳遞給類的構造方法的。記住,使用這個模式,每個元素都會實例化一次,結果集中的每個元素都是新創建的類(object(user2)#3,#號後面的數字是不同的對象句柄id),而 PDO::FETCH_INTO 則是以引用的形式為每個元素賦值(object(user2)#3,#號後面的數字是相同的對象句柄id)。也就是說,我們使用 PDO::FETCH_INTO 模式的時候,修改一個元素的值,其它的元素也會跟著改變,如果使用一個數組去記錄遍歷的元素值,最後數組的結果也會是相同的最後一個元素的內容。

$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_INTO, $u);
$resArr = [];
foreach ($stmt as $row) {
    var_dump($row);
    $resArr[] = $row;
}
$resArr[0]->id = 55555;
print_r($resArr);
// Array
// (
//     [0] => user2 Object
//         (
//             [id] => 55555
//             [username] => two
//             [password] => 123123
//             [salt] => bbb
//         )

//     [1] => user2 Object
//         (
//             [id] => 55555
//             [username] => two
//             [password] => 123123
//             [salt] => bbb
//         )

//     [2] => user2 Object
//         (
//             [id] => 55555
//             [username] => two
//             [password] => 123123
//             [salt] => bbb
//         )

//     [3] => user2 Object
//         (
//             [id] => 55555
//             [username] => two
//             [password] => 123123
//             [salt] => bbb
//         )

//     [4] => user2 Object
//         (
//             [id] => 55555
//             [username] => two
//             [password] => 123123
//             [salt] => bbb
//         )

// )

如何解決這個問題呢?最簡單的方式就是在數組賦值的時候加個 clone 關鍵字唄!

查詢結果集(指定字段)

最後輕松一點,我們看下 query() 方法還可以指定查詢的某一個字段。

// 隻返回第幾個字段
$stmt = $pdo->query('select * from zyblog_test_user limit 5', PDO::FETCH_COLUMN, 2);
foreach ($stmt as $row) {
    var_dump($row);
}
// string(32) "bbff8283d0f90625015256b742b0e694"
// string(6) "123123"
// string(6) "123123"
// string(6) "123123"
// string(6) "123123"

增、刪、改操作

除瞭查詢之外的操作,我們也可以使用 exec() 方法來執行其他一些相應的 SQL 語句。

增加操作

$count = $pdo->exec("insert into zyblog_test_user(`username`, `password`, `salt`) value('akk', 'bkk', 'ckk')");
$id = $pdo->lastInsertId();

var_dump($count); // int(1)
var_dump($id); // string(3) "205"

exec() 返回的是影響的行數,如果我們執行這一條 SQL ,返回的就是成功添加瞭一行數據。如果要獲得新增加數據的 id ,就要使用 lastInserId() 方法來獲取。

$count = $pdo->exec("insert into zyblog_test_user(`username`, `password`, `salt`) value('akk', 'bkk', 'ckk', 'dkk')");
// Fatal error: Uncaught PDOException: SQLSTATE[21S01]: Insert value list does not match column list: 1136 Column count doesn't match value count at row 1

執行錯誤的 SQL 語句,就像根據 PDO::ATTR_ERRMODE 屬性的設置來返回錯誤信息。我們在最上面的實例化 PDO 代碼中指定瞭錯誤形式是異常處理模式,所以這裡直接就會報 PDOException 異常。

修改操作

// 正常更新
$count = $pdo->exec("update zyblog_test_user set `username`='aakk' where id='{$id}'");

var_dump($count); // int(1)

// 數據不變更新
$count = $pdo->exec("update zyblog_test_user set `username`='aakk' where id='{$id}'");
var_dump($count); // int(0)

// 條件錯誤更新
$count = $pdo->exec("update zyblog_test_user set `username`='aakk' where id='123123123123'");
var_dump($count); // int(0)
echo '===============', PHP_EOL;

同樣的,在執行更新操作的時候,exec() 返回的也是受影響的行數。很多小夥伴會以這個進行判斷是否更新成功,但如果數據沒有修改,那麼它返回的將是 0 ,SQL 語句的執行是沒有問題的,邏輯上其實也沒有問題。比如我們在後臺打開瞭某條數據查看,然後並不想更新任何內容就直接點瞭提交,這時候不應該出現更新失敗的提示。也就是說,在前端判斷更新操作的時候,需要判斷字段是否都有改變,如果沒有改變的話那麼不應該提示更新失敗。這一點是業務邏輯上的考慮問題,如果你認為這樣也是更新失敗的話,那麼這麼報錯也沒有問題,一切以業務形式為主。

刪除操作

$count = $pdo->exec("delete from zyblog_test_user where id = '{$id}'");
var_dump($count); // int(1)

// 條件錯誤刪除
$count = $pdo->exec("delete from zyblog_test_user where id = '5555555555'");
var_dump($count); // int(0)

刪除操作需要註意的問題和更新操作是一樣的,那就是同樣的 exec() 隻是返回影響行數的問題,不過相對於更新操作來說,沒有受影響的行數那肯定是刪除失敗的,沒有數據被刪除。同樣的,這個失敗的提示也請根據業務情況來具體分析。

總結

不學不知道,一學嚇一跳吧,簡簡單的一個 PDO 的創建和語句執行竟然有這麼多的內容。對於我們的日常開發來說,掌握這些原理能夠避免很多莫名其妙的問題,比如上面 exec() 隻是返回影響行數在業務開發中如何判斷操作是否成功的問題就很典型。好瞭,這隻是第一篇,後面的學習不要落下瞭哦!

測試代碼

以上就是PHP如何初始化PDO及原始SQL語句操作的詳細內容,更多關於PHP 初始化PDO及原始SQL語句操作的資料請關註WalkonNet其它相關文章!

推薦閱讀: