PDO::__construct

Baixar o driver PHP

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;  
?>  

Consulte Também

PDO Class

PDO