PDO::setAttribute

Stáhnout ovladač PHP

Nastavuje předdefinovaný atribut PDO nebo vlastní atribut ovladače.

Syntax

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

Parametry

$attribute: Atribut nastavit. Viz sekce Poznámky pro seznam podporovaných atributů.

$value: Hodnota (typ smíšený).

Návratová hodnota

Při úspěchu se vrací pravdivé, jinak nepravdivé.

Remarks

Vlastnost	Zpracoval/a	Podporované hodnoty	Description
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	Specifikuje případ názvů sloupců. PDO::CASE_LOWER způsobuje názvy sloupců malými písmeny. PDO::CASE_NATURAL (výchozí) zobrazuje názvy sloupců vrácené databází. PDO::CASE_UPPER způsobuje, že názvy sloupců jsou velkými písmeny. Tento atribut lze nastavit pomocí PDO::setAttribute.
PDO::ATTR_DEFAULT_FETCH_MODE	PDO	Podívejte se na dokumentaci k PDO.	Podívejte se na dokumentaci k PDO.
PDO::ATTR_DEFAULT_STR_PARAM	PDO	PDO::P ARAM_STR_CHAR PDO::P ARAM_STR_NATL	Pro více informací viz příklady v PDO::quote.
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	Specifikuje, jak ovladač hlásí selhání. PDO::ERRMODE_SILENT (výchozí) nastavuje chybové kódy a informace. PDO::ERRMODE_WARNING zvyšuje E_WARNING. PDO::ERRMODE_EXCEPTION způsobí vyhození výjimky. Tento atribut lze nastavit pomocí PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS	PDO	Podívejte se na dokumentaci k PDO.	Specifikuje, jak by měly být vráceny nullové hodnoty. PDO::NULL_NATURAL neprovádí žádnou konverzi. PDO::NULL_EMPTY_STRING převádí prázdný řetězec na null. PDO::NULL_TO_STRING převádí null na prázdný řetězec.
PDO::ATTR_STATEMENT_CLASS	PDO	Podívejte se na dokumentaci k PDO.	Nastavuje uživatelsky dodanou třídu příkazů odvozenou z PDOStatement. Vyžaduje array(string classname, array(mixed constructor_args)). Pro více informací viz dokumentaci o PDO.
PDO::ATTR_STRINGIFY_FETCHES	PDO	pravda nebo lež	Při načítání dat převádí číselné hodnoty na řetězce.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	Ovladače Microsoftu pro PHP pro SQL Server	1 na limit paměti PHP.	Nastavuje velikost bufferu, který uchovává výslednou množinu při použití kurzoru na straně klienta. Výchozí hodnota je 10240 KB, pokud není uvedena v souboru php.ini. Nulová a záporná čísla nejsou povolena. Pro více informací o dotazech, které vytvářejí kurzor na straně klienta, viz Typy kurzorů (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_DECIMAL_PLACES	Ovladače Microsoftu pro PHP pro SQL Server	Celé číslo mezi 0 a 4 (včetně)	Specifikuje počet desetinných míst při formátování načítaných peněžních hodnot. Jakékoli záporné celé číslo nebo hodnota větší než 4 budou ignorovány. Tato možnost funguje pouze tehdy, když platí PDO::SQLSRV_ATTR_FORMAT_DECIMALS. Tato možnost může být také nastavena na úrovni výpisu. Pokud ano, pak možnost úrovně příkazu tuto možnost přepisuje. Pro více informací viz Formátování desetinných řetězců a peněžních hodnot (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_DIRECT_QUERY	Ovladače Microsoftu pro PHP pro SQL Server	pravda nebo lež	Specifikuje přímé nebo připravené provádění dotazů. Pro více informací viz Přímé provedení příkazu a Provedení připraveného příkazu v ovladači PDO_SQLSRV.
PDO::SQLSRV_ATTR_ENCODING	Ovladače Microsoftu pro PHP pro SQL Server	PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM.	Nastavuje kódování znakové sady, které ovladač používá ke komunikaci se serverem. PDO::SQLSRV_ENCODING_BINARY není podporován. Výchozí je PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE	Ovladače Microsoftu pro PHP pro SQL Server	pravda nebo lež	Specifikuje, zda má být načtena jako PHP objekty DateTime . Pokud zůstane nepravdivé, výchozím chováním je vrácení jako řetězce. Tato možnost může být také nastavena na úrovni výpisu. Pokud ano, pak možnost úrovně příkazu tuto možnost přepisuje. Další informace naleznete v tématu Postupy: Načtení typů data a času jako objekty PHP DateTime pomocí ovladače PDO_SQLSRV.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE	Ovladače Microsoftu pro PHP pro SQL Server	pravda nebo lež	Zpracovává numerické načítání ze sloupců s numerickými SQL typy (bit, celé, smallint, tinyint, float nebo real). Když je zapnutý příznak možnosti připojení ATTR_STRINGIFY_FETCHES, vrácená hodnota je řetězec i když je SQLSRV_ATTR_FETCHES_NUMERIC_TYPE zapnutý. Když je vrácený typ PDO ve sloupci bind PDO_PARAM_INT, vrácená hodnota z celočíselného sloupce je int, i když je SQLSRV_ATTR_FETCHES_NUMERIC_TYPE nesprávná.
PDO::SQLSRV_ATTR_FORMAT_DECIMALS	Ovladače Microsoftu pro PHP pro SQL Server	pravda nebo lež	Specifikuje, zda je vhodné, přidat vedoucí nuly do desetinných řetězců. Pokud je nastavena, tato možnost umožňuje PDO::SQLSRV_ATTR_DECIMAL_PLACES pro formátování typů peněz. Pokud necháte hodnotu false, použije se výchozí chování vrácení přesné přesnosti a vynechání počátečních nul pro hodnoty menší než 1. Tato možnost může být také nastavena na úrovni výpisu. Pokud ano, pak možnost úrovně příkazu tuto možnost přepisuje. Pro více informací viz Formátování desetinných řetězců a peněžních hodnot (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Ovladače Microsoftu pro PHP pro SQL Server	integer	Nastaví časový limit dotazu na sekundy. Výchozí hodnota je 0, což znamená, že řidič bude čekat na výsledky donekonečna. Záporná čísla nejsou povolená.

PDO zpracovává některé předdefinované atributy a vyžaduje, aby ovladač zpracovával jiné. Všechny vlastní atributy a možnosti připojení zpracovávají ovladač. Nepodporovaný atribut, možnost připojení nebo nepodporovaná hodnota je hlášena podle nastavení PDO::ATTR_ERRMODE.

Podpora PDO byla přidána ve verzi 2.0 Microsoft Drivers for PHP for SQL Server.

Example

Tato ukázka ukazuje, jak nastavit atribut 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" ) ));  
   }  
?>  

Související obsah

• Třída PDO
• PDO