PDO::connect

(PHP 8 >= 8.4.0)

PDO::connectConecta a una base de datos y devuelve una subclase PDO para los controladores que lo soportan

Descripción

public static PDO::connect(
    string $dsn,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?array $options = null
): static

Crea una instancia de una subclase de PDO para la base de datos conectada si existe, de lo contrario devuelve una instancia genérica de PDO.

Parámetros

dsn

EL Nombre del Origen de Datos (DSN), contiene la información requerida para conectarse a la base de datos.

En general, un DSN consiste en el nombre del controlador de PDO, seguido por dos puntos, seguido por la sintaxis específica del controlador de PDO para la conexión. Hay más información disponible en la documentación de controladores específicos de PDO.

El parámetro dsn admite tres métodos diferentes de especificar los parámetros requeridos para crear la conexión a la base de datos:

Invocación del controlador

dsn contiene el DSN completo.

Invocación del URI

dsn está formado por uri: seguido por un URI que define la ubicación de un fichero que contiene el string del DSN. El URI puede especificar un fichero local o un URL remoto.

uri:file:///ruta/al/fichero_dsn

Mediante un alias

dsn está formado por un nombre, name, que se corresponde con pdo.dsn.name en php.ini, definiendo el string del DSN.

Nota:

El alias debe estar definido en php.ini, y no en .htaccess o httpd.conf

username

El nombre de usuario para el string del DSN. Este parámetro es opcional para algunos controladores de PDO.

password

La contraseña para el string del DSN. Este parámetro es opcional para algunos controladores de PDO.

options

Un array de la forma clave=>valor con opciones de conexión específicas del controlador.

Valores devueltos

Devuelve una instancia de una subclase de PDO para el controlador PDO correspondiente si existe, o una instancia genérica de PDO.

Errores/Excepciones

PDO::__construct() lanza una PDOException si el intento de conexión a la base de datos requerida falla.

Ver también

  • Pdo\Dblib
  • Pdo\Firebird
  • Pdo\Mysql
  • Pdo\Odbc
  • Pdo\Pgsql
  • Pdo\Sqlite
  • PDO::__construct() - Crea una instancia de PDO que representa una conexión a una base de datos
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top