[edit] Last updated: Fri, 17 May 2013

sqlite_udf_encode_binary

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

sqlite_udf_encode_binary — Codifica i dati binari prima di restituirli da un UDF

Descrizione

string sqlite_udf_encode_binary ( string $data )

sqlite_udf_encode_binary() applica la decofica dei dati binari al parametro data in modo che possa essere restituito dalle query (dato che la sottostante libreria libsqlite API non è binary safe).

Se esiste una possibilità che i dati possano essere binari (ad esempio contengono caratteri tipo NUL al centro e non alla fine, oppure iniziano con il carattere 0x01), occorre eseguire questa funzione per codificare il valore restituito dalla tua UDF.

Il PHP non esegue questa codifica/decodifica in automatico, avrebbe impatti particolarmente negativi sulle performance.

Nota:
Non utilizzare sqlite_escape_string() per quotare stringhe restituite tramite UDF poiché porta ad avere una quotazione doppia. Utilizzare sqlite_udf_encode_binary()!

Elenco dei parametri

data: La string da codificare.

Valori restituiti

La string codificata.

Vedere anche:

sqlite_udf_decode_binary() - Decodifica dati binari passati come parametri in UDF
sqlite_escape_string() - Inserisce il carattere di escape in una stringa da utilizzare in una query
sqlite_create_function() - Registra una funzione utente "regolare" da utilizzare nelle istruzioni SQL
sqlite_create_aggregate() - Registra un aggregato UDF da utilizzare nelle istruzioni SQL

add a note User Contributed Notes sqlite_udf_encode_binary - [2 notes]

down

B. Keil ¶

13 days ago


Embarassing as it is, I completely didn't realize that there IS an sqlite3 interface if you search for "sqlite3" as opposed to "sqlite".



There is also a slight error in the example above, which causes the file fetched from the database to be empty. The QUERY_STRING should be defined as:



#define QUERY_STRING "SELECT test FROM test"

down

B. Keil ¶

13 days ago


I wrote a script to transfer my old data from a mysql database, performing some changes to a sqlite3 database. When I realized that that the sqlite interfaces is no longer included in PHP and my PECL didn't get it installed it was too late. 



However, there is a very easy, though not particularly performant way to get the job done like in the "sqlite_encode_blob" function I present below. Note that this does ONLY encode the data. To actually use it in a query you will have to wrap it like: X'data' See the example below.



#!/usr/bin/php

<?php

function sqlite_encode_blob($data) {

        $result = "";

        for ($i = 0; $i < strlen($data); $i++) {

                $result .= sprintf("%02X", ord(substr($data, $i, 1)));

        }

        return $result;

}



error_reporting(E_ALL);

$original = "62.jpg";

$data = file_get_contents($original);

$before = microtime(true);

$encodedData = sqlite_encode_blob($data);

$after = microtime(true);

unset($data);

echo "Encoding time needed: ".($after - $before)." seconds.\n";



$sql = <<<QUERY

BEGIN;

CREATE TABLE test(test BLOB);

INSERT INTO test(test) VALUES ( X'$encodedData' );

COMMIT;

QUERY;

unset($encodedData);



file_put_contents("test.sql", $sql);

`sqlite3 blob_test.db < test.sql`

?>



The tricky part is to get the data back out of the database - that is not possible with the command line tool as far as I can tell. You will have to use a language with an actual API.



The following example is written in C and compiles on a linux box where the sqlite3 API is installed using:

gcc -o test test.c `pkg-config --cflags --libs sqlite3`

Note that this has absolutely no error checking whatsoever. If the slightest thing goes wrong it will likely cause a segmentation fault and likely leave the database corrupted.



# FILE test.c START

#include <stdlib.h>

#include <stdio.h>

#include <sqlite3.h>

#define DB_FILE "blob_test.db"

#define QUERY_STRING "SELECT data FROM test"

#define STORAGE_FILE "test.jpg"



int main(int argc, char** argv) {

        sqlite3 *db = NULL;

        int size = 0;

        const char *data = NULL;

        sqlite3_stmt *query = NULL;

        const char *rest = NULL;

        FILE *file = NULL;

        sqlite3_open(DB_FILE, &db);

        sqlite3_prepare_v2(db, QUERY_STRING, sizeof(QUERY_STRING), &query, &rest);

        sqlite3_step(query);

        size = sqlite3_column_bytes(query, 0);

        data = sqlite3_column_blob(query, 0);

        file = fopen(STORAGE_FILE, "w");

        fwrite(data, 1, size, file);

        fclose(file);

        sqlite3_finalize(query);

        sqlite3_close(db);

        return 0;

}



# FILE test.c END

add a note