PHP 5.5.20 is available

SQLite Funciones

Clases predefinidas

SQLiteDatabase

Representa una base de datos SQLite abierta.

Constructor

  • __construct - Construir un objeto nuevo SQLiteDatabase

Métodos

  • query - Ejecutar un query
  • queryExec - Ejecutar un resultado menos-consulta
  • arrayQuery - Ejecuta una consulta y devolver el resultado como una matriz
  • singleQuery - Ejecuta una consulta y devuelve o una matriz para una columna o el valor de la primera fila
  • unbufferedQuery - Ejecuta una consulta sin búfer
  • lastInsertRowid - Devuelve el identificador de la última fila insertada
  • changes - Devuelve el número de registros cambiados por la declaración más reciente
  • createAggregate - Registra una FDU agregación para su uso en sentencias SQL
  • createFunction - Registrar una UDF para su uso en sentencias SQL
  • busyTimeout - Establece o deshabilita la duración del temporizador de ocupado
  • lastError - Devuelve el último código de error del error más reciente encontrado
  • fetchColumnTypes - Devuelve una matriz de tipos de columnas de una tabla en particular

SQLiteResult

Representa un buffer conjunto SQLite resultado.

Métodos

  • fetch - Busca la siguiente fila del conjunto de resultados como un arreglo
  • fetchObject - Busca la siguiente fila del conjunto de resultados como un objeto
  • fetchSingle - Obtiene la primera columna del conjunto de resultados como una cadena
  • fetchAll - Obtiene todas las filas del conjunto de resultados como un arreglo de arreglos
  • column - Obtiene una columna de la fila actual del conjunto de resultados
  • numFields - Devuelve el número de campos en el conjunto de resultados
  • fieldName - Devuelve el nombre de un campo determinado en el conjunto de resultados
  • current - Obtiene la fila actual del conjunto de resultados como una arreglo
  • key - Devuelve el índice de la fila actual
  • next - Se desplaza hasta el siguiente número de fila
  • valid - Indica si existen más filas disponibles
  • rewind - Se desplaza hasta el primer número de fila del conjunto
  • prev - Se desplaza hasta el número de la fila anterior del conjunto de resultados
  • hasPrev - Devuelve si una fila anterior está disponible
  • numRows - Devuelve el número de filas en el conjunto de resultados
  • seek - Se desplaza hasta un determinado número de filas

SQLiteUnbuffered

Representa un conjunto de búfer SQLite resultado. Conjuntos de resultados sin búfer son secuenciales, con visión de buscar solamente.

Métodos

  • fetch - Busca la siguiente fila del conjunto de resultados como un arreglo
  • fetchObject - Busca la siguiente fila del conjunto de resultados como un objeto
  • fetchSingle - Obtiene la primera columna del conjunto de resultados como una cadena
  • fetchAll - Obtiene todas las filas del conjunto de resultados como una matriz de matrices
  • column - Obtiene una columna de la fila actual del conjunto de resultados
  • numFields - Devuelve el número de campos en el conjunto de resultados
  • fieldName - Devuelve el nombre de un campo determinado en el conjunto de resultados
  • current - Obtiene la fila actual del conjunto de resultados como un arreglo
  • next - Se desplaza hasta el siguiente número de fila
  • valid - Indica si existen más filas disponibles

