array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'pdo.connect.php', 1 => 'PDO::connect', 2 => 'Conecta a una base de datos y devuelve una subclase PDO para los controladores que lo soportan', ), 'up' => array ( 0 => 'class.pdo.php', 1 => 'PDO', ), 'prev' => array ( 0 => 'pdo.commit.php', 1 => 'PDO::commit', ), 'next' => array ( 0 => 'pdo.construct.php', 1 => 'PDO::__construct', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/pdo/pdo/connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDO::connect

(PHP 8 >= 8.4.0)

PDO::connect — Conecta 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 Data Source Name, o DSN, que contiene las informaciones requeridas para conectarse a la base de datos.

Generalmente, un DSN está compuesto por el nombre del controlador PDO, seguido de una sintaxis específica del controlador. Más detalles están disponibles en la documentación PDO de cada controlador.

El parámetro dsn soporta tres métodos diferentes para especificar los argumentos necesarios para la creación de la base de datos:

Invocación de controlador

dsn contiene el DSN completo.

Invocación URI

dsn está compuesto por uri: seguido por una URI que define la localización del fichero que contiene la cadena DSN. La URI puede especificar un fichero local o remoto.

uri:file:///path/to/dsnfile

Aliasing

dsn está compuesto por un nombre name que corresponde a pdo.dsn.name en el fichero php.ini, y que define la cadena DSN.

Nota:

El alias debe ser definido en el fichero php.ini, y no en un fichero .htaccess o httpd.conf

username

El nombre de usuario para la cadena DSN. Este parámetro es opcional para algunos controladores PDO.

password

La contraseña de la cadena DSN. Este parámetro es opcional para algunos controladores PDO.

options

Un array clave=>valor con las opciones específicas de conexión.

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

Se lanza una excepción PDOException si el intento de conexión a la base de datos solicitada falla, independientemente del PDO::ATTR_ERRMODE actualmente definido.

Ver también