PDO::getAttribute

Ladda ned PHP-drivrutin

Hämtar värdet på en fördefinierad PDO eller drivrutinsattribut.

Syntax

  
mixed PDO::getAttribute ( $attribute )

Parameters

$attribute: En av de stödda attributen. Se avsnittet Kommentarer för listan över stödda attribut.

Returvärde

Vid framgång returnerar värdet av ett anslutningsalternativ, ett fördefinierat PDO-attribut eller ett eget drivrutinsattribut. Vid misslyckande returneras null.

Remarks

Följande tabell innehåller listan över stödda attribut.

Attribute Bearbetat av Värden som stöds Description
PDO::ATTR_CASE PDO PDO::CASE_LOWER

PDO::CASE_NATURAL

PDO::CASE_UPPER		 Specificerar om kolumnnamnen ska vara i ett specifikt fall. PDO::CASE_LOWER tvingar fram gemener, PDO::CASE_NATURAL lämnar kolumnnamnet som det returneras av databasen, och PDO::CASE_UPPER tvingar kolumnnamn till versaler.

Standardinställningen är PDO::CASE_NATURAL.

Detta attribut kan också sättas med PDO::setAttribute.
PDO::ATTR_CLIENT_VERSION Microsoft-drivrutiner för PHP för SQL Server Matris med strängar Beskriver versionerna av drivrutinen och relaterade bibliotek. Returnerar en array med följande element: ODBC-versionen (MajorVer.MinorVer), SQL Server Native Client DLL-namn och version, Microsoft Drivers for PHP för SQL Server-versionen (MajorVer.MinorVer.BuildNumber. Revision)
PDO::ATTR_DEFAULT_STR_PARAM PDO PDO::P ARAM_STR_CHAR

PDO::P ARAM_STR_NATL		 Om den inte är inställd på PDO::P ARAM_STR_CHAR, RETURNERAS PDO::P ARAM_STR_NATL.
PDO::ATTR_DRIVER_NAME PDO String Returnerar alltid "sqlsrv".
PDO::ATTR_DRIVER_VERSION Microsoft-drivrutiner för PHP för SQL Server String Anger Microsoft-drivrutinerna för PHP för SQL Server-versionen (MajorVer.MinorVer.BuildNumber. Revision)
PDO::ATTR_ERRMODE PDO PDO::ERRMODE_SILENT

PDO::ERRMODE_WARNING

PDO::ERRMODE_EXCEPTION		 Specificerar hur fel ska hanteras av drivrutinen.

PDO::ERRMODE_SILENT (standarden) sätter felkoder och information.

PDO::ERRMODE_WARNING höjer en E_WARNING.

PDO::ERRMODE_EXCEPTION gör ett undantag.

Detta attribut kan också sättas med PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS PDO Se PDO-dokumentationen. Se PDO-dokumentationen.
PDO::ATTR_SERVER_INFO Microsoft-drivrutiner för PHP för SQL Server Array av 3 element Returnerar den aktuella databasen, SQL Server-versionen och SQL Server-instansen.
PDO::ATTR_SERVER_VERSION Microsoft-drivrutiner för PHP för SQL Server String Indikerar SQL Server-versionen (Major.Mindre. BuildNumber)
PDO::ATTR_STRINGIFY_FETCHES PDO Se PDO-dokumentation Se PDO-dokumentationen.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE Microsoft-drivrutiner för PHP för SQL Server 1 till PHP-minnesgränsen. Konfigurerar storleken på bufferten som håller resultatuppsättningen för en klient-sida markör.

Standardvärdet är 10 240 KB (10 MB).

För mer information om klientsidans markörer, se Cursor Types (SQLSRV Driver).
PDO::SQLSRV_ATTR_DIRECT_QUERY Microsoft-drivrutiner för PHP för SQL Server true

falsk		 Specificerar direkt eller förberedd frågeexekvering. För mer information, se Direct Statement Execution och Prepared Statement Execution i PDO_SQLSRV Driver.
PDO::SQLSRV_ATTR_ENCODING Microsoft-drivrutiner för PHP för SQL Server PDO::SQLSRV_ENCODING_UTF8

PDO::SQLSRV_ENCODING_SYSTEM		 Specificerar teckenuppsättningskodningen som drivrutinen använder för att kommunicera med servern.

Standardinställningen är PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE Microsoft-drivrutiner för PHP för SQL Server sant eller falskt Hanterar numeriska hämtningar från kolumner med numeriska SQL-typer (bit, heltal, smallint, tinyint, flyttal eller reell).

När anslutningsvalflaggan ATTR_STRINGIFY_FETCHES är på, även när SQLSRV_ATTR_FETCHES_NUMERIC_TYPE är på, är returvärdet en sträng.

När den returnerade PDO-typen i bind-kolumnen är PDO_PARAM_INT, är returvärdet från en heltalskolumn en int även om SQLSRV_ATTR_FETCHES_NUMERIC_TYPE är fel.
PDO::SQLSRV_ATTR_QUERY_TIMEOUT Microsoft-drivrutiner för PHP för SQL Server integer Sätter frågetimeout på sekunder.

Standardvärdet är 0, vilket betyder att drivrutinen väntar obegränsat på resultat.

Negativa tal tillåts inte.

PDO bearbetar några av de fördefinierade attributen medan drivrutinen måste hantera andra. Alla anpassade attribut och anslutningsalternativ hanteras av drivrutinen, ett icke-stödd attribut eller anslutningsalternativ ger null.

Stöd för PDO lades till i version 2.0 av Microsoft Drivers för PHP för SQL Server.

Example

Detta exempel visar värdet på PDO::ATTR_ERRMODE-attributet, före och efter att dess värde ändrats.

<?php  
$database = "AdventureWorks";  
$conn = new PDO( "sqlsrv:server=(local) ; Database = $database", "", "");  
  
$attributes1 = array( "ERRMODE" );  
foreach ( $attributes1 as $val ) {  
     echo "PDO::ATTR_$val: ";  
     var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));  
}  
  
$conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );  
  
$attributes1 = array( "ERRMODE" );  
foreach ( $attributes1 as $val ) {  
     echo "PDO::ATTR_$val: ";  
     var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));  
}  
  
// An example using PDO::ATTR_CLIENT_VERSION  
print_r($conn->getAttribute( PDO::ATTR_CLIENT_VERSION ));  
?>

Relaterat innehåll

  • Last updated on