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.
?>
CXLIV. Funciones SQLite
Introducción
Se trata de una extensión que permite emplear el motor de base de datos embebible SQLite. SQLite es una biblioteca de C que implementa un motor de base de datos SQL embebible. Las aplicaciones que emplean la biblioteca de SQLite pueden emplear bases de datos sin necesidad de instalar un motor de bases datos externo.
SQLite no es una biblioteca cliente para acceder a un servidor de bases datos. El propio SQLite es el servidor de base datos. La biblioteca SQLite lee y escribe directamente sobre los archivos de la base de datos que se encuentran en el disco.
Nota: Para más información puede acceder al sitio web oficial de SQLite: http://sqlite.org/.
Instalación
Lea el archivo INSTALL que viene con el paquete o utilice el instalador de PEAR con el siguiente comando "pear install sqlite". El propio SQLite ya está incluido, así que no es necesario instalar ningún programa adicional.
Los usuarios de Windows pueden descargar el archivo DLL de la extensión SQLite en esta dirección: (php_sqlite.dll).
En PHP 5, la extensión SQLite y el propio motor de bases de datos está incluido y compilado por defecto.
Instalación en Windows con cuentas de usuario sin privilegios: En los sistemas operativos Windows, las cuentas sin privilegios no tienen la variable de entorno TMP establecida por defecto. Por este motivo, SQLite creará los archivos temporales en el directorio de Windows, lo que no es muy recomendable. La solución pasa por crear una variable de entorno llamada TMP para el servidor web o para la cuenta de usuario con la que se ejecuta el servidor web. Si el servidor empleado es Apache, puede establecerse esta variable mediante la directiva SetEnv del archivo de configuración httpd.conf. Por ejemplo:
Si no es posible establecer la variable a nivel de servidor, se puede realizar en el mismo script: La configuración debe hacer referencia a un directorio en el que el servidor web tenga permisos para crear archivos y por tanto para escribir y borrar los archivos creados. Si no tiene los permisos adecuados, se mostrará el siguiente mensaje de error: malformed database schema - unable to open a temporary database file for storing temporary tables
Requisitos
Para poder utilizar estas funciones, se debe compilar PHP con soporte para SQLite o cargar la extensión SQLite de forma dinámica desde el archivo php.ini.
Tipos de recursos
La interfaz de SQLite utiliza 2 recursos: el primero es de la conexión con la base de datos y el segundo es el resultado.
Constantes predefinidas
Estas constantes están definidas por esta extensión y estarán disponibles solamente cuando la extensión ha sido o bien compilada dentro de PHP o grabada dinámicamente en tiempo de ejecución.
Las funciones sqlite_fetch_array() y sqlite_current() emplean una constante para seleccionar los diferentes tipos de matrices del resultado. Los diferentes constantes definidas son las siguientes:
Constantes del tipo de resultado de SQLite
- SQLITE_ASSOC (int)
La matriz contiene el nombre de las columnas como índice de los valores.
- SQLITE_BOTH (int)
La matriz contiene el nombre de las columnas y un índice numérico como índice de los valores.
- SQLITE_NUM (int)
La matriz contiene un índice numérico como índice de los valores. El índice empieza asignando el 0 al primer campo del resultado.
Algunas funciones devuelven códigos de estado. Se han definido los siguientes códigos:
Constantes del código de estado de SQLite
- SQLITE_OK (int)
Resultado exitoso.
- SQLITE_ERROR (int)
Error de SQL o base de datos desconocida.
- SQLITE_INTERNAL (int)
Error lógico interno de SQLite.
- SQLITE_PERM (int)
Permiso de acceso denegado.
- SQLITE_ABORT (int)
La función de callback solicitó una interrupción.
- SQLITE_BUSY (int)
El archivo de base de datos está bloqueado.
- SQLITE_LOCKED (int)
Una tabla de la base de datos está bloqueada.
- SQLITE_NOMEM (int)
Error en la reserva de memoria.
- SQLITE_READONLY (int)
Se intentó escribir en una base de datos de solo lectura.
- SQLITE_INTERRUPT (int)
La operación finalizaó internamente.
- SQLITE_IOERR (int)
Error de E/S en el disco.
- SQLITE_CORRUPT (int)
La imagen de la base de datos en el disco está corrupta.
- SQLITE_NOTFOUND (int)
Tabla o registro (internos) no encontrados.
- SQLITE_FULL (int)
No se pudo reañizar la inserción porque la base de datos está llena.
- SQLITE_CANTOPEN (int)
No se pudo abrir el archivo de la base de datos.
- SQLITE_PROTOCOL (int)
Error de bloqueo de base de datos.
- SQLITE_EMPTY (int)
La tabla (interna) de la base de datos está vacía.
- SQLITE_SCHEMA (int)
Se ha cambiado el esquema de la base de datos.
- SQLITE_TOOBIG (int)
Demasiados datos para una fila de la tabla.
- SQLITE_CONSTRAINT (int)
Interrupción debida a la violación de una restricción (constraint).
- SQLITE_MISMATCH (int)
Confusión en el tipo de los datos.
- SQLITE_MISUSE (int)
La librería se empleó de forma incorrecta.
- SQLITE_NOLFS (int)
Se intentó utilizar unas características de SO no soportadas en el sistema.
- SQLITE_AUTH (int)
Error de autenticación.
- SQLITE_ROW (int)
El proceso interno dispone de otra fila.
- SQLITE_DONE (int)
El proceso interno ha finalizado la ejecución.
Clases predefinidas
SQLiteDatabase
Representa una base de datos de SQLite abierta.
Constructor
__construct - construye un nuevo objeto de tipo SQLiteDatabase
Métodos
query - Ejecuta una consulta
queryExec - Ejecuta una consulta sin resultado
arrayQuery - Ejecuta una consulta y devuelve 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 que devuelve el resultado de forma inmediata (unbuffered)
lastInsertRowid - Devuelve el identificador de la última fila que se ha insertado
changes - Devuelve el número de filas que se han modificado tras la última sentencia SQL
createAggregate - Registra una FDU (Función Definida por el Usuario) empleada para agregar resultados en las sentencias SQL
createFunction - Registra una FDU (Función Definida por el Usuario) para emplearla en las sentencias SQL
busyTimeout - Establece el valor o deshabilita la duración del temporizador de ocupado
lastErorr - Devuelve el último código de error del último error producido
fetchColumnTypes - Devuelve una matriz con los tipos de las columnas de una tabla determinada
SQLiteResult
Representa un resultado almacenado (buffered) de SQLite
Métodos
fetch - Obtiene la siguiente fila del resultado y la devuelve como una matriz
fetchObject - Obtiene la siguiente fila del resultado y la devuelve como un objeto
fetchSingle - Obtiene la primera columna del resultado y la devuelve en una cadena
fetchAll - Obtiene todas las filas del resultado y las devuelve como una matriz de matrices
column - Obtiene una columna de la fila actual del resultado
numFields - Obtiene el n´mero de campos del resultado
fieldName - Obtiene el nombre de un campo del resultado
current - Obtiene la fila actual del resultado y la devuelve como una matriz
key - Obtiene el índice de la fila actual
next - Se desplaza hasta el siguiente número de fila
valid - Indica si hay disponibles más filas
rewind - Se desplaza hasta el primer número de fila del resultado
prev - Se desplaza hasta el anterior número de fila
hasPrev - Indica si hay disponible alguna fila anterior
numRows - Obtiene el n´mero de filas en el resultado
seek - Se desplaza hasta un determinado número de fila
SQLiteUnbuffered
Representa un resultado no almacenado (unbuffered) de SQLite. Los resultados no almacenados son secuenciales y por tanto solamente se puede avanzar en ellos (no retroceder).
Métodos
fetch - Obtiene la siguiente fila del resultado y la devuelve como una matriz
fetchObject - Obtiene la siguiente fila del resultado y la devuelve como un objeto
fetchSingle - Obtiene la primera columna del resultado y la devuelve en una cadena
fetchAll - Obtiene todas las filas del resultado y las devuelve como una matriz de matrices
column - Obtiene una columna de la fila actual del resultado
numFields - Obtiene el n´mero de campos del resultado
fieldName - Obtiene el nombre de un campo del resultado
current - Obtiene la fila actual del resultado y la devuelve como una matriz
next - Se desplaza hasta el siguiente número de fila
valid - Indica si hay disponibles más filas
Configuración en tiempo de ejecución
El comportamiento de estas funciones está afectado por los valores definidos en php.ini.
Tabla 1. Configure Options de SQLite
| Name | Default | Changeable | Registro de cambios |
|---|---|---|---|
| sqlite.assoc_case | "0" | PHP_INI_ALL | Disponible desde PHP 5.0.0. |
A continuación se presenta una corta explicación de las directivas de configuración.
- sqlite.assoc_case int
Uso de índices hash sin distinguir mayúsculas y minúsculas (0), solo mayúsculas (1) o solo minúsculas(2).
Esta opción se emplea cuando se requiere compatibilidad con otros sistemas de bases de datos, donde los nombres de las columnas siempre se devuelven o en mayúsculas o en minúsculas, independientemente de la forma en la que se almacenan los nombres de los campos en el esquema de la base de datos.
La librería SQLite devuelve el nombre de las columnas tal y como aparecen en el esquema de base de datos. Si el valor de sqlite.assoc_case es 0, se mantendrán los nombres originales. Si se pone a 1 o a 2, PHP convertirá los nombres originales a mayúsculas o en minúsculas respectivamente.
El uso de esta opción introduce una pequeña penalización en el rendimiento, pero es significativamente más rápida que hacerlo manualmente en el script de PHP.
- Tabla de contenidos
- sqlite_array_query -- Ejecuta una consulta contra una base de datos y devuelve el resultado en forma de matriz
- sqlite_busy_timeout -- Establece la duración del temporizador de ocupado o deshabilita los temporizadores
- sqlite_changes -- Devuelve el número de filas que se han modificado en la última sentencia SQL
- sqlite_close -- Cierra una base de datos SQLite abierta
- sqlite_column -- Obtiene una columna de la fila actual del resultado
- sqlite_create_aggregate -- Registra una FDU (función definida por el usuario) de grupo normal para su uso en sentencias SQL
- sqlite_create_function -- Registra una FDU (función definida por el usuario) normal para su uso en sentencias SQL
- sqlite_current -- Obtiene la fila actual del resultado en forma de matriz
- sqlite_error_string -- Devuelve la descripción del error producido a partir de un código de error
- sqlite_escape_string -- Escapa una cadena de texto para poder usarla como parámetro en una consulta
- sqlite_exec -- Ejecuta una consulta que no produce resultado
- sqlite_factory -- Abre una base de datos SQLite y devuelve un objeto SQLiteDatabase
- sqlite_fetch_all -- Obtiene todas las filas del resultado en forma de matriz de matrices
- sqlite_fetch_array -- Obtiene la siguiente fila del resultado en forma de matriz
- sqlite_fetch_column_types -- Obtiene una matriz con los tipos de las columnas de una tabla
- sqlite_fetch_object -- Obtiene la siguiente fila del resultado en forma de objeto
- sqlite_fetch_single -- Obtiene la primera columna del resultado en forma de cadena
- sqlite_fetch_string -- Alias of sqlite_fetch_single()
- sqlite_field_name -- Obtiene el nombre de un campo
- sqlite_has_more -- Indica si existen más filas disponibles
- sqlite_has_prev -- Indica si está 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 producido en la base de datos
- sqlite_last_insert_rowid -- Devuelve el identificador de fila de la última fila insertada
- sqlite_libencoding -- Devuelve la codificación de la librería SQLite que se está empleando
- sqlite_libversion -- Devuelve la versión de la librería SQLite que se está empleando
- sqlite_next -- Se desplaza hasta el siguiente número de fila
- sqlite_num_fields -- Obtiene el número de campos de un resultado
- sqlite_num_rows -- Obtiene el número de filas de un resultado almacenado (buffered)
- sqlite_open -- Abre una base de datos de SQLite y la crea si no existía
- sqlite_popen -- Abre una base de datos de SQLite de forma persistente y la crea si no existía
- sqlite_prev -- Se desplaza hasta el anterior número de fila
- sqlite_query -- Ejecuta una consulta sobre la base de datos y devuelve un manejador del resultado
- sqlite_rewind -- Se desplaza hasta el primer número de fila
- sqlite_seek -- Se desplaza hasta un determinado número de fila de un resultado almacenado (buffered)
- sqlite_single_query -- Ejecuta una consulta y devuelve o una matriz para una columna o el valor de la primera fila
- sqlite_udf_decode_binary -- Decodifica los datos binarios que se pasan como parámetro a las funciones FDU (función definida por el usuario)
- sqlite_udf_encode_binary -- Codifica los datos binarios antes de devolverlos de una FDU (función definida por el usuario)
- sqlite_unbuffered_query -- Ejecuta una consulta sobre la base de datos cuyo resultado no almacena todos los datos devueltos
- sqlite_valid -- Indica si hay más filas disponibles en el resultado
a simplier way to find out if a table exists:
<?php
$db=sqlite_open('mydb.sqlite', 0666, $sqliteerror);
$query = sqlite_query($db, "SELECT name FROM sqlite_master WHERE type='table' and name='the_table_Im_looking_for'");
$totaltables = sqlite_num_rows($query);
if ($totaltables<1){
/* table does not exist...create it or do something... */
}
else{
/* table exists...don't create again , do something else */
}
?>
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.
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.
<$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.
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
?>
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;
}
?>
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!
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.
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
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
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");
}
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;
}
?>
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);
}
?>
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.
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
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 ;)
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
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.
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
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
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.
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.
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)
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"
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
