(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::__construct — Cria uma instância PDO representando uma conexão a um banco de dados
$dsn,$username = null,$password = null,$options = nullCria uma instância PDO para representar uma conexão ao banco de dados requisitado.
dsnO 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
usernameO nome de usuário para a string DSN. Este parâmetro é opcional para alguns drivers PDO.
passwordA senha para a srting DSN. Este parâmetro é opcional para alguns drivers PDO.
optionsUm array de chave=>valor de opções de conexão específicas do driver.
Uma PDOException é lançada se a tentativa
de conexão ao banco de dados requisitado falhar,
independente de qual PDO::ATTR_ERRMODE estiver definido.
Exemplo #1 Cria uma instância PDO através de invocação de driver
<?php
$dsn = 'mysql:dbname=testdb;host=127.0.0.1';
$user = 'dbuser';
$password = 'dbpass';
$dbh = new PDO($dsn, $user, $password);
?>Exemplo #2 Cria uma instância PDO através de invocação de URI
O exemplo a seguir assume que o arquivo /usr/local/dbconnect existe com permissões de leitura pelo PHP. O arquivo contém o DSN PDO para conexão a um banco de dados DB2 através do driver PDO_ODBC:
odbc:DSN=SAMPLE;UID=john;PWD=mypass
O script PHP pode então criar uma conexão ao banco de dados simplesmente
passando o parâmetro uri: e apontando para
a URI do arquivo:
<?php
$dsn = 'uri:file:///usr/local/dbconnect';
$user = '';
$password = '';
$dbh = new PDO($dsn, $user, $password);
?>Exemplo #3 Cria uma instância PDO usando um apelido
O exemplo a seguir assume que o php.ini contém a seguinte
entrada para habilitar uma conexão ao banco de dados MySQL usando somente o
apelido mydb:
[PDO] pdo.dsn.mydb="mysql:dbname=testdb;host=localhost"
<?php
$dsn = 'mydb';
$user = '';
$password = '';
$dbh = new PDO($dsn, $user, $password);
?>