PHP kézikönyv
Előző |  | Következő

# CXLVI. SQLite

# Bevezetés

E kiterjesztés az SQLite használatához készült. Az SQLite egy C függvénykönyvtár, amely egy beágyazható SQL adatbázis motort valósít meg. Az ezzel linkelt programok külön RDBMS folyama futtatása nélkül képessé válnak SQL adatbázisok kezelésére.

Az SQLite nem egy nagy adatbázis szerverekhez kapcsolódó kliensfelület. Az SQLite egyben maga a szerver is, közvetlenül helyi fájlokkal dolgozik.

> Megjegyzés: További információk az SQLite-al kapcsolatban annak webhelyéről szerezhetők be (http://sqlite.org/).

# Telepítés

Ha forrásból telepítesz, olvasd el a csomaggal kapott INSTALL fájlt. Vagy használd a PEAR telepítőjét a következő parancsot kiadva parancssorból: "pear install sqlite". Az SQLite kiterjesztés tartalmaz mindent, ami a futásához szükséges, nem függ külső szoftverek melététől.

A Windows-hoz való DLL változat letölthető innen: (php_sqlite.dll).

A PHP 5-ben a teljes SQLite kiterjesztés alapértelmezetten része az alaptelepítésnek.

# Követelmények

Ahhoz, hogy az itt felsorolt függvényeket használatba vehesd, a PHP-t SQLite támogatással kell fordítanod, dinamukusan töltődő kiterjesztés esetén pedig a `php.ini` állományban tudod aktiválni azt.

# Erőforrás típusok

Az SQLite felülettel két új erőforrás típus kerül a vérkeringésbe. Az egyik az adatbázis kapcsolatot, a másik az SQL kérések eredményét (resultset) testesíti meg.

# Előre definiált állandók

Az sqlite_fetch_array() és az sqlite_current() függvények egy konstansban meghatűrozott értéket várnak paraméterként, amely megmondja, mi módon nyerjék ki az SQL lekérés eredményét. A következő adatkinyerési formák alkalmazhatók:

Táblázat 1. SQLite adatkinyerési-mód konstansok

konstans | értelmezés
--- | ---
SQLITE_ASSOC | A visszakapott adatsort olyan tömbben kapjuk vissza, ahol a tömbindex az adott mező neve.
SQLITE_BOTH | Kevert forma, mind számszerű indexeken, mind pedig a mezőnévnek megfelelő kulcsú tömbelemeken is visszakapjuk az adott adatsor elemeit.
SQLITE_NUM | Ez esetben az adatsort számozott indexelésű tömbben kapjuk vissza, melyben az első mező száma a 0.

# Futásidejű beállítások

Az alábbi függvények viselkedése befolyásolható a `php.ini` segítségével.

Táblázat 2. Az SQLite beállítási lehetőségei

Név | Alapértelmezett érték | Megváltoztathatóság
--- | --- | ---
sqlite.assoc_case | 0 | PHP_INI_ALL

További részletekért a PHP_INI_* konstansokkal kapcsolatban érdemes ellátogatni a dokumentáció ini_set() oldalára.

A témába vágó konfigurációs direktívák rövid leírása

sqlite.assoc_case int

  Egyaránt beállítható a névmeghagyó (0), a mezőneveket nagybetűsítő (1), vagy az ezeket kisbetűsítő (2) beállítás is.

  Ezen beállítási lehetőség arra hivatott, hogy az esetleges más adatbázis rendszerekkel való kompatibilitást megarthatóvá tegye. Erre azért van szükség, mivel egyes adatbázis rendszerek vagy csupa nagybetűvel, vagy csupa kisbetűvel azonosítják a mezőnekeveket, függetlenül az adatbázis sémában megadottól.

  Alaphelyzetben az SQLite meghagyja olyannak a mezőneveket, ahogy azok létre lettek hozva. Amennyiben az sqlite.assoc_case 0 értéket kap, ez az eljárásmód lesz használatban. Ha ezt 0-re vagy 2-re állítjuk, az SQLite ennek megfelelően negybetűsíti avagyon kisbetűsíti ezeket a neveket.

  Ezen kapcsoló elállítása a 0 állapotból kis hatékonyság-visszaeséssel jár ugyan, de mindenképp gyorsabb lesz így, mintha mi magunk tennénk meg ezen kis-nagybetű átalakításainkat a PHP szkriptjeinkben.

Előző | Tartalom | Következő
spl_classes | Fel | sqlite_array_query