(PHP 4 >= 4.0.6, PHP 5 < 5.1.0, PECL dbx >= 1.1.0)
dbx_connect — Abrir una conexión/base de datos
$module
, string $host
, string $database
, string $username
, string $password
[, int $persistent
] ) : objectAbre una conexión a una base de datos.
module
El parámetro module puede ser una cadena o una
constante, aunque se prefiere la segunda forma. Los valores posibles se
dan a continuación, pero tenga en mente que sólo funcionan si en realidad
el módulo está cargado.
DBX_MYSQL o "mysql"
DBX_ODBC o "odbc"
DBX_PGSQL o "pgsql"
DBX_MSSQL o "mssql"
DBX_FBSQL o "fbsql"
DBX_SYBASECT o "sybase_ct"
DBX_OCI8 o "oci8"
DBX_SQLITE o "sqlite"
hostEl host servidor de SQL
databaseEl nombre de la base de datos
usernameEl nombre de usuario
passwordLa contraseña
persistent
El parámetro persistent puede ser establecido a
DBX_PERSISTENT, si es así, se creará una
conexión persistente.
Los parámetros host, database,
username y password
son comunes, pero no siempre se usan en las funciones de
conexión para el módulo abstracto.
Devuelve un objeto si se tuvo éxito, FALSE si ocurrió un error. Si se ha hecho una
conexión pero no se ha podido seleccionar la base de datos, la conexión se cerrará y
se devolverá FALSE.
El objeto dado por object devuelto tiene tres propiedades:
Es un gestor válido para la base de datos conectada, y como tal se puede usar en funciones específicas del módulo (si se necesita).
<?php
$enlace = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close($enlace->handle); // dbx_close($enlace) sería mejor aquí
?>
| Versión | Descripción |
|---|---|
| 5.0.0 |
Se introdujo DBX_SQLITE.
|
| 4.3.0 |
Se introdujo DBX_OCI8.
|
| 4.2.0 |
Se introdujo DBX_SYBASECT.
|
| 4.1.0 |
Se introdujo DBX_FBSQL.
|
Ejemplo #1 Ejemplo de dbx_connect()
<?php
$enlace = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
or die("No se pudo conectar");
echo "Conectado satisfactoriamente";
dbx_close($enlace);
?>
Nota:
Consulte siempre la documentación específica del módulo también.