sqlite_array_query

SQLite

Last updated: Fri, 16 May 2008

Fonctions SQLite

Classes pré-définies

SQLiteDatabase

Représente une base de données SQLite ouverte.

Constructeur

__construct - construit un nouvel objet SQLiteDatabase

Méthodes

query - Exécute une requête
queryExec - Exécute une requête de résultat
arrayQuery - Exécute une requête et retourne les résultats dans un tableau
singleQuery - Exécute une requête et retourne soit un tableau pour une seule colonne, soit la valeur de la première ligne
unbufferedQuery - Exécute une requête non bufférisée
lastInsertRowid - Retourne l'identifiant de la dernière ligne insérée
changes - Retourne le nombre de lignes modifiées par la dernière requête
createAggregate - Enregistre une UDF de groupement pour les requêtes SQLite
createFunction - Enregistre une fonction utilisateur "classique" UDF pour SQLite
busyTimeout - Configure ou désactive le délai d'attente d'une base SQLite occupée
lastErorr - Retourne le dernier code erreur de la dernière erreur rencontrée
fetchColumnTypes - Retourne un tableau de types de colonnes depuis une table particulière

SQLiteResult

Représente un jeu de résultats SQLite bufférisé.

Méthodes

fetch - Récupère la ligne suivante depuis un jeu de résultats en tant que tableau
fetchObject - Récupère la ligne suivante depuis un jeu de résultats en tant qu'objet
fetchSingle - Récupère la première ligne depuis le jeu de résultats en tant que chaîne de caractères
fetchAll - Récupère toutes les lignes depuis le jeu de résultats en tant que tableau de tableaux
column - Récupère une colonne depuis la ligne courante du jeu de résultats
numFields - Retourne le numéro du champ depuis un jeu de résultats
fieldName - Retourne le nom d'un champ particulier depuis le jeu de résultats
current - Récupère la ligne courante depuis le jeu de résultat en tant que tableau
key - Retourne l'index de la ligne courante
next - Déplace le pointeur sur le numéro de ligne suivante
valid - Retourne si oui ou non il reste des lignes de disponibles
rewind - Déplace le pointeur sur le numéro de la première ligne d'un jeu de résultats
prev - Déplace le pointeur sur le numéro de ligne précédent du jeu de résultats
hasPrev - Retourne si oui ou non une ligne précédente est disponible
numRows - Retourne le nombre de lignes dans le jeu de résultats
seek - Déplace le pointeur vers un numéro de ligne précis

SQLiteUnbuffered

Représente un jeu de résultats SQLite non-bufférisé. Les jeux de résultats non-bufférisés sont séquentiels, déplacement du pointeur uniquement vers le numéro suivant.

Méthodes

fetch - Récupère la ligne suivante depuis un jeu de résultats en tant que tableau
fetchObject - Récupère la ligne suivante depuis un jeu de résultats en tant qu'objet
fetchSingle - Récupère la première colonne depuis un jeu de résultats en tant que chaîne de caractères
fetchAll - Récupère toutes les lignes depuis le jeu de résultats en tant que tableau de tableaux
column - Récupère une colonne depuis la ligne courante d'un jeu de résultats
numFields - Retourne le nombre de champs dans le jeu de résultats
fieldName - Retourne le nom d'un champ en particulier depuis le jeu de résultats
current - Récupère la ligne courante depuis le jeu de résultats en tant que tableau
next - Déplace le pointeur vers un numéro de ligne suivant
valid - Retourne si oui ou non il reste des lignes de disponibles

Sommaire

