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.
Note: További információk az SQLite-al kapcsolatban annak webhelyérÅ‘l szerezhetÅ‘k be (» https://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:
| 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.
| Név | Alapértelmezett érték | Megváltoztathatóság |
|---|---|---|
| sqlite.assoc_case | 0 | PHP_INI_ALL |
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.
Table of Contents
- sqlite_array_query — Végrehajt egy SQL kérés az adott adatbázison, az eredményt tömbben visszaadva
- sqlite_busy_timeout — BeállÃtja a várakozási idÅ‘túllépés értékét, vagy a várakozás nélküli üzemmódot
- sqlite_changes — A legutóbb végrehajtott SQL kérés által módisult sorok számát adja meg
- sqlite_close — Egy megnyitott SQLite adatbázist lezár
- sqlite_column — Az eredménylista aktuális sorából egyetlen oszlop kiolvasása
- sqlite_create_aggregate — Register an aggregating UDF for use in SQL statements
- sqlite_create_function — Felhasználó által definiált SQL függvény regisztrálása
- sqlite_current — Kinyeri az eredménylista aktuális sorát, tömbként visszaadva azt
- sqlite_error_string — A megadott hibakód szöveges magyarázatával tér vissza
- sqlite_escape_string — Escapes a string for use as a query parameter
- sqlite_exec — Eredmény nélküli (adatmódosÃtó) kérések futtatása adott adatbázison
- sqlite_factory — Megnyit egy SQLite adatbázist és létrehoz egy objektumot neki
- sqlite_fetch_all — Többdimentzós tömbbe gyűjti a teljes eredménylistát
- sqlite_fetch_array — Az eredménylista következő elemét nyeri ki tömbként
- sqlite_fetch_column_types — Egy adott tábla mezőneveit adja vissza
- sqlite_fetch_object — Az eredménylista soron kövezlető elemét nyeri ki adatobjektumként
- sqlite_fetch_single — Az eredménylista aktuális sorának első oszlopát sztringként kinyeri
- sqlite_fetch_string — Az sqlite_fetch_single egy álneve
- sqlite_field_name — A megadott oszlop nevét adja vissza
- sqlite_has_more — MegállapÃtja, van-e még adat az eredménylistában
- sqlite_has_prev — MegállapÃtja, van-e az aktuálisat megelÅ‘zÅ‘ adatsor az eredménylistában
- sqlite_key — Returns the current row index
- sqlite_last_error — A megadott adatbázissal kapcsolatos legutóbbi hiba kódját adja vissza
- sqlite_last_insert_rowid — A legutóbbi beszúrt sorhoz rendelt automatikusan növekvÅ‘ azonosÃtó értékét adja vissza
- sqlite_libencoding — Returns the encoding of the linked SQLite library
- sqlite_libversion — A felhaszált SQLite függvénykönyvtár változatszámát adja meg
- sqlite_next — A következő eredménysorra léptet
- sqlite_num_fields — A megadott eredményazonosÃtó által képviselt eredménylista mezÅ‘inek számát adja meg
- sqlite_num_rows — Az eredménylista sorainak számát adja vissza
- sqlite_open — SQLite adatbázis megyitása, még nem létező adatbázis létrehozása
- sqlite_popen — Opens a persistent handle to an SQLite database and create the database if it does not exist
- sqlite_prev — Az előző eredménysorra léptet
- sqlite_query — A megadott adatbázison lekérést hajt végre, visszaadva az eredménylista hivatkozást
- sqlite_rewind — Visszatekeri a mutatót az eredménylista elejére
- sqlite_seek — A pufferelt eredményazonosÃtó adott sorára helyezi annak mutatóját.
- sqlite_single_query — Végrehajtja az SQL kérést, tömbként visszaadva az eredménylista első sorát
- sqlite_udf_decode_binary — Decode binary data passed as parameters to an UDF
- sqlite_udf_encode_binary — Encode binary data before returning it from an UDF
- sqlite_unbuffered_query — A megadott adatbázison lekérést hajt végre, az eredménylistát előre ki nem nyerve
- sqlite_valid — Returns whether more rows are available