SQLite3::escapeString

(PHP 5 >= 5.3.0, PHP 7)

SQLite3::escapeString — Returns a string that has been properly escaped

说明

public static string SQLite3::escapeString ( string $value )

Returns a string that has been properly escaped for safe inclusion in an SQL statement.

Warning

此函数（还）不能安全地适用于二进制对象！

To properly handle BLOB fields which may contain NUL characters, use SQLite3Stmt::bindParam() instead.

参数

value: The string to be escaped.

返回值

Returns a properly escaped string that may be used safely in an SQL statement.

注释

Warning

addslashes() should NOT be used to quote your strings for SQLite queries; it will lead to strange results when retrieving your data.

User Contributed Notes

nhl261 at yahoo dot com 26-Sep-2014 06:11


Be careful if the string contains "\0" char.

see: https://bugs.php.net/bug.php?id=63419

alec at alecnewman dot com 09-Aug-2010 11:14


The reason this function doesn't escape double quotes is because double quotes are used with names (the equivalent of backticks in MySQL), as in table or column names, while single quotes are used for values.



This is important to remember, especially coming from another SQL implementation.  It can cause strange problems, for example, the query:



SELECT * FROM table WHERE column1="column1"



Would actually return every record, because column1 is always equal to column1.  This should instead be:



SELECT * FROM table WHERE column1='column1'



Double quotes are not escaped by the function because they are not interpreted specially within single quoted strings.