(PHP 8 >= 8.4.0)
PDO::connect — Connect to a database and return a PDO subclass for drivers that support it
$dsn
,$username
= null
,$password
= null
,$options
= null
Creates an instance of a PDO subclass for the database being connection if it exists, otherwise return a generic PDO instance.
dsn
O nome da fonte de dados, ou DSN, que contém a informação requerida para conexão ao banco de dados.
Em geral, um DSN consiste no nome do driver PDO, seguido por dois-pontos, seguido pela sintaxe de conexão específica do driver PDO. Maiores informações estão disponíveis na documentação específica do driver PDO.
O parâmetro dsn
suporta três
métodos diferentes para especificar os argumentos requeridos para criação
de uma conexão de banco de dados:
dsn
contém o DSN completo.
dsn
consiste em uri:
seguido por uma URI que define a localização de um arquivo contendo
a string DSN. A URI pode especificar um arquivo local ou uma URL remota.
uri:file:///caminho/para/arquivodsn
dsn
consiste em um nome
(name
) que é mapeado para
pdo.dsn.
no php.ini
definindo a string DSN.
name
Nota:
O apelido deve ser definido no php.ini, e não no .htaccess ou no httpd.conf
username
O nome de usuário para a string DSN. Este parâmetro é opcional para alguns drivers PDO.
password
A senha para a srting DSN. Este parâmetro é opcional para alguns drivers PDO.
options
Um array de chave=>valor de opções de conexão específicas do driver.
Returns an instance of a PDO subclass for the corresponding PDO driver if it exists, or a generic PDO instance.
Uma PDOException é lançada se a tentativa
de conexão ao banco de dados requisitado falhar,
independente de qual PDO::ATTR_ERRMODE
estiver definido.