PDO::setAttribute

Ladda ned PHP-drivrutin

Sätter ett fördefinierat PDO-attribut eller ett eget drivrutinsattribut.

Syntax

bool PDO::setAttribute ( $attribute, $value );

Parameters

$attribute: Attributet för att sätta in. Se avsnittet Anmärkningar för en lista över stödda attribut.

$value: Värdet (typblandat).

Returvärde

Ger sant vid framgång, annars falskt.

Remarks

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

PDO::CASE_NATURAL

PDO::CASE_UPPER		 Specificerar fallet med kolumnnamn.

PDO::CASE_LOWER orsakar gemener.

PDO::CASE_NATURAL (standard) visar kolumnnamn som returneras av databasen.

PDO::CASE_UPPER orsakar kolumnnamn till versaler.

Detta attribut kan sättas med PDO::setAttribute.
PDO::ATTR_DEFAULT_FETCH_MODE PDO Se PDO-dokumentationen. Se PDO-dokumentationen.
PDO::ATTR_DEFAULT_STR_PARAM PDO PDO::P ARAM_STR_CHAR

PDO::P ARAM_STR_NATL		 För mer information, se exemplen i PDO::citat.
PDO::ATTR_ERRMODE PDO PDO::ERRMODE_SILENT

PDO::ERRMODE_WARNING

PDO::ERRMODE_EXCEPTION		 Specificerar hur föraren rapporterar fel.

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

PDO::ERRMODE_WARNING höjer E_WARNING.

PDO::ERRMODE_EXCEPTION orsakar att ett undantag kastas.

Detta attribut kan sättas med PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS PDO Se PDO-dokumentationen. Specificerar hur nullpunkter ska returneras.

PDO::NULL_NATURAL gör ingen konvertering.

PDO::NULL_EMPTY_STRING omvandlar en tom sträng till null.

PDO::NULL_TO_STRING konverterar null till en tom sträng.
PDO::ATTR_STATEMENT_CLASS PDO Se PDO-dokumentationen. Sätter den användartillhandahållna satsklassen härledd från PDOStatement.

Kräver array(string classname, array(mixed constructor_args)).

För mer information, se PDO-dokumentationen.
PDO::ATTR_STRINGIFY_FETCHES PDO sant eller falskt Omvandlar numeriska värden till strängar vid dataåtkomst.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE Microsoft-drivrutiner för PHP för SQL Server 1 till PHP-minnesgränsen. Sätter storleken på bufferten som håller resultatuppsättningen när man använder en markör på klientsidan.

Standardvärdet är 10240 KB, om det inte anges i php.ini-filen.

Noll och negativa tal är inte tillåtna.

För mer information om frågor som skapar en kursorör på klientsidan, se Cursor Types (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_DECIMAL_PLACES Microsoft-drivrutiner för PHP för SQL Server Heltal mellan 0 och 4 (inklusive) Specificerar antalet decimaler vid formatering av hämtade penningvärden.

Eventuella negativa heltal eller värden över 4 ignoreras.

Detta alternativ fungerar bara när PDO::SQLSRV_ATTR_FORMAT_DECIMALS är sant.

Detta alternativ kan också ställas in på uttalandenivå. Om så är fallet så åsidosätter uttalandenivåalternativet detta.

För mer information, se Formatering av decimalsträngar och penningvärden (PDO_SQLSRV drivrutin).
PDO::SQLSRV_ATTR_DIRECT_QUERY Microsoft-drivrutiner för PHP för SQL Server sant eller falskt 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.		 Sätter teckenuppsättningskodningen som drivrutinen använder för att kommunicera med servern.

PDO::SQLSRV_ENCODING_BINARY stöds inte.

Standardinställningen är PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE Microsoft-drivrutiner för PHP för SQL Server sant eller falskt Specificerar om datum- och tidstyper ska hämtas som PHP DateTime-objekt . Om de lämnas falska är standardbeteendet att returnera dem som strängar.

Detta alternativ kan också ställas in på uttalandenivå. Om så är fallet så åsidosätter uttalandenivåalternativet detta.

Mer information finns i How to: Retrieve Date and Time Types as PHP DateTime Objects Using the PDO_SQLSRV Driver (Hämta datum- och tidstyper som PHP DateTime-objekt med hjälp av drivrutinen för PDO_SQLSRV).
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å, är returvärdet en sträng även när SQLSRV_ATTR_FETCHES_NUMERIC_TYPE är på.

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_FORMAT_DECIMALS Microsoft-drivrutiner för PHP för SQL Server sant eller falskt Specificerar om ledande nollor ska läggas till decimalsträngar när det är lämpligt. Om det är inställt aktiverar detta alternativ PDO::SQLSRV_ATTR_DECIMAL_PLACES för att formatera penningtyper. Om det lämnas falskt används standardbeteendet att returnera exakt precision och utelämna inledande nolla för värden som är mindre än 1.

Detta alternativ kan också ställas in på uttalandenivå. Om så är fallet så åsidosätter uttalandenivåalternativet detta.

För mer information, se Formatering av decimalsträngar och penningvärden (PDO_SQLSRV drivrutin).
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 och kräver att drivrutinen bearbetar andra. Alla anpassade attribut och anslutningsalternativ hanteras av drivrutinen. Ett icke-stödd attribut, anslutningsalternativ eller icke-stödd värde rapporteras enligt inställningen PDO::ATTR_ERRMODE.

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 hur man sätter attributet PDO:::ATTR_ERRMODE.

<?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" ) ));  
   }  
?>

Relaterat innehåll

  • Last updated on