PDO::__construct
Cria uma conexão com um banco de dados do SQL Server.
Sintaxe
PDO::__construct($dsn [,$username [,$password [,$driver_options ]]] )
Parâmetros
$dsn: uma cadeia de caracteres que contém o nome do prefixo (sempre sqlsrv), dois-pontos e a palavra-chave do servidor. Por exemplo, "sqlsrv:server=(local)". Opcionalmente, você pode especificar outras palavras-chave de conexão. Consulte Connection Options para obter uma descrição da palavra-chave do servidor e das outras palavras-chave de conexão. O $dsn inteiro é incluído entre aspas; portanto, não se deve incluir cada palavra-chave de conexão entre aspas individualmente.
$username: Opcional. Uma cadeia de caracteres que contém o nome do usuário. Para conectar usando a Autenticação do SQL Server, especifique a ID de logon. Para conectar usando a Autenticação do Windows, especifique "".
$password: opcional. Uma cadeia de caracteres que contém a senha do usuário. Para conectar usando a Autenticação do SQL Server, especifique a senha. Para conectar usando a Autenticação do Windows, especifique "".
$driver_options: Opcional. Você pode especificar atributos do Gerenciador de Driver do PDO e atributos específicos do driver dos Drivers da Microsoft para PHP para SQL Server – PDO::SQLSRV_ATTR_ENCODING, PDO::SQLSRV_ATTR_DIRECT_QUERY. Um atributo inválido não gerará uma exceção. Atributos inválidos geram exceções quando são especificados com PDO::setAttribute.
Valor de retorno
Retorna um objeto PDO. Se ocorrer uma falha, retornará um objeto PDOException.
Exceções
PDOException
Comentários
Você pode fechar um objeto de conexão definindo a instância como null.
Após uma conexão, PDO::errorCode exibe 01000 em vez de 00000.
Se PDO::__construct falhar por algum motivo, uma exceção será gerada, mesmo se PDO::ATTR_ERRMODE for definido como PDO::ERRMODE_SILENT.
O suporte para PDO foi adicionado na versão 2.0 dos Drivers da Microsoft para PHP para SQL Server.
Exemplo com banco de dados
Este exemplo mostra como se conectar a um servidor usando a Autenticação do Windows e especificar um banco de dados.
<?php
$c = new PDO( "sqlsrv:Server=(local) ; Database = AdventureWorks ", "", "", array(PDO::SQLSRV_ATTR_DIRECT_QUERY => true));
$query = 'SELECT * FROM Person.ContactType';
$stmt = $c->query( $query );
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ) {
print_r( $row );
}
$c = null;
?>
Exemplo sem banco de dados
Este exemplo mostra como se conectar a um servidor, especificando o banco de dados posteriormente.
<?php
$c = new PDO( "sqlsrv:server=(local)");
$c->exec( "USE AdventureWorks2022" );
$query = 'SELECT * FROM Person.ContactType';
$stmt = $c->query( $query );
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ){
print_r( $row );
}
$c = null;
?>