sqlite_array_query — Exécute une requête SQL avec SQLite et retourne un tableau
sqlite_busy_timeout — Configure le délai d'attente d'une base SQLite occupée
sqlite_changes — Retourne le nombre de lignes qui ont été modifiées par la dernière requête SQLite
sqlite_close — Ferme la connexion à SQLite
sqlite_column — Lit la valeur d'une colonne dans un résultat SQLite
sqlite_create_aggregate — Enregistre une UDF agregeante pour les requêtes SQLite
sqlite_create_function — Enregistre une fonction utilisateur "classique" UDF pour SQLite
sqlite_current — Lit une ligne de résultat SQLite dans un tableau
sqlite_error_string — Retourne le message d'erreur SQLite
sqlite_escape_string — Protège une chaîne de caractères pour utilisation avec SQLite
sqlite_exec — Exécute une requête sans résultats sur une base de données
sqlite_factory — Ouvre une base SQLite et crée un objet pour elle
sqlite_fetch_all — Retourne toutes les lignes d'un jeu de résultats en tant que tableau de tableaux
sqlite_fetch_array — Lit la prochaine ligne de résultat SQLite dans un tableau
sqlite_fetch_column_types — Retourne un tableau des types de colonnes d'une certaine table
sqlite_fetch_object — Retourne la ligne suivante du jeu de résultats en tant qu'objet
sqlite_fetch_single — Lit la première ligne d'un résultat SQLite sous forme de chaîne
sqlite_fetch_string — Alias de sqlite_fetch_single
sqlite_field_name — Retourne le nom du champ SQLite
sqlite_has_more — Indique s'il reste des lignes SQLite à lire
sqlite_has_prev — Retourne si oui ou non une ligne précédente est disponible
sqlite_key — Retourne l'index de la ligne courante
sqlite_last_error — Retourne le dernier code d'erreur SQLite
sqlite_last_insert_rowid — Retourne le numéro de ligne de la dernière ligne insérée
sqlite_libencoding — Retourne l'encodage utilisé par la bibliothèque SQLite
sqlite_libversion — Retourne la version de la bibliothèque SQLite
sqlite_next — Déplace le pointeur SQLite vers la prochaine ligne
sqlite_num_fields — Retourne le nombre de champs dans un résultat SQLite
sqlite_num_rows — Retourne le nombre de lignes d'un résultat SQLite
sqlite_open — Ouvre une base SQLite et la crée si elle n'existe pas
sqlite_popen — Ouvre une connexion SQlite persistante et crée la base si elle n'existe pas
sqlite_prev — Se positionne sur le numéro de ligne précédent du jeu de résultats
sqlite_query — Exécute une requête SQLite et lit le résultat
sqlite_rewind — Place le pointeur de résultat SQLite au début
sqlite_seek — Déplace le pointeur de résultat SQLite vers une ligne
sqlite_single_query — Exécute une requête et retourne soit un tableau pour une colonne unique, soit la valeur de la première ligne
sqlite_udf_decode_binary — Décode des données binaires, passées à une UDF SQLite
sqlite_udf_encode_binary — Encode les données binaires d'une UDF SQLite avant de les retourner
sqlite_unbuffered_query — Exécute une requête SQLite non bufférisée
sqlite_valid — Retourne si oui ou non il reste des lignes disponibles

sqlite_array_query

SQLite

Last updated: Fri, 16 May 2008

add a note User Contributed Notes
Fonctions SQLite

vincent at tigroux dot net
11-Oct-2006 12:19


on win 32



the error "malformed database schema - unable to open a temporary database file for storing temporary tables" may happen if the temp and tmp env vars are typed like this : %WINDIR/Temp



Replace by C:/Windows/Temp and the error will disappear.

papafox888 at hotmail dot com
02-Jun-2006 06:05


If you get an error message:



     Warning: sqlite_open() [function.sqlite-open]: file is encrypted or is not a database



then most probably your code is accessing a SQLite3 database.



sqlite_open() only supports SQLite2.  Use PDO to access SQLite3.

NOTshrockc_inhs_org
10-May-2006 07:05


The correct url for the windows dll is:



http://pecl4win.php.net/ext.php/php_sqlite.dll

Egon at example dot com
22-Feb-2006 02:15


<$php

