(PHP 8 >= 8.4.0)
PDO::connect — Conecta a um banco de dados e retorna uma subclasse PDO para drivers que o suportam
$dsn
,$username
= null
,$password
= null
,$options
= null
Cria uma instância de uma subclasse PDO para o banco de dados sendo conectado, se existir, caso contrário retorna uma instância genérica de PDO.
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.
Retorna uma instância de uma subclasse PDO para o driver PDO correspondente se existir, ou uma instância genérica de PDO.
Uma PDOException é lançada se a tentativa
de conexão ao banco de dados requisitado falhar,
independente de qual PDO::ATTR_ERRMODE
estiver definido.