sqlite_open

PHP マニュアル
前のページ		次のページ

説明

resource sqlite_open ( string filename [, int mode [, string &error_message]] )

オブジェクト指向言語型スタイル (メソッド):

class SQLiteDatabase {

__construct ( string filename [, int mode [, string &error_message]] )

}

SQLite データベースをオープン、もしくは存在しない場合データベースを生成します。

パラメータ

filename: SQLite データベースのファイル名。もしこのファイルが存在しない場合、 SQLite はファイルを生成しようとします。データを挿入したり、データベーススキーマを変更、もしくはデータベースが存在しない場合にデータベースを生成する場合、 PHP はファイルに対する書き込み権限を持っている必要があります。
mode: ファイルのモード。読み込み専用モードでデータベースをオープンするために使用することを目的としています。現在、このパラメータは SQLite ライブラリに無視されます。このモードのデフォルト値は、 8 進数値 0666 で、これは推奨される値です。
error_message: 参照として渡され、エラーが発生した場合にデータベースがオープンできなかった原因を説明する記述的なエラーメッセージを保持するために設定されます。

返り値

成功時にリソース (データベースハンドル)、失敗時に FALSE を返します。

例

例 1. sqlite_open() の例


<?php
if ($db = sqlite_open('mysqlitedb', 0666, $sqliteerror)) {
    sqlite_query($db, 'CREATE TABLE foo (bar varchar(10))');
    sqlite_query($db, "INSERT INTO foo VALUES ('fnord')");
    $result = sqlite_query($db, 'select bar from foo');
    var_dump(sqlite_fetch_array($result));
} else {
    die($sqliteerror);
}
?>

注意

ティップ: Unix環境では、SQLiteはシステムコールfork()を使用するスクリプトの影響を受け易いです。このようなスクリプトがある場合、子プロセスを生成する前にハンドルを閉じ、子プロセスまたは親プロセスから再度オープンすることが推奨されます。この問題に関する詳細な情報については、 マルチスレッドおよびSQLiteという名前のセクションにある SQLiteライブラリへのC言語インターフェイスを参照してください。

ティップ: NFSパーティションにマウントされたSQLiteデータベースを処理することは推奨されません。ロックに関してNFSは著しい問題があるので、データベースを全くオープンすることさえできない可能性があります。また、成功した場合でも、ロックに関する動作は予測できない結果を生む可能性があります。

注意: SQLiteライブラリバージョン2.8.2以降、コンピュータのメモリ上にのみ存在するデータベースを作成するために filenameに:memory:を指定することができます。これは、メモリ上のデータベースは処理完了時に破棄されるため、テンポラリな処理を行う場合には有用です。他のデータベースをロードし、データを相互に移動したりクエリを実行したりするために ATTACH DATABASE SQLステートメントと組み合わせる場合にも有用です。

注意: SQLite はセーフモードおよび open_basedir に対応しています。

前のページ	ホーム	次のページ
sqlite_num_rows	上に戻る	sqlite_popen

sqlite_open

説明

パラメータ

返り値

例

注意

参考