public function set_by_db_with_join_to_users_department($col, $foo){

    $list = "da.ROWID, da.dept_id, da.script, da.action, da.description, ud.name";

    $query = "SELECT $list FROM dept_access AS da, users_department AS ud

        WHERE da.dept_id = ud.ROWID

        AND da.$col = '$foo';";



    $db = new SQLiteDatabase (dept_access::db_path, 0666, &$error)

        or die("Failed: $error");

    $db->queryExec("ATTACH DATABASE '".dept_access::db_users_path."' AS users");

    $row = $db->arrayQuery($query, SQLITE_ASSOC);

    unset($db);



echo $query."\n";

echo var_dump($row);

    $this->ROWID = $row[0]['da.ROWID'];

    $this->dept_id = $row[0]['da.dept_id'];

    $this->dept_name = $row[0]['ud.name'];

    $this->script = $row[0]['da.script'];

    $this->action = $row[0]['da.action'];

    $this->description = $row[0]['da.description'];

}

?>



For ATTACH DATABASE to work you need to run it in a $db->queryExec(ATTACH DATABASE...); before using $db->arrayQuery. This is most likly the case with other OO methods to. This on stumped me for a while.

heinemann.juergen AT t-online.de
11-Nov-2005 06:53


Simple Example for using SQLite for small Buffering Clipboard ;)



<?php



// $Id: SQLiteClipboard.php5,v 1.1 2005/09/09 10:15:26 heinemann Exp $



/**

 * @callgraph

 * @class      SQLiteClipboard

 * @short      Simple Read/Write Clipboard Class

 * @version    0.0.1

 * @since      Fr Sep  9 08:14:45 CEST 2005

 * @code

   $sqlite = new SQLiteClipboard( MY_TEMP_DIR );

   if ( $sqlite->INSERTING = time() )

      var_dump( $sqlite->INSERTING );

   else

      echo "Nothing done!";

 * @endcode

 */



final class SQLiteClipboard

{

   private $SQL;

   private $DB = "Clipboard.sqlite";

   private $TB = "Clipboard";

   private $ID = "ID";

   private $PA = "PARAM";

   private $VA = "VAL";



   function __construct( $path )

   {

      $this->DB = chop( $path . "/" . $this->DB );

      $this->sql_init();

   }



   private function sql_init()

   {

      $this->SQL = new SQLiteDatabase( $this->DB, 0660 );

      if ( ! file_exists( $this->DB ) )

         die( "Permission Denied!" );



      $q = $this->SQL->query("PRAGMA table_info(" . $this->TB . ")");

      if ( $q->numRows() == 0 ) {

         $this->SQL->query( "CREATE TABLE " . $this->TB . " ( " . $this->ID . " INTEGER PRIMARY KEY, " . $this->PA . " CHAR(255), " . $this->VA . " CHAR(255) );" );

      }

   }



   private function sql_check( $p )

   {

      $o = null;

      $q = $this->SQL->query( "SELECT " . $this->ID . " FROM " . $this->TB . " WHERE ( " . $this->PA . "='$p' ) ORDER BY " . $this->ID . " LIMIT 1" );

      while( $q->valid() ) {

         $r = $q->current();

         return $r[$this->ID];

         $q->next();

      }

      return false;

   }



   public function __get( $p )

   {

      $q = $this->SQL->query( "SELECT " . $this->VA . " FROM " . $this->TB . " WHERE ( " . $this->PA . "='$p' ) ORDER BY " . $this->ID );

      while( $q->valid() ) {

            $r = $q->current();

            $o = $r[$this->VA];

            $q->next();

      }

      return $o;

   }



   public function __set( $p, $v )

