SQLite
Предопределенные классы
SQLiteDatabase
Represents an opened SQLite database.
Конструктор
-
__construct - construct a new SQLiteDatabase object
Методы
-
query - Execute a query
-
queryExec - Execute a result-less query
-
arrayQuery - Execute a query and return the result as an array
-
singleQuery - Execute a query and return either an array for one single column or the value of the first row
-
unbufferedQuery - Execute an unbuffered query
-
lastInsertRowid - Returns the rowid of the most recently inserted row
-
changes - Returns the number of rows changed by the most recent statement
-
createAggregate - Register an aggregating UDF for use in SQL statements
-
createFunction - Register a UDF for use in SQL statements
-
busyTimeout - Sets or disables busy timeout duration
-
lastError - Returns the last error code of the most recently encountered error
-
fetchColumnTypes - Return an array of column types from a particular table
SQLiteResult
Represents a buffered SQLite result set.
Методы
-
fetch - Fetches the next row from the result set as an array
-
fetchObject - Fetches the next row from the result set as an object
-
fetchSingle - Fetches the first column from the result set as a string
-
fetchAll - Fetches all rows from the result set as an array of arrays
-
column - Fetches a column from the current row of the result set
-
numFields - Returns the number of fields in the result set
-
fieldName - Returns the name of a particular field in the result set
-
current - Fetches the current row from the result set as an array
-
key - Return the current row index
-
next - Seek to the next row number
-
valid - Returns whether more rows are available
-
rewind - Seek to the first row number of the result set
-
prev - Seek to the previous row number of the result set
-
hasPrev - Returns whether or not a previous row is available
-
numRows - Returns the number of rows in the result set
-
seek - Seek to a particular row number
SQLiteUnbuffered
Represents an unbuffered SQLite result set. Unbuffered results sets are sequential, forward-seeking only.
Методы
-
fetch - Fetches the next row from the result set as an array
-
fetchObject - Fetches the next row from the result set as an object
-
fetchSingle - Fetches the first column from the result set as a string
-
fetchAll - Fetches all rows from the result set as an array of arrays
-
column - Fetches a column from the current row of the result set
-
numFields - Returns the number of fields in the result set
-
fieldName - Returns the name of a particular field in the result set
-
current - Fetches the current row from the result set as an array
-
next - Seek to the next row number
-
valid - Returns whether more rows are available
Содержание
- sqlite_array_query — Выполняет запрос к базе данных и возвращает результат в виде массива
- sqlite_busy_timeout — Устанавливает время ожидания
- sqlite_changes — Возвращает количество записей, которые были изменены последним SQL запросом
- sqlite_close — Закрывает базу данных SQLite
- sqlite_column — Выбирает одно поле из текущей записи результата запроса
- sqlite_create_aggregate — Регистрирует агрегатную функцию для использования в SQL запросах
- sqlite_create_function — Регистрирует функцию для использования в SQL запросах
- sqlite_current — Возвращает текущую запись результата запроса в массиве
- sqlite_error_string — Возвращает строку с описанием ошибки
- sqlite_escape_string — Экранирует спецсимволы в строке для использования в запросе
- sqlite_exec — Выполняет запрос, не возвращающий записей
- sqlite_factory — Открывает базу данных SQLite и возвращает объект
- sqlite_fetch_all — Выбирает все записи из результата запроса и возвращает массив массивов
- sqlite_fetch_array — Выбирает следующую запись из результата запроса и возвращает массив
- sqlite_fetch_column_types — Возвращает массив, содержащий информацию о типах полей в таблице
- sqlite_fetch_object — Выбирает следующую запись из результата запроса и возвращает объект
- sqlite_fetch_single — Выбирает значение первого поля из результат запроса в виде строки
- sqlite_fetch_string — Псевдоним функции sqlite_fetch_single
- sqlite_field_name — Возвращает имя указанного поля результата запроса
- sqlite_has_more — Определяет, есть ли еще записи в результате запроса
- sqlite_has_prev — Определяет, доступна ли предыдущая запись
- sqlite_key — Returns the current row index
- sqlite_last_error — Возвращает код ошибки последней операции с SQLite
- sqlite_last_insert_rowid — Возвращает идентификатор последней вставленной записи
- sqlite_libencoding — Возвращает кодировку, используемую подключенной библиотекой SQLite
- sqlite_libversion — Возвращает версию подключенной библиотеки SQLite
- sqlite_next — Переходит на следующую запись
- sqlite_num_fields — Возвращает количество полей в результате запроса
- sqlite_num_rows — Возвращает количество записей в результате запроса
- sqlite_open — Открывает или создает базу данных SQLite
- sqlite_popen — Открывает или создает базу данных SQLite, делая подключение постоянным
- sqlite_prev — Переходит на предыдущую запись
- sqlite_query — Выполняет запрос к базе данных и возвращает идентификатор результата
- sqlite_rewind — Переходит к первой записи
- sqlite_seek — Переходит к определенному номеру записи
- sqlite_single_query — Выполняет SQL зпрос и возвращает массив со значениями одного поля или первую запись
- sqlite_udf_decode_binary — Декодирует бинарные данные, переданные в пользовательскую функцию
- sqlite_udf_encode_binary — Кодирует бинарные данные, возвращаемые пользовательской функцией
- sqlite_unbuffered_query — Выполняет запрос без буферизации результатов
- sqlite_valid — Returns whether more rows are available
Коментарии
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"
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)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.
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.
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
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
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.
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
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.
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;
}
?>
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");
}
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
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
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;
}
?>
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
?>
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.
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.
?>