PDO::__construct

Pobierz sterownik PHP

Tworzy połączenie z bazą danych SQL Server.

Syntax

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

Parametry

$dsn: Ciąg znaków zawierający nazwę prefiksu (zawsze sqlsrv), dwukropek oraz słowo kluczowe Serwer. Na przykład "sqlsrv:server=(local)". Możesz opcjonalnie określić inne słowa kluczowe łączące. Zobacz Opcje połączenia , aby zobaczyć opis słowa kluczowego serwera oraz innych słów kluczowych połączenia. Cały $dsn jest w cudzysłowie, więc każde słowo kluczowe połączenia nie powinno być cytowane indywidualnie.

$username: Opcjonalnie. Ciąg zawierający imię użytkownika. Aby połączyć się za pomocą uwierzytelniania SQL Server, podaj identyfikator logowania. Aby połączyć się za pomocą uwierzytelniania Windows, określ "".

$password: Opcjonalnie. Ciąg zawierający hasło użytkownika. Aby połączyć się za pomocą uwierzytelniania SQL Server, podaj hasło. Aby połączyć się za pomocą uwierzytelniania Windows, określ "".

$driver_options: Opcjonalnie. Możesz określić atrybuty Driver Manager PDO oraz Microsoft sterowniki dla PHP dla SQL Server konkretnych atrybutów sterowników — PDO::SQLSRV_ATTR_ENCODING, PDO::SQLSRV_ATTR_DIRECT_QUERY. Gdy PDO::ATTR_ERRMODE jest , PDO::ERRMODE_EXCEPTIONdomyślnie, nieprawidłowy atrybut lub wartość atrybutu powoduje, że konstruktor rzuca a PDOException z SQLSTATE IMSSP. PDO::setAttribute weryfikuje atrybuty w ten sam sposób.

Ustaw PDO::SQLSRV_ATTR_DEFAULT_STR_LENGTH w, $driver_options aby określić początkową adaptacyjną długość dla kwalifikujących się ciągów wejściowych w nowych instrukcjach. Domyślnie 0 jest (wyłączone); akceptowane wartości to liczby całkowite od 0 do 8 000. Nieprawidłowa wartość raportuje SQLSTATE IMSSP. Przykłady i ograniczenia znajdziesz w sekcji Deklarowanie typów i długości ciągów wejściowych (PDO_SQLSRV).

Wartość zwracana

Zwraca obiekt PDO. Jeśli się nie uda, zwraca obiekt PDOException.

Wyjątki

PDOException

Remarks

Możesz zamknąć obiekt połączenia, ustawiając instancję na null.

Po połączeniu PDO::errorCode wyświetla 01000 zamiast 00000.

Jeśli PDO::__construct nie zadziała z jakiegokolwiek powodu, wyrzucany jest wyjątek, nawet jeśli PDO::ATTR_ERRMODE jest ustawione na PDO::ERRMODE_SILENT.

Wsparcie dla PDO zostało dodane w wersji 2.0 sterowników Microsoft dla PHP dla SQL Server.

Przykład z bazą danych

Ten przykład pokazuje, jak połączyć się z serwerem za pomocą uwierzytelniania Windows i określić bazę danych.

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

Przykład bez bazy danych

Ten przykład pokazuje, jak połączyć się z serwerem, a następnie określić bazę danych.

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