   {

      if ( $this->sql_check( $p ) && ! empty( $v ) )

         return $this->SQL->query( "UPDATE " . $this->TB . " SET " . $this->VA . "='$v' WHERE ( " . $this->PA . "='$p' );" );

      elseif  ( ! $this->sql_check( $p ) && ! empty( $v ) )

         return $this->SQL->query( "INSERT INTO " . $this->TB . " ( " . $this->PA . ", " . $this->VA . " ) VALUES ('$p', '$v' );" );

      elseif  ( $this->sql_check( $p ) && empty( $v ) )

         return $this->SQL->query( "DELETE FROM " . $this->TB . " WHERE ( " . $this->PA . "='$p' );" );

      else

         return false;

   }



} // end Class



?>

01-Sep-2005 01:21


A function to check whether a table exists:



<?php

function sqlite_table_exists(&$sqlite, $table)

{

    $result = $sqlite->query("SELECT name FROM sqlite_master WHERE type='table' AND name='$table'");

    return $result->numRows() > 0;

}

?>

bens at effortlessis dot com
14-Jul-2005 08:37


Sqlite by default allows for foreign keys, but doesn't enforce them. 



I found a nice article on how to enforce foreign keys  at http://www.justatheory.com/computers/databases/sqlite/ 



It would be nice if this could be handled with a wrapper class, so that adding foreign keys is done thru a wrapper API to automate the generation of the necessary enforcement triggers. If nobody's done this by the time I start coding against SqlLite/PHP5 in 6-12 months, I'll write one myself, possibly by modifying "jon at jenseng dot com"s alter table wrapper 



Anyway, it's not PHP specific, but anybody using Sqlite really should know this!

Stephen Leaf
30-Jun-2005 02:58


I think it would be good to point out that currently (as of 5.0.4) this extention does not support SQLite 3 databases.

So if your getting an error message like:

Error: file is encrypted or is not a database

That is why.

bart at mediawave dot nl
18-Apr-2005 04:30


SELECT tablename.columnname FROM table;



will cause SQLite to return an array having tablename.field_name as the array index. (e.g. $result['tablename.field_name'])



To let SQLite return an array having only field_name as the array index (e.g. $result['field_name']) you can issue a 'PRAGMA short_column_names = 1' query:



sqlite_query($connection_id, 'PRAGMA short_column_names = 1');



This behaviour is more consistent with the other database extensions.



For a full list of all pragmas visit: http://sqlite.org/pragma.html

dotwho at NOSPAM dot mac dot com
10-Feb-2005 03:03


This may have been obvious to others, but I had a tough time finding the info.



The default location for the actual database file is the same location of the php doc that created the database. You can alter this behavior by specifying the full path in the creation call:



<php

$db = sqlite_open("/absolute/path/my_sqlite.db");

?>



Note that if you used the default location, the db file may be served up by the webserver if it is in a the http document path. This is obviously a security risk that should be avoided.



//Max

hunreal+php at gmail dot com
16-Jan-2005 05:42


Check the db/table if exist



$db_name='db';

$db=new SQLiteDatabase($db_name, 0666, $error);

if ($error) exit($error);

$q=$db->query("PRAGMA table_info(test)");

