(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.1)
PDO::quote — 為 SQL 查詢里的字符串添加引號
$string
, int $parameter_type
= PDO::PARAM_STR): stringPDO::quote() 為輸入的字符串添加引號(如果有需要),并對特殊字符進行轉(zhuǎn)義,且引號的風(fēng)格和底層驅(qū)動適配。
如果使用此函數(shù)構(gòu)建 SQL 語句,強烈建議使用 PDO::prepare() 配合參數(shù)構(gòu)建,而不是用 PDO::quote() 把用戶輸入的數(shù)據(jù)拼接進 SQL 語句。 使用 prepare 語句處理參數(shù),不僅僅可移植性更好,而且更方便、免疫 SQL 注入;相對于拼接 SQL 更快,客戶端和服務(wù)器都能緩存編譯后的 SQL 查詢。
不是所有的 PDO 驅(qū)動都實現(xiàn)了此功能(例如 PDO_ODBC)。 考慮使用 prepare 代替。
字符集不僅僅要在數(shù)據(jù)庫服務(wù)器上設(shè)置,也要為數(shù)據(jù)庫連接設(shè)置(取決于驅(qū)動),它影響了 PDO::quote()。 更多信息可參考PDO 驅(qū)動文檔。
string
要添加引號的字符串。
parameter_type
為驅(qū)動提示數(shù)據(jù)類型,以便選擇引號風(fēng)格。
返回加引號的字符串,理論上可以安全用于 SQL 語句。 如果驅(qū)動不支持這種方式,將返回 false
。
示例 #1 普通字符串加引號
<?php
$conn = new PDO('sqlite:/home/lynn/music.sql3');
/* 簡單字符串 */
$string = 'Nice';
print "Unquoted string: $string\n";
print "Quoted string: " . $conn->quote($string) . "\n";
?>
以上例程會輸出:
Unquoted string: Nice Quoted string: 'Nice'
示例 #2 危險字符串加引號
<?php
$conn = new PDO('sqlite:/home/lynn/music.sql3');
/* 危險字符串 */
$string = 'Naughty \' string';
print "Unquoted string: $string\n";
print "Quoted string:" . $conn->quote($string) . "\n";
?>
以上例程會輸出:
Unquoted string: Naughty ' string Quoted string: 'Naughty '' string'
示例 #3 復(fù)雜字符串加引號
<?php
$conn = new PDO('sqlite:/home/lynn/music.sql3');
/* 復(fù)雜字符串 */
$string = "Co'mpl''ex \"st'\"ring";
print "Unquoted string: $string\n";
print "Quoted string: " . $conn->quote($string) . "\n";
?>
以上例程會輸出:
Unquoted string: Co'mpl''ex "st'"ring Quoted string: 'Co''mpl''''ex "st''"ring'