SQLite3::escapeString

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

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

    Description

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

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

    Warning

    This function is not (yet) binary safe!

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

    Parameters

    string

    The string to be escaped.

    Return Values

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

    Notes

    Warning

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

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    2
    alec at alecnewman dot com
    14 years ago
    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.
    up
    0
    nhl261 at yahoo dot com
    10 years ago
    Be careful if the string contains "\0" char.
    see: https://bugs.php.net/bug.php?id=63419
    ＋add a note
    To Top