久久国产精品视频免费观看,成品人视频ww入口

基礎(chǔ)查詢

執(zhí)行常規(guī)查詢

使用 query 方法提交一個查詢:

$db->query('YOUR QUERY HERE');

執(zhí)行 “讀取” 類型查詢時，query() 方法返回一個數(shù)據(jù)庫查詢結(jié)果對象，如何使用參考顯示查詢結(jié)果；執(zhí)行 “寫入” 類查詢時，只返回 TRUE 或 FALSE ，表示執(zhí)行成功或失敗。檢索數(shù)據(jù)時，你通常需要自行編寫查詢語句，例如:

$query = $db->query('YOUR QUERY HERE');

執(zhí)行簡單查詢

simpleQuery 方法是 $db->query() 的簡化版本。它不會返回查詢結(jié)果，不記錄查詢耗時，不會綁定變量，也不保存查詢語句（用于調(diào)試）。它只是簡單的讓你執(zhí)行一個查詢語句，可能大多數(shù)用戶鮮有使用。

它只返回 “execute” 方法執(zhí)行的返回值，無關(guān)數(shù)據(jù)庫類型。典型的返回值是 TRUE/FALSE ，當(dāng)執(zhí)行類型是寫入型時，它表示寫操作的成功或失敗（插入、刪除或修改，實(shí)際就如此使用）；執(zhí)行讀取類型時，表示能否成功獲取查詢結(jié)果資源/對象。

if ($db->simpleQuery('YOUR QUERY'))
{
        echo "Success!";
}
else
{
        echo "Query failed!";
}

注解

PostgreSQL的 pg_exec() 方法 (舉例) 執(zhí)行成功時總是返回一個資源值，即使執(zhí)行寫入型查詢也是如此。所以當(dāng)你判斷布爾值時要切記此點(diǎn)。

手動指定數(shù)據(jù)表前綴

當(dāng)你配置了數(shù)據(jù)庫的表前綴，執(zhí)行原生SQL查詢等類似操作，應(yīng)當(dāng)給數(shù)據(jù)表增加前綴，你可以使用如下操作:

$db->prefixTable('tablename'); // 輸出 prefix_tablename

出于某些原因，你想以編程的方式修改表前綴，且不想創(chuàng)建新數(shù)據(jù)庫連接時，可以這樣做:

$db->setPrefix('newprefix');
$db->prefixTable('tablename'); // 輸出 newprefix_tablename

你可以用此方法隨時隨地獲取當(dāng)前的表前綴:

$DBPrefix = $db->getPrefix();

保護(hù)標(biāo)識符

許多數(shù)據(jù)庫建議保護(hù)表名和字段名 - 比如 MySQL 使用反引號。 查詢構(gòu)造器會自動保護(hù)它們, 但如果你需要手動保護(hù)標(biāo)識符時，可以這么做:

$db->protectIdentifiers('table_name');

重要

盡管查詢構(gòu)造器會盡可能且適當(dāng)?shù)囊媚闼璧淖侄蚊捅砻?但請注意它不適用于惡意用戶輸入，勿將其用于未處理的用戶數(shù)據(jù)。

當(dāng)你在數(shù)據(jù)庫配置文件里配有表前綴，這個方法還能給表加上前綴，開啟這個功能請在第二個參數(shù)填寫 TRUE（布爾值）:

$db->protectIdentifiers('table_name', TRUE);

查詢轉(zhuǎn)義

執(zhí)行數(shù)據(jù)庫查詢前做數(shù)據(jù)轉(zhuǎn)義是又好又安全的實(shí)踐，CodeIgniter 有三種方法幫到你:

1.$db->escape() 這個方法會判斷數(shù)據(jù)類型，對字符串?dāng)?shù)據(jù)做轉(zhuǎn)義，它也會自動給數(shù)據(jù)加單引號，你無需額外處理:

$sql = "INSERT INTO table (title) VALUES(".$db->escape($title).")";

2.$db->escapeString() 這個方法對傳入數(shù)據(jù)做強(qiáng)制轉(zhuǎn)義，且無關(guān)類型，多數(shù)時候你會用上面的方法而非這個。此方法使用舉例:

$sql = "INSERT INTO table (title) VALUES('".$db->escapeString($title)."')";

3.$db->escapeLikeString() 這個方法用于 LIKE 條件字符串轉(zhuǎn)義，