if ($q->numRows()!=2) {

    if (!@$db->queryexec("

        CREATE TABLE test (

            id INTEGER NOT NULL PRIMARY KEY,

            text VARCHAR ( 255 ) NOT NULL

            )")

    ) exit ("Create SQLite Database Error\n");

}

nicolas dot toniazzi at free dot fr
16-Nov-2004 04:24


The same in 3 lines.



<?php

function sqlite_table_exists($db,$mytable) {

  /* counts the tables that match the name given */

  $result = sqlite_query($db,"SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name='$mytable'");



  /* casts into integer */

  $count = intval(sqlite_fetch_single($result));



  /* returns true or false */

  return $count > 0;

}

?>

alexs at alphacomolex dot info
29-Oct-2004 12:41


the OO version.

<?php

function sqlite_table_exists($db,$mytable) {

    // ask the database kindly what tables is has.

    $result = $db->query("SELECT name FROM sqlite_master WHERE type='table'");

    $tables = $result->fetchAll();

    // if there's no items in the array then our taget is not going to exists.

    if (count($tables) == 0) {

        return FALSE ; 

    }

    // loop over the tables to see if there's a table we're looking for.

    foreach ($tables as $table) {

        if ($table['name'] == $mytable) {

            return(TRUE);

        }

    }    

    // there was no such table, informe the user the bad news. 

    return(FALSE);

}

?>

artooro at gmail dot com
22-Oct-2004 03:26


If you need to check if a table exists, you can use a function like this:

<?php

//Returns TRUE if table exists and FALSE otherwise

//  $mytable = table you want to check for



function sqlite_table_exists($mytable) {

$db = sqlite_open('mydb.sqlite', 0666, $sqliteerror);

    $query = sqlite_query($db, "SELECT name FROM sqlite_master WHERE type='table'");

    $tables = sqlite_fetch_array($query);

    if ($tables != '') {

        foreach ($tables as $table) {

            if ($table == $mytable) {

                return("TRUE");

            }

            else {

                return("FALSE");

            }

        }

    }

    else {

        return("FALSE");

    }

}

?>



A function like this could be used to create the table if it's not already created, etc.

j-pieper at NOSPAM dot web dot de
19-Oct-2004 12:18


If you want to create a table in your database which should have an integer primary key, you cannot declare the row like this:



id int(16) primary key

or

id integer(16) primary key



When you declare it like this it could be that the id isn�t auto increment. You have to declare it like this:



id integer primary key

filip at filipdewaard dot com
10-Sep-2004 08:39


I've written a short article about the (lack of) use of SQLite in-memory databases: http://www.filipdewaard.com/21_SQLite_inmemory_databases.html . Hopefully it will help somebody out there ;)

philip
08-Aug-2004 11:59


SQLite tutorials:


 * http://www.zend.com/php5/articles/php5-sqlite.php


 * http://www.zend.com/php5/abs/php101-9.php


 * http://www.oreilly.com/catalog/upgradephp5/chapter/ch04.pdf

jon at jenseng dot com
20-Jul-2004 11:50


Since SQLite doesn't support ALTER TABLE statements or renaming tables, modifying an existing table is a bit cumbersome. You have to:



1. create a temporary table

2. copy the original table into the temporary table

3. delete the original

4. recreate the original with new column definitions

5. copy the contents back

6. delete the temporary table



As this is rather unwieldy, I've created a wrapper class that allows for ALTER TABLE queries and does the dirty work for you. It has integrated error handling to ensure that queries are completely valid and it allows for complex statements such as:



ALTER TABLE foo ADD bar VARCHAR(27), DROP bar2, CHANGE bar3 foobar INTEGER, ADD bar4 DATE



Documentation:

http://code.jenseng.com/db/



Source:

http://code.jenseng.com/db/sql.txt

david at acz dot org
15-Jul-2004 03:29


You can use the PECL SQLite extension as a static (built into the executable) PHP module with PHP 4.  Download the extension tarball and extract it.  Move it to ext/sqlite in the PHP source directory.  Delete configure and run buildconf.



Example below.  Change version numbers as appropriate:



$ tar -xzvf php-4.3.8.tar.gz

$ tar -xzvf SQLite-1.0.2.tgz

$ mv SQLite-1.0.2 php-4.3.8/ext/sqlite

$ cd php-4.3.8

$ rm configure

$ ./buildconf --force



If everything worked, then you should now be able to build PHP with SQLite support:



$ ./configure --help | grep sqlite

  --with-sqlite           Include sqlite support



I think this method will work for other PECL extensions.

13-May-2004 04:46


PHP5 compile time option --enable-sqlite-utf8



See the note about buggy utf-8 support http://uk.php.net/manual/en/function.sqlite-libencoding.php

csaba at alum dot mit dot edu
14-Apr-2004 05:16


If you want to get the list of all the columns in a table (and associated information), PRAGMA is helpful (see http://sqlite.org/lang.html#pragma for details):



if (!($db=@sqlite_open("delme.db",0666,$sqliteerror))) die("Can't open database");

@sqlite_query ($db, 'DROP TABLE foo;');

sqlite_query($db, "CREATE TABLE foo (bar INTEGER PRIMARY KEY, baz VARCHAR(5));");

$aTableStruct = sqlite_array_query($db, "PRAGMA table_info('foo');", SQLITE_ASSOC);

for ($i=0,$aNames=array();$i<sizeof($aTableStruct);++$i)

    $aNames[]=$aTableStruct[$i]['name'];

var_dump ($aNames);    // => ['bar', 'baz']



Note also that if you want to use more than one database in the same connection using "ATTACH DATABASE ..." then you should supply the complete database filename.



Csaba Gabor

cricket at djcricket dot com
31-Mar-2004 07:30


To elaborate on vpupkin at comcast dot net's post about the INSERT query problem, you will be unable to execute any manipulation queries (INSERT/UPDATE/DELETE/ect) on the SQLite database file unless the directory the SQLite database file resides in is writable by the webserver.



The reason for this is because SQLite needs to write a lock file to the hard drive. After a processes finishes writting, it deletes the lock file. Other processes check for the lock file before writting to the SQLite database file and if present, delay writting until the lock file is no longer present.

jlsalinas at spamsucks dot gmx dot net
14-Feb-2004 03:22


For those looking for a function similar to mysql_list_tables, here you have:



if (! function_exists ('sqlite_list_tables')) {

    function sqlite_list_tables (&$dblink) {

        $tables = array ();

        

        $sql = "SELECT name FROM sqlite_master WHERE (type = 'table')";

        if ($res = sqlite_query ($dblink, $sql)) {

            while (sqlite_has_more($res)) {

                $tables[] = sqlite_fetch_single($res);

            }

        }

        

        return $tables;

    }

}



And a related funtion, to test if a given table exists:



if (! function_exists ('sqlite_table_exists')) {

    function sqlite_table_exists (&$dblink, $table) {

        $sql = "SELECT count(name) FROM sqlite_master WHERE ((type = 'table') and (name = '$table'))";

        if ($res = sqlite_query ($dblink, $sql)) {

            return sqlite_fetch_single($res) > 0;

        } else {

            return false; // or throw exception

        }

    }

}



Of course it would be preferable to have these functions included in the library, to avoid potential changes internal to SQLite; but we'll have to stick to this method until then.

05-Feb-2004 05:11


Since this extension is rather new and few tutorials/articles talk about it... here's one worthy of a link:

http://www.php-mag.net/itr/online_artikel/psecom,id,447,nodeid,114

vpupkin at comcast dot net
01-Dec-2003 05:53


if you are going to send INSERT queries, you will need to make the folder, where you put your "file.db", writable by a web server user, otherwise you'll receive error message - "Unable to open database . . . ". File permissions are not enough (phpinfo - SQLite Lib 2.8.3)

Minots Estich� <minots at D0X dot de>
22-Nov-2003 03:47


If you gone in trouble while/with installation of sqlite,

you can try the installation steps I�ve done at

RedHat9 with PHP4.3.4 and Apache 1.3.28

via the Linux shell:



# wget http://pecl.php.net/get/SQLite-1.0.tgz

# tar xzf SQLite-1.0.tgz

# cd sqlite

# export PHP_PREFIX="/usr"

# $PHP_PREFIX/bin/phpize

# ./configure

# make

# make install



After that add following to php.ini and restart Apache:



[sqlite]

extension="sqlite.so"

ng4rrjanbiah at rediffmail dot com
07-Nov-2003 04:19


Very nice MS PowerPoint presentation titled "SQLite and PHP" (author: Wez Furlong) can be downloaded at http://www.php.net/~wez/SQLite_and_PHP.ppt [134 KB]



HTH,

R. Rajesh Jeba Anbiah

add a note

sqlite_array_query

SQLite

Last updated: Fri, 16 May 2008