PDO_SQLITE DSN

(PECL PDO_SQLITE >= 0.2.0)

PDO_SQLITE DSNSQLite データベースに接続する

説明

PDO_SQLITE データソース名 (DSN) は以下の要素で構成されます:

DSN 接頭辞 (SQLite 3)

DSN 接頭辞は sqlite: です。

  • ディスク上のデータベースにアクセスするには、 DSN 接頭辞に絶対パスを付加してください。

  • メモリ内にデータベースを生成するには、 DSN 接頭辞に :memory: を付加してください。

DSN 接頭辞 (SQLite 2)

PHP 5.1 における SQLite 拡張モジュールは SQLite 2 データベースへのアクセスと生成機能を サポートする PDO ドライバを提供しています。 これにより、PHP の以前のバージョンにおける SQLite 拡張を用いて生成したデータベースにアクセスすることが可能です。

注意:

SQLite 2 ドライバは PDO と ext/sqlite を有効にした場合、 PHP 5.1.x でのみ利用可能です。現時点では PECL 経由では利用できません。

SQLite 2 データベースに接続するための DSN 接頭辞は sqlite2: です。

  • ディスク上のデータベースにアクセスするには、 DSN 接頭辞に絶対パスを付加してください。

  • メモリ内にデータベースを生成するには、 DSN 接頭辞に memory: を付加してください。

例1 PDO_SQLITE DSN の例

以下の例は、SQLite データベースへの接続するための PDO_SQLITE DSN を表します:

sqlite:/opt/databases/mydb.sq3
sqlite::memory:
sqlite2:/opt/databases/mydb.sq2
sqlite2::memory:

add a note add a note

User Contributed Notes 5 notes

up
17
frederic dot glorieux at diple dot net
6 years ago
In memory sqlite has some limitations. The memory space could be the request, the session, but no way seems documented to share a base in memory among users.

For a request, open your base with the code
$pdo = new PDO( 'sqlite::memory:');
and your base will disapear on next request.

For session persistency
<?php
$pdo
= new PDO(
   
'sqlite::memory:',
   
null,
   
null,
    array(
PDO::ATTR_PERSISTENT => true)
);
?>
up
9
rick
11 years ago
Don't forget "extension=php_pdo_sqlite.dll" has to be enabled in php.ini (if you use xampp is will be disabled by default) .
up
6
FST777
9 years ago
@ Fatmoon
That is correct. SQLite sometimes uses additional files in the same folder while writing to the DB. These files can sometimes be seen and usually contain the name of your DB and the word 'journal' in their filename.
Security wise, it might be a good idea to store the SQLite databases in a seperate folder to shield the rest from user www.
up
7
Fatmoon
9 years ago
It seems that the directory that contains your sqlite database must be writeable by the web server. Making just the file writeable won't work.
up
2
casteele at g-m-a-i-l ( dot ) c-o-m
1 year ago
Some notes that may or may not be obvious..

In general, when using an in-memory (:memory:) database from within a PHP script (such as code in an index.php file for a web server), the memory used for the database exists only as long as the PHP code is running. Usually, this is only as long as it takes to deliver output back to the web server trying to serve the web page to the client. There is no way (that I know of, please correct me if I'm wrong) to share an in-memory database across different web connections, including different multiple connections from the same client. *This does include "persistent" connections.* The reason for this is because in-memory databases *are* in-memory databases, and the memory allocated by the web server/PHP processor is allocated and released "on the fly". Otherwise, web servers which serve thousands of web pages would quickly consume all available memory (and swap space), and come to a grinding halt when the system no longer has available memory to handle more requests.

If you need to share data across sessions, connections, or scripts, you'll need to use a database file in a folder/directory which is *writable* by the web server/PHP extension, as SQLite3 may use some temporary files while working with the database. (In my Debian Linux installation, this is the "www-data" psuedo-user/group.) (You can consult the SQLite3 documentation if you wish to know what temporary files it uses; They are well-documented.)

In short, it is a _logical_error_ to think of in-memory databases as anything other than very short-term temporary databases. They may be useful if you only wish to work with a subset of a larger database within *a single web page, AND only while the PHP script is generating the web page*. That is, you cannot use in-memory databases to store a user's "shopping cart", for example, because a shopping cart would still need to load many different web pages, invoking many different PHP scripts, each with their own memory space. Likewise, once PHP has generated the output of the web page for the server to send on to the client, PHP is no longer "part of the picture", and any memory it had allocated may be freed for other uses--including your in-memory database.

This is not a limitation of the web server, PHP, or SQLite, but of how operating systems work in general to share limited resources (such as memory) between processes/users/connections/et cetera.
To Top