array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdo.connect.php', 1 => 'PDO::connect', 2 => 'Conecta a um banco de dados e retorna uma subclasse PDO para drivers que o suportam', ), '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' => 'pt_BR', '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 um banco de dados e retorna uma subclasse PDO para drivers que o suportam

Descrição

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

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.

Parâmetros

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:

Invocação do driver

dsn contém o DSN completo.

Invocação de URI

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

Criação de apelido

dsn consiste em um nome (name) que é mapeado para pdo.dsn.name no php.ini definindo a string DSN.

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.

Valor Retornado

Retorna uma instância de uma subclasse PDO para o driver PDO correspondente se existir, ou uma instância genérica de PDO.

Erros/Exceções

Uma PDOException é lançada se a tentativa de conexão ao banco de dados requisitado falhar, independente de qual PDO::ATTR_ERRMODE estiver definido.

Veja Também