dbx_connect
(PHP 4 >= 4.0.6, PHP 5 <= 5.0.5, PECL dbx:1.1.0)
dbx_connect — kapcsolódik egy adatbázishoz
Leírás
Sikeres csatlakozáskor egy object-et ad vissza, hiba esetén pedig FALSE-t. Ha sikerült a kapcsolatot létesíteni, de a megadott adatbázis nem elérhető, akkor a kapcsolatot lezárja és FALSE-t ad vissza. A persistent paraméternek DBX_PERSISTENT értéket adva perzisztens adatbázis kapcsolatot nyit.
A module paraméter lehet sztring is, de inkább a felsorolt állandók valamelyike használandó. A lehetséges értékek alább láthatók, de figyelembe veendő, hogy csak akkor működnek, ha az adott modul be van töltve.
- DBX_MYSQL vagy "mysql"
- DBX_ODBC vagy "odbc"
- DBX_PGSQL vagy "pgsql"
- DBX_MSSQL vagy "mssql"
- DBX_FBSQL vagy "fbsql" (PHP 4.1.1-től kezdve)
- DBX_SYBASECT vagy "sybase_ct" (PHP 4.2.0-tól kezdve)
A visszaadott objektum három tagváltozóval rendelkezik:
- database
- Az aktuálisan kiválasztott adatbázis nevét tartalmazza.
- handle
-
Ennek a kapcsolatazonosítónak a segítségével szükség esetén az adott modulra jellemző függvények valamelyike hívható meg.
<?php
$link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close ($link->handle); // dbx_close($link) használata itt sokkal jobb lenne...
?> - module
- Ezt a dbx kiterjesztés tartja fenn belső használatra, az éppen használt modul számát tárolja.
A host , database , username és a password paraméterek kötelezőek, de nem mindig kerülnek felhasználásra a modul ténylegesen kapcsolatot létesítő függvényétől függően.
Example#1 dbx_connect() példa
<?php
$link = dbx_connect (DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
or die ("Nem sikerült kapcsolódni.");
print ("Sikeresen kapcsolódtam.");
dbx_close ($link);
?>
Note: Használd mindig az adatbázis specifikus dokumentációt is!
Lásd még: dbx_close()!