以確保 LIKE 的通配符 (‘%’, ‘_’) 也能正確的轉(zhuǎn)義。

$search = '20% raise';
$sql = "SELECT id FROM table WHERE column LIKE '%" .
$db->escapeLikeString($search)."%' ESCAPE '!'";

重要

escapeLikeString() 方法使用 ‘!’ (感嘆號) 轉(zhuǎn)義 LIKE 條件中的特殊字符，因為這個方法只轉(zhuǎn)義引號里的字符串，它不能自動添加 ESCAPE '!' 條件，因此你必須手動添加。

查詢綁定

綁定可以讓你用簡單的查詢語法，讓系統(tǒng)將查詢語句合在一起，考慮下這個例子:

$sql = "SELECT * FROM some_table WHERE id = ? AND status = ? AND author = ?";
$db->query($sql, [3, 'live', 'Rick']);

查詢語句的問號會被方法第二個參數(shù)的數(shù)組順次替換。

使用IN條件時，綁定用多維數(shù)組搞定集合:

$sql = "SELECT * FROM some_table WHERE id IN ? AND status = ? AND author = ?";
$db->query($sql, [[3, 6], 'live', 'Rick']);

轉(zhuǎn)化后的語句是:

SELECT * FROM some_table WHERE id IN (3,6) AND status = 'live' AND author = 'Rick'

使用綁定的第二個好處是，它會自動轉(zhuǎn)義輸入值，生成安全的查詢語句。你無需記住要手動轉(zhuǎn)義數(shù)據(jù)這件事 - 引擎會自動幫你完成。

命名綁定

你可以用命名綁定，而不用問號標(biāo)記綁定值的位置，從而允許在查詢中使用鍵名匹配占位符:

$sql = "SELECT * FROM some_table WHERE id = :id: AND status = :status: AND author = :name:";
$db->query($sql, [
        'id'     => 3,
        'status' => 'live',
        'name'   => 'Rick'
]);

注解

查詢語句中的每個鍵名前后【必須】加英文冒號。

錯誤處理

$db->error();

如果你需要獲取最近一次發(fā)生的數(shù)據(jù)庫報錯，error() 方法會返回一個數(shù)組，包含錯誤號和錯誤信息，來看下用例:

if ( ! $db->simpleQuery('SELECT `example_field` FROM `example_table`'))
{
        $error = $db->error(); // Has keys 'code' and 'message'
}

預(yù)編譯查詢

大部分?jǐn)?shù)據(jù)庫引擎支持某種形式的預(yù)編譯語句，使你僅做一次預(yù)編譯，然后在新數(shù)據(jù)集上多次查詢。它消除了 SQL 注入的可能性，因為數(shù)據(jù)是以另一種形式傳給數(shù)據(jù)庫而非查詢語句。當(dāng)你需要多次執(zhí)行相同查詢時，它也相當(dāng)快速。然而，若你想應(yīng)用于所有查詢，這會極大影響性能，因為它通常要訪問數(shù)據(jù)庫兩次。由于查詢構(gòu)造器和數(shù)據(jù)庫連接已經(jīng)處理了轉(zhuǎn)義數(shù)據(jù)，所以，安全方面已經(jīng)為你解決了，但有時候，你也需要通過預(yù)編譯語句或預(yù)編譯查詢來優(yōu)化查詢。

編譯查詢語句

使用 prepare() 方法可輕松完成編譯，它有一個參數(shù)，是函數(shù)閉包，返回一個查詢對象。查詢對象由任一 “最終” 類型的查詢自動生成，包括 insert , update , delete , replace 和 get 。使用查詢構(gòu)造器執(zhí)行查詢可以最輕松地處理此問題。查詢實(shí)際沒有執(zhí)行，傳入的值不重要也不會被處理，僅做占位使用。這樣會返回一個預(yù)編譯查詢對象:

$pQuery = $db->prepare(function($db)
{
    return $db->table('user')
               ->insert([
                    'name'    => 'x',
                    'email'   => 'y',
                    'country' => 'US'
               ]);
});

如果你不想使用查詢構(gòu)造器，你可以手動創(chuàng)建查詢對象，用問號做占位符:

use CodeIgniter\Database\Query;


