sqlite_open
(PHP 5, PECL sqlite:1.0-1.0.3)
sqlite_open — SQLite adatbázis megyitása, még nem létező adatbázis létrehozása
LeÃrás
Siker esetén egy adatbázis azonosÃtót ad vissza, a kudarcot egy FALSE visszatérési értékkel jelzi.
A filename paraméter adja meg az adatbázis nevét. A fájlnév elérési útját relatÃv és abszolút módon is meg lehet adni. Ha megadott fájl nem létezik, az SQLite megrpróbálja létrehozni azt. ELENGEDHETETLEN, hogy a megfelelÅ‘ Ãrási jogok meglegyenek az adott fájlra, ha abba adatokat akarsz illeszteni, ill. módosÃtani (törölni) akarod azokat.
A mode paraméterben adható meg a fájlmegnyitás módja, amely által a jövÅ‘ben csak olvasható módban is megnyitható egy adatbázis fájl. Jelen pillanatban az SQLite kiterjesztés figyelmen kÃvül hagyja ezt a paramétert, csupán a helye van meghagyva. Ha meg akarod adni a harmadik errmessage paramétert, ezt is szükséged lesz odatenni, ekkor annak alapértelmezését, a 0666 értéket érdemes odatenni a jövÅ‘beni kompatibilitási hibák elkerülése érdekében.
Az errmessage paraméter referenciaként adja vissza annak szöveges magyarázatát, miért is nem sikerült megnyitni az adatbázist, már ha ez az eset áll fent.
Example#1 sqlite_open() példa
<?php
if ($db = sqlite_open('elso_sqlite_adatbazisom', 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 rendszereken az SQLite érzékeny az olyan szkriptekre, amelyek alkalmazzák a fork() rendszerhÃvást. Ha ilyen alkalmazást épÃtesz, fontos, hogy a forkolás elÅ‘tt zárd le az adatbázisod, és a gyermek/szülÅ‘ szkriptben nyisd meg újfent. A dologgal kapcsolatban többet olvashatsz a » C nyelvi interfész az SQLite függvényönyvtárhoz dokumentumban, annak is a Multi-Threading és az SQLite szekciójában.
Nem igazán javallott NFS-el beemelt fájlrendszeren használni az adatbázisokat. Ennek oka, hogy az NFS fájlrendszer nem túl erÅ‘s az állományok zárolásának kezelésében. Nem minden esetben fogod tudni megnyitni az adatbázisod, és ha mégis sikerülne, elÅ‘fordulhat, hogy a fájlod zároltsága nem lesz megállapÃtható.
Note: Az SQLite 2.8.2-es változatától kezdÅ‘dÅ‘en a filename paraméterben megadható a speciális jelentéssel bÃró :memory: érték is. Ekkor az adatbázis nem jön létre a fájlrendszerben, csupán a memóriában fog létezni. Ez átmeneti adatbázis haszálat esetén hasznos, mivel a memóriában tárolt adatbázisok a szkirpt lefutásával megszűnnek. Szintén igen hasznos ezt a lehetÅ‘séget az ATTACH DATABASE SQL paranccsal együttesen használni más adatbázisok betöltésére és köztük adatmásolások, lekérések kieszközlésére hsználni.
Note: Az SQLite kiterjesztés a safe mode és az open_basedir beállÃtásoknak megfelelÅ‘en jár el.
Lásd még: sqlite_popen(), sqlite_close() és sqlite_query().