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.
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 bufferisé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 bufferisé.
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-bufferisé. Les jeux de résultats non-bufferisé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 agrégeante 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 bufferisée
- sqlite_valid — Retourne si oui ou non il reste des lignes disponibles
add a note
User Contributed Notes 17 notes
papafox888 at hotmail dot com ¶
18 years ago
heinemann.juergen AT t-online.de ¶
19 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
?>
bart at mediawave dot nl ¶
19 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
Anonymous ¶
19 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;
}
?>
dotwho at NOSPAM dot mac dot com ¶
19 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
cricket at djcricket dot com ¶
20 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.
CraquePipe ¶
13 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.
?>
nicolas dot toniazzi at free dot fr ¶
20 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;
}
?>
artooro at gmail dot com ¶
20 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.
j-pieper at NOSPAM dot web dot de ¶
20 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
david at acz dot org ¶
20 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.
Anonymous ¶
20 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
csaba at alum dot mit dot edu ¶
20 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
Minots Estich <minots at D0X dot de> ¶
21 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"
hunreal+php at gmail dot com ¶
19 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");
}
jlsalinas at spamsucks dot gmx dot net ¶
20 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.
vpupkin at comcast dot net ¶
20 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)