$pQuery = $db->prepare(function($db)
{
    $sql = "INSERT INTO user (name, email, country) VALUES (?, ?, ?)";


    return (new Query($db))->setQuery($sql);
});

如果數(shù)據(jù)庫要求在預(yù)編譯階段提供選項數(shù)組，可以將數(shù)組放到第二個參數(shù):

use CodeIgniter\Database\Query;


$pQuery = $db->prepare(function($db)
{
    $sql = "INSERT INTO user (name, email, country) VALUES (?, ?, ?)";


    return (new Query($db))->setQuery($sql);
}, $options);

執(zhí)行預(yù)編譯查詢

一旦你有了一個預(yù)編譯查詢，你可以使用 execute() 方法真正的執(zhí)行查詢。你可以傳遞多個你需要的查詢參數(shù)，參數(shù)的個數(shù)必須與占位符個數(shù)相同，參數(shù)的順序也要與原始占位符保持一致:

// 編譯查詢語句
$pQuery = $db->prepare(function($db)
{
    return $db->table('user')
               ->insert([
                    'name'    => 'x',
                    'email'   => 'y',
                    'country' => 'US'
               ]);
});


// 準(zhǔn)備數(shù)據(jù)
$name    = 'John Doe';
$email   = 'j.doe@example.com';
$country = 'US';


// 執(zhí)行查詢
$results = $pQuery->execute($name, $email, $country);

這會返回標(biāo)準(zhǔn)的結(jié)果集.

其他方法

除了上述兩個主要方法，預(yù)編譯查詢還有以下方法可用:

close()

雖然 PHP 在（自動）關(guān)閉所有打開的查詢資源時做的非常好，但手動關(guān)閉執(zhí)行完的預(yù)編譯查詢同樣也是好的主意:

$pQuery->close();

getQueryString()

返回預(yù)編譯查詢的字符串。

hasError()

返回布爾值 true/false ，表示調(diào)用最近一次是否有執(zhí)行錯誤。

getErrorCode() getErrorMessage()

如果有報錯，可以用這兩個方法獲取錯誤號和錯誤信息。

使用查詢對象

在內(nèi)部，所有查詢的處理和存儲都在 CodeIgniterDatabaseQuery 的實(shí)例中進(jìn)行。這個類負(fù)責(zé)綁定參數(shù)、也做預(yù)編譯查詢、還能保存查詢時的性能數(shù)據(jù)。

getLastQuery()

當(dāng)你需要獲取最近一次的查詢對象，請使用 getLastQuery() 方法:

$query = $db->getLastQuery();
echo (string)$query;

查詢類

每個查詢對象都保存了此次查詢的一些信息，它有部分被時間線功能使用，但你也可以使用（譯者注：此處時間線指數(shù)據(jù)庫執(zhí)行SQL過程，記錄它們方便調(diào)試和優(yōu)化性能）。

getQuery()

返回各種編譯構(gòu)造之后的最終查詢語句，也就是發(fā)送到數(shù)據(jù)庫執(zhí)行的語句:

$sql = $query->getQuery();

將查詢對象做字符串轉(zhuǎn)換也能獲得相同的值:

$sql = (string)$query;

getOriginalQuery()

返回初始傳入對象里的 SQL 語句，沒有任何綁定或前綴修飾等等:

$sql = $query->getOriginalQuery();

hasError()

如果執(zhí)行時有任何錯誤，這個方法將返回 true:

if ($query->hasError())
{
        echo 'Code: '. $query->getErrorCode();
        echo 'Error: '. $query->getErrorMessage();
}

isWriteType()

如果當(dāng)前查詢是寫入型 (例如 INSERT, UPDATE, DELETE, 等)，此方法返回 true:

if ($query->isWriteType())
{
        ... do something
}

swapPrefix()

替換最終執(zhí)行的 SQL 里的表前綴，第一個參數(shù)是原始你想替換的前綴，第二個參數(shù)是替換之后你想要的前綴:

$sql = $query->swapPrefix('ci3_', 'ci4_');

getStartTime()

獲取查詢執(zhí)行時間，以秒為單位，精確到毫秒級:

$microtime = $query->getStartTime();

getDuration()

返回執(zhí)行查詢的時長（秒），浮點(diǎn)數(shù)，精確到毫秒:

$microtime = $query->getDuration();

CodeIgniter4 執(zhí)行查詢