Edit Report a Bug

    sqlite_escape_string

    (PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)

    sqlite_escape_string — クエリパラメータ用に文字列をエスケープする

    説明

    sqlite_escape_string ( string $item ) : string

    sqlite_escape_string() は、 item で指定した文字列を SQLite SQLステートメントで使用できるように正しくクオートします。 この際、シングルクオート(')は2重にされ、 クエリ文字列のバイナリセーフでない文字がチェックされます。

    このエンコーディングは、データ挿入を安全に行いますが、 テキスト比較は単純化され、バイナリデータを含むカラムについては クエリの中でLIKE句を使用できません。 実際には、バイナリカラムでこのようなことをするスキーマにはしないの で、これが問題になることはないでしょう (実際には、ファイルのような他の手段でバイナリデータを保存する方が良 いでしょう)。

    パラメータ

    item

    クォートしたい文字列。

    itemがNUL文字を含む場合、 または、16進表現の0x01で始まる場合、 PHPはバイナリデータを安全に保存/取得するためのバイナリエンコーディ ングを適用します。

    返り値

    SQLite の SQL 文で使用できる形式にエスケープした文字列を返します。

    注意

    注意: この関数を sqlite_create_function()または sqlite_create_aggregate()により作成したUDFから 返す値をエンコードするために使用しないでください。 代わりに sqlite_udf_encode_binary() を使用して ください。

    警告

    addslashes()をSQLiteクエリの文字列をクオート するために使用するべきではありません。さもないと、 データを取得する際に奇妙な結果を発生する可能性があります。

    参考

    add a note add a note

    User Contributed Notes 4 notes

    up
    3
    carlo_greco at live dot it
    14 years ago
    You can try this (it works with strings and arrays):

    <?php
    // oop

    class sqlite extends SQLiteDatabase {
        public function     escape($data) {
            if(    is_array($data))
                return     array_map("sqlite_escape_string", $data);

            return     sqlite_escape_string($data);
        }
    }

    $db = new sqlite("dbname");
    $values = array("hell'o", "he'y");
    $values = $db->escape($values); // returns array("hell''o", "hey''y")

    // procedural

    function sqlite_myescape($data) {
        if(    is_array($data))
            return     array_map("sqlite_escape_string", $data);

        return     sqlite_escape_string($data);
    }

    $values = array("hell'o", "he'y");
    $values = sqlite_myescape($values); // returns array("hell''o", "hey''y")
    ?>
    up
    1
    soletan at toxa dot de
    19 years ago
    @minots: simplify what you are doing:

    <?php

    function sqlite_escape_array( &$arr ) {

          $invalid = array( 'argv', 'argc' );

      foreach (     $arr as $key => $val )
         if ( (     strtoupper( $key ) != $key ) && !is_numeric( $key ) && !in_array( $key, $invalid ) ) {
           if (     is_string( $val ) )
                   $arr[$key] = sqlite_escape_string( $val );
           else if (     is_array( $val ) )
                   sqlite_escape_array( $arr[$key] );
         }

      return     $arr;
    }

    ?>

    I'm not sure if the condition is equivalent to yours, but this excludes any numeric key, any completely uppercase'd keys and some selected (argc and argv) special keys. In case of never passing $GLOBALS or $_SERVER as argument one might shorten everything to this as a "pipelined" version:

    <?php

    function sqlite_escape_array( $arr ) {

      foreach (     $arr as $key => $val )

        if (     is_string( $val ) )
              $arr[$key] = sqlite_escape_string( $val );

        else if (     is_array( $val ) )
              $arr[$key] = sqlite_escape_array( $val );

      return     $arr;

    }

    ?>

    PHP's syntax is more powerful than those of many other languages, even when it's supporting their one's as well.
    up
    1
    20 years ago
    sometimes i you have to escape an array instead of a string.
    my function to do it works like:
    array sqlite_escape_array ( &array string)

    <?php
    function sqlite_escape_array(&$arr)
    {
      while ( list(    $key, $val) = each($arr) ):
        if ( (    strtoupper($key)!=$key OR "".intval($key) == "$key") && $key!="argc" and $key!="argv"):
            if (    is_string($val)):
                    $arr[$key]=sqlite_escape_string($val);
            endif;
            if (    is_array($val)):
                    $arr[$key]=sqlite_escape_array($val);
            endif;
        endif;
      endwhile;
      return     $arr;
    }
    ?>
    up
    -1
    jwzumwalt at neatinfo dot com
    12 years ago
    sqlite_escape_string() does not catch all HTML characters that may 
    conflict with a browser display. Notice the difference with the
    custom routine below

    <?php
    # php lib command
    $str = "Advoid! /slashes\, 'single' and these <too>";
    $str = sqlite_escape_string($str);
    echo     "<br>$str<br>";

    # custom function
    $str = "Advoid! /slashes\, 'single' and these <too>";
    $str = clean($str);
    echo     "<br>$str<br>";

    function     clean($str) {
          $search  = array('&'    , '"'     , "'"    , '<'   , '>'    );
          $replace = array('&amp;', '&quot;', '&#39;', '&lt;', '&gt;' );

          $str = str_replace($search, $replace, $str);
      return     $str;
    }
    ?>

    Output:
    Advoid! /slashes\, "single" and these
    Advoid! /slashes\, 'single' and these <too>
    add a note add a note
    To Top