PDO::__construct

Descarregar o driver PHP

Cria uma ligação a uma base de dados do SQL Server.

Syntax

  
PDO::__construct($dsn [,$username [,$password [,$driver_options ]]] )  

Parâmetros

$dsn: Uma cadeia que contém o nome do prefixo (sempre sqlsrv), um dois-pontos e a palavra-chave Servidor. Por exemplo, "sqlsrv:server=(local)". Pode, opcionalmente, especificar outras palavras-chave de ligação. Consulte Opções de Ligação para uma descrição da palavra-chave do Servidor e das outras palavras-chave de ligação. A $dsn inteira está entre aspas, por isso cada palavra-chave de ligação não deve ser citada individualmente.

$username: Opcional. Uma cadeia que contém o nome do utilizador. Para se ligar usando o SQL Server Authentication, especifique o ID de login. Para se ligar usando a Autenticação Windows, especifique "".

$password: Opcional. Uma cadeia que contém a palavra-passe do utilizador. Para se ligar usando o SQL Server Authentication, especifique a palavra-passe. Para se ligar usando a Autenticação Windows, especifique "".

$driver_options: Opcional. Pode especificar atributos PDO Driver Manager, e Microsoft Drivers para PHP para SQL Server atributos específicos do driver — PDO::SQLSRV_ATTR_ENCODING, PDO::SQLSRV_ATTR_DIRECT_QUERY. Um atributo inválido não gera uma exceção. Atributos inválidos geram exceções quando especificados com PDO::setAttribute.

Valor de retorno

Devolve um objeto PDO. Se falhar, devolve um objeto PDOException.

Exceções

PDOException

Observações

Podes fechar um objeto de ligação definindo a instância como nula.

Após a ligação, PDO::errorCode apresenta 01000 em vez de 00000.

Se o PDO::__construct falhar por qualquer motivo, é lançada uma exceção, mesmo que o PDO::ATTR_ERRMODE esteja definido para PDO::ERRMODE_SILENT.

O suporte para PDO foi adicionado na versão 2.0 dos Microsoft Drivers for PHP para SQL Server.

Exemplo com base de dados

Este exemplo mostra como se ligar a um servidor usando a Autenticação Windows e especificar uma base 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 base de dados

Este exemplo mostra como se ligar a um servidor, especificando a base de dados mais tarde.

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

Conteúdo relacionado

• Classe PDO
• PDO