Edit Report a Bug

SQLite 関数

定義済みクラス

SQLiteDatabase

オープンされている SQLite データベースを表す

コンストラクタ

__construct - 新規 SQLiteDatabase オブジェクトを生成する

メソッド

query - クエリを実行する
queryExec - 結果を返さないクエリを実行する
arrayQuery - クエリを実行し、結果を配列として返す
singleQuery - クエリを実行し、単一カラムに対する配列もしくは先頭行の値を返す
unbufferedQuery - バッファされていないクエリを実行する
lastInsertRowid - 直近に挿入された行の行 ID を返す
changes - 直近のステートメントにより更新された行数を返す
createAggregate - SQL ステートメントで使用する集約 UDF を登録する
createFunction - SQL ステートメントで使用する UDF を登録する
busyTimeout - ビジータイムアウト時間を設定または無効にする
lastError - 直近に発生したエラーのエラーコードを返す

SQLiteResult

バッファされた SQLite の結果セットを表す

メソッド

fetch - 結果セットから次行を配列として取得する
fetchSingle - 結果セットから先頭カラムを文字列として取得する
fetchAll - 結果セットから全行を配列の配列として取得する
column - 結果セットの現在行からカラムを取得する
numFields - 結果セット内のフィールド数を返す
fieldName - 結果セット内の特定フィールドの名前を返す
current - 結果セットから現在行を配列として取得する
next - 次の行番号へシークする
rewind - 結果セットの先頭の行番号へシークする
numRows - 結果セットの行数を返す
seek - 特定の行番号へシークする

SQLiteUnbuffered

バッファされていない SQLite 結果セットを表します。バッファされていない結果セットはシーケンシャルで、前方シークのみ可能です。

メソッド

fetch - 結果セットから次行を配列として取得する
fetchSingle - 結果セットから先頭カラムを文字列として取得する
fetchAll - 結果セットから全行を配列の配列として取得する
column - 結果セットの現在行からカラムを取得する
numFields - 結果セット内のフィールド数を返す
fieldName - 結果セット内の特定フィールドの名前を返す
current - 結果セットから現在行を配列として取得する
next - 次の行番号へシークする

sqlite_array_query — 指定したデータベースに対してクエリを実行し、配列を返す
sqlite_busy_timeout — ビジータイムアウト時間を設定またはビジーハンドラを無効にする
sqlite_changes — 直近のSQLステートメントにより変更されたレコード数を返す
sqlite_close — オープンされたSQLiteデータベースを閉じる
sqlite_column — カレントの結果セットのレコードからカラムを1列取得する
sqlite_create_aggregate — SQLステートメントで使用する集約UDFを登録する
sqlite_create_function — SQLステートメントで使用するために"通常の"ユーザー定義関数を登録する
sqlite_current — 結果セットからカレントのレコードを配列として取得する
sqlite_error_string — エラーコードの説明を返す
sqlite_escape_string — クエリパラメータ用に文字列をエスケープする
sqlite_exec — 与えられたデータベースに対して結果を伴わないクエリを実行する
sqlite_fetch_all — 結果セットから全てのレコードを配列の配列として取得する
sqlite_fetch_array — 結果セットから次のレコードを配列として取得する
sqlite_fetch_single — 結果セットの最初のカラムを文字列として取得する
sqlite_fetch_string — sqlite_fetch_single のエイリアス
sqlite_field_name — 特定のフィールドの名前を返す
sqlite_has_more — まだレコードがあるかないかを返す
sqlite_last_error — データベースに関する直近のエラーコードを返す
sqlite_last_insert_rowid — 直近に挿入されたレコードのrowidを返す
sqlite_libencoding — リンクされているSQLiteライブラリのエンコーディングを返す
sqlite_libversion — リンクされているSQLiteライブラリのバージョンを返す
sqlite_next — 次のレコード番号へシークする
sqlite_num_fields — 結果セットのフィールド数を返す
sqlite_num_rows — 結果セットのレコード数を返す
sqlite_open — SQLiteデータベースをオープンする。データベースが存在しない場合は作成する
sqlite_popen — SQLiteデータベースへの持続的ハンドルをオープンする。存在しない場合には、データベースを作成する
sqlite_query — 指定したデータベースに対してクエリを実行し、結果ハンドルを返す
sqlite_rewind — 先頭レコード番号へシークする
sqlite_seek — 特定のレコード番号へシークする
sqlite_single_query — クエリを実行し、単一カラムもしくは先頭レコードの値に対する配列を返す
sqlite_udf_decode_binary — UDFにパラメータとして渡されたバイナリデータをデコードする
sqlite_udf_encode_binary — UDFから返す前にバイナリデータをエンコードする
sqlite_unbuffered_query — 事前取得していないクエリを実行し、全てのデータをバッファリングする

add a note

User Contributed Notes 17 notes

down

papafox888 at hotmail dot com ¶

17 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.

down

heinemann.juergen AT t-online.de ¶

18 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

?>

down

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

down

Anonymous ¶

18 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;
}
?>

down

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

down

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.

down

CraquePipe ¶

12 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.
?>

down

nicolas dot toniazzi at free dot fr ¶

19 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;
}
?>

down

artooro at gmail dot com ¶

19 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.

down

j-pieper at NOSPAM dot web dot de ¶

19 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

down

david at acz dot org ¶

19 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.

down

Anonymous ¶

19 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

down

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

down

Minots Estich <minots at D0X dot de> ¶

20 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"

down

-1

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");
}

down

-2

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.

down

-1

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)

add a note

SQLite 関数

定義済みクラス

SQLiteDatabase

コンストラクタ

メソッド

SQLiteResult

メソッド

SQLiteUnbuffered

メソッド

目次

User Contributed Notes 17 notes