Tabla de contenidos

  • sqlite_array_query — Ejecutar una consulta en una base de datos dada y devolver un array
  • sqlite_busy_timeout — Establecer la duración del tiempo de espera de ocupación, o deshabilitar los gestores ocupados
  • sqlite_changes — Devuelve el número de filas que han sido cambiadas mediante la sentencia SQL más reciente.
  • sqlite_close — Cierra un base de datos SQLite abierta
  • sqlite_column — Obtiene una columna de la fila actual de un conjunto de resultados
  • sqlite_create_aggregate — Registrar FDU totalizadora para usarla en sentencias SQL
  • sqlite_create_function — Registra una función "regular" definida por el usuario para ser usada en sentencias SQL
  • sqlite_current — Obtiene la fila actual como un array de un conjunto de resultado
  • sqlite_error_string — Devuelve la descripción de un código de error
  • sqlite_escape_string — Escapa una cadena para ser usada como un parámetro para una consulta
  • sqlite_exec — Ejecutar una consulta sin resultado en una base de datos dada
  • sqlite_factory — Abrir una base de datos SQLite y devolver un objeto SQLiteDatabase
  • sqlite_fetch_all — Recupera todas las filas de un conjunto de resultados como un array de arrays
  • sqlite_fetch_array — Recupera la siguiente fila de un conjunto de resultados como un array
  • sqlite_fetch_column_types — Devuelve un array con los tipos de columna de una tabla en particular
  • sqlite_fetch_object — Recupera la siguiente fila de un conjunto de resultados como un objeto
  • sqlite_fetch_single — Recupera la primera columna de un conjunto de resultados como cadena
  • sqlite_fetch_string — Alias de sqlite_fetch_single
  • sqlite_field_name — Devuelve el nombre de un campo en particular
  • sqlite_has_more — Comprueba si están o no disponibles más filas
  • sqlite_has_prev — Comprueba si está o no disponible una fila anterior
  • sqlite_key — Devuelve el índice de la fila actual
  • sqlite_last_error — Devuelve el código de error del último error de una base de datos
  • sqlite_last_insert_rowid — Devuelve el ID fila de la fila insertada más recientemente
  • sqlite_libencoding — Devuelve la codificación de la biblioteca SQLite vinculada
  • sqlite_libversion — Devuelve la versión de la biblioteca SQLite vinculada
  • sqlite_next — Busca el número de fila siguiente
  • sqlite_num_fields — Devolver el número de campos de un conjunto de resultados
  • sqlite_num_rows — Devolver el número de filas de un conjunto de resultados almacenado en buffer
  • sqlite_open — Abrir una base de datos SQLite y crear la base de datos si no existe
  • sqlite_popen — Abrir un gestor persistente a una base de datos SQLite y crearla si no existe
  • sqlite_prev — Busca el número de fila anterior de un conjunto de resultados
  • sqlite_query — Ejecutar una consulta en una base de datos dada y devolver un gestor de resultados
  • sqlite_rewind — Busca el primer número de fila
  • sqlite_seek — Busca un número de fila en particular en un conjunto de resultados almacenado en buffer
  • sqlite_single_query — Ejecuta una consulta y devuelve un array para cada colúmna única o el valor de la primera fila
  • sqlite_udf_decode_binary — Decodificar datos binarios pasados como parámetros a una FDU
  • sqlite_udf_encode_binary — Codificar datos binarios antes de devolverlos desde una UDF
  • sqlite_unbuffered_query — Ejecutar una consulta que no precargue ni almacene en buffer toda la información
  • sqlite_valid — Devuelve si están disponibles más filas
add a note add a note

User Contributed Notes 22 notes

up
3
Anonymous
9 years ago
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;
}
?>
up
1
bart at mediawave dot nl
9 years ago
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
up
0
CraquePipe
3 years ago
The SQLite manual mentions that queries are done in a case-sensitive way, this means your query must be the correct case. It also mentions that using the "LIKE" operator will do a case-insensitive selection. This is true, but this also introduces wildcard symbols which a user could enter without getting filtered by the SQLite escape function. I'm somewhat new to SQL and I didn't think of doing this before, even after looking for a decent way to do case-insensitive queries.

For case-insensitive queries, simply use the built in "lower" function.
<?php
// ...
$name = 'bARbarA';
$rows = $db->arrayQuery('select * from blah where lower(name) = lower(\''.sqlite_escape_string($name).'\');');
// $rows might contain an entry for "Barbara" now.
?>
up
0
papafox888 at hotmail dot com
8 years ago
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.
up
0
heinemann.juergen AT t-online.de
9 years ago
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

?>
up
0
bens at effortlessis dot com
9 years ago
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!
up
0
Stephen Leaf
9 years ago
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.
up
0
dotwho at NOSPAM dot mac dot com
9 years ago
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
up
0
hunreal+php at gmail dot com
9 years ago
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");
}
up
0
nicolas dot toniazzi at free dot fr
10 years ago
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;
}
?>
up
0
j-pieper at NOSPAM dot web dot de
10 years ago
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
up
0
filip at filipdewaard dot com
10 years ago
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 ;)
up
0
david at acz dot org
10 years ago
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.
up
0
Anonymous
10 years ago
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
up
0
csaba at alum dot mit dot edu
10 years ago
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
up
0
cricket at djcricket dot com
10 years ago
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.
up
0
jlsalinas at spamsucks dot gmx dot net
10 years ago
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.
up
0
vpupkin at comcast dot net
11 years ago
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)
up
0
Minots Estich <minots at D0X dot de>
11 years ago
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"
up
0
ng4rrjanbiah at rediffmail dot com
11 years ago
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
up
-1
artooro at gmail dot com
10 years ago
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.
To Top