PDO::setAttribute
Sets a predefined PDO attribute or a custom driver attribute.
Syntax
bool PDO::setAttribute ( $attribute, $value );
Parameters
$attribute: The attribute to set. See the Remarks section for a list of supported attributes.
$value: The value (type mixed).
Return Value
Returns true on success, otherwise false.
Remarks
Attribute | Processed by | Supported values | Description |
---|---|---|---|
PDO::ATTR_CASE | PDO | PDO::CASE_LOWER |
PDO::CASE_LOWER causes lower case column names.
PDO::CASE_NATURAL (the default) displays column names as returned by the database.
PDO::CASE_UPPER causes column names to upper case.
PDO::ERRMODE_SILENT (the default) sets the error codes and information.
PDO::ERRMODE_WARNING raises E_WARNING.
PDO::ERRMODE_EXCEPTION causes an exception to be thrown.
PDO::NULL_NATURAL does no conversion.
PDO::NULL_EMPTY_STRING converts an empty string to null.
Requires array(string classname, array(mixed constructor_args)) .
The default is 10240 KB, if not specified in the php.ini file.
Zero and negative numbers are not allowed.
Any negative integer or value more than 4 will be ignored.
This option works only when PDO::SQLSRV_ATTR_FORMAT_DECIMALS is true.
This option may also be set at the statement level. If so, then the statement level option overrides this one.
PDO::SQLSRV_ENCODING_BINARY is not supported.
This option may also be set at the statement level. If so, then the statement level option overrides this one.
When connection option flag ATTR_STRINGIFY_FETCHES is on, the return value is a string even when SQLSRV_ATTR_FETCHES_NUMERIC_TYPE is on.
This option may also be set at the statement level. If so, then the statement level option overrides this one.
The default is 0, which means the driver will wait indefinitely for results.
PDO processes some of the predefined attributes and requires the driver to process others. All custom attributes and connection options are processed by the driver. An unsupported attribute, connection option, or unsupported value is reported according to the setting of PDO::ATTR_ERRMODE.
Support for PDO was added in version 2.0 of the Microsoft Drivers for PHP for SQL Server.
Example
This sample shows how to set the PDO::ATTR_ERRMODE attribute.
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" ) )); > ?>
DOMElement::setAttribute
Sets an attribute with name qualifiedName to the given value. If the attribute does not exist, it will be created.
Parameters
The name of the attribute.
The value of the attribute.
Return Values
The created or modified DOMAttr or false if an error occurred.
Errors/Exceptions
DOM_NO_MODIFICATION_ALLOWED_ERR
Raised if the node is readonly.
Examples
Example #1 Setting an attribute
$doc = new DOMDocument ( «1.0» );
$node = $doc -> createElement ( «para» );
$newnode = $doc -> appendChild ( $node );
$newnode -> setAttribute ( «align» , «left» );
?>?php
See Also
- DOMElement::hasAttribute() — Checks to see if attribute exists
- DOMElement::getAttribute() — Returns value of attribute
- DOMElement::removeAttribute() — Removes attribute
User Contributed Notes 6 notes
$dom = new DOMDocument ();
$dom -> loadHTML ( $html );
//Evaluate Anchor tag in HTML
$xpath = new DOMXPath ( $dom );
$hrefs = $xpath -> evaluate ( «/html/body//a» );
for ( $i = 0 ; $i < $hrefs ->length ; $i ++) $href = $hrefs -> item ( $i );
$url = $href -> getAttribute ( ‘href’ );
//remove and set target attribute
$href -> removeAttribute ( ‘target’ );
$href -> setAttribute ( «target» , «_blank» );
//remove and set href attribute
$href -> removeAttribute ( ‘href’ );
$href -> setAttribute ( «href» , $newURL );
>
// save html
$html = $dom -> saveHTML ();
Solution to render HTML 5 tags with attributes with/without value:
$dom = new DOMImplementation ();
$doc = $dom -> createDocument ( null , ‘html’ , $dom -> createDocumentType ( ‘html’ ));
$tag = $doc -> appendChild ( $doc -> createElement ( ‘input’ ));
$tag -> setAttribute ( ‘type’ , ‘text’ );
$tag -> setAttribute ( ‘disabled’ , » );
$doc -> normalize (); // normalize attributes
echo $doc -> saveHTML ( $tag ); //
?>
The use of Dom to first remove and then add the width and height to the first img tag from the text.I hope it help you to save your time
$html = ‘
http://www.example.com/images/header.jpg» width=»898″ height=»223″ style=»border-bottom:5px solid #cccccc;»/>
http://www.example.com/images/header2.jpg» width=»898″ height=»223″ style=»border-bottom:5px solid #cccccc;»/>
‘ ;
$doc = DOMDocument :: loadHTML ( $html );
$c = 0 ;
foreach( $doc -> getElementsByTagName ( ‘img’ ) as $image ) if ( $c > 0 ) continue;
foreach(array( ‘width’ , ‘height’ ) as $attribute_to_remove ) echo $attribute_to_remove ;
if( $image -> hasAttribute ( $attribute_to_remove )) $image -> removeAttribute ( $attribute_to_remove );
>
if( $attribute_to_remove == ‘height’ ) if(! $image -> hasAttribute ( $attribute_to_remove )) $image -> setAttribute ( $attribute_to_remove , ‘220’ );
>>
if( $attribute_to_remove == ‘width’ ) if(! $image -> hasAttribute ( $attribute_to_remove )) $image -> setAttribute ( $attribute_to_remove , ‘700’ );
If wanting to set an attribute of an element with unique id of «1»
$dom = new DomDocument ();
$dom -> load ( ‘test.xml’ );
$xp = new DomXPath ( $dom );
$res = $xp -> query ( «//*[@id = ‘1’]» );
$res -> item ( 0 )-> setAttribute ( ‘title’ , ‘2’ );
$dom -> save ( ‘test.xml’ );
?>
PDO::setAttribute
Устанавливает атрибут объекту PDO. Некоторые основные атрибуты приведены ниже; отдельные драйверы могут использовать собственные дополнительные атрибуты. Обратите внимание, что атрибуты драйвера не должны использоваться с другими драйверами. PDO::ATTR_CASE
Принудительное приведение имён столбцов к определённому регистру. Может принимать одно из следующих значений:
PDO::CASE_LOWER Принудительное приведение имён столбцов к нижнему регистру. PDO::CASE_NATURAL Оставить имена столбцов в том виде, в котором их возвращает драйвер базы данных. PDO::CASE_UPPER Принудительное приведение имён столбцов к верхнему регистру. PDO::ATTR_ERRMODE
Режим сообщения об ошибках PDO. Может принимать одно из следующих значений:
PDO::ERRMODE_SILENT Устанавливает только коды ошибок. PDO::ERRMODE_WARNING Вызывает диагностику ошибок уровня E_WARNING . PDO::ERRMODE_EXCEPTION Выбрасывает PDOException . PDO::ATTR_ORACLE_NULLS
Замечание: Атрибут доступен для всех драйверов, а не только для Oracle.
Определяет, следует ли и как преобразовывать null и пустые строки. Может принимать одно из следующих значений:
PDO::NULL_NATURAL Никакого преобразования не происходит. PDO::NULL_EMPTY_STRING Пустые строки преобразуются в null . PDO::NULL_TO_STRING null преобразуется в пустую строку. PDO::ATTR_STRINGIFY_FETCHES
Следует ли преобразовывать числовые значения в строки при выборке. Принимает логическое значение ( bool ): true для включения и false для выключения.
PDO::ATTR_STATEMENT_CLASS
Установка пользовательского класса оператора, производного от PDOStatement. Требуется array(string classname, array(mixed constructor_args)) .
Не может использоваться с постоянными экземплярами PDO.
Указывает продолжительность времени ожидания в секундах. Принимает значение в виде целого числа ( int ).
Замечание:
Не все драйверы поддерживают этот параметр и его значение может отличаться от драйвера к драйверу. Например, SQLite будет ждать до этого значения времени, прежде чем отказаться от получения блокировки на запись, но другие драйверы могут интерпретировать это как интервал ожидания соединения или чтения.
Замечание: Доступно только для драйверов OCI, Firebird и MySQL.
Следует ли автоматически фиксировать каждый отдельный оператор. Принимает логическое значение ( bool ): true для включения и false для отключения. По умолчанию true .
PDO::ATTR_EMULATE_PREPARES
Замечание: Доступно только для драйверов OCI, Firebird и MySQL.
Включить или отключить эмуляцию подготовленных запросов. Некоторые драйверы не поддерживают подготовленные запросы нативно или имеют ограниченную поддержку. Если установлено значение true PDO всегда будет эмулировать подготовленные запросы, в противном случае PDO будет пытаться использовать встроенные подготовленные запросы. Если драйвер не сможет успешно подготовить текущий запрос, PDO всегда будет возвращаться к эмуляции подготовленного запроса.
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY
Замечание: Доступно только для драйвера MySQL.
Определяет, использовать ли буферизованные запросы. Принимает логическое значение ( bool ): true для включения и false для отключения. По умолчанию true .
PDO::ATTR_DEFAULT_FETCH_MODE
Устанавливает режим выборки по умолчанию. Описание режимов и их использования доступно в документации PDOStatement::fetch() .
Список параметров
Значение для установки параметра attribute , может потребовать определённого типа в зависимости от атрибута.
Возвращаемые значения
Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.
Смотрите также
- PDO::getAttribute() — Получить атрибут соединения с базой данных
- PDOStatement::getAttribute() — Получение значения атрибута запроса PDOStatement
- PDOStatement::setAttribute() — Устанавливает атрибут объекту PDOStatement
User Contributed Notes 12 notes
Because no examples are provided, and to alleviate any confusion as a result, the setAttribute() method is invoked like so:
So, if I wanted to ensure that the column names returned from a query were returned in the case the database driver returned them (rather than having them returned in all upper case [as is the default on some of the PDO extensions]), I would do the following:
// Create a new database connection.
$dbConnection = new PDO ( $dsn , $user , $pass );
// Set the case in which to return column_names.
$dbConnection -> setAttribute ( PDO :: ATTR_CASE , PDO :: CASE_NATURAL );
?>
Hope this helps some of you who learn by example (as is the case with me).
This is an update to a note I wrote earlier concerning how to set multiple attributes when you create you PDO connection string.
You can put all the attributes you want in an associative array and pass that array as the fourth parameter in your connection string. So it goes like this:
$options = [
PDO :: ATTR_ERRMODE => PDO :: ERRMODE_EXCEPTION ,
PDO :: ATTR_CASE => PDO :: CASE_NATURAL ,
PDO :: ATTR_ORACLE_NULLS => PDO :: NULL_EMPTY_STRING
];
// Now you create your connection string
try // Then pass the options as the last parameter in the connection string
$connection = new PDO ( «mysql:host= $host ; dbname= $dbname » , $user , $password , $options );
// That’s how you can set multiple attributes
> catch( PDOException $e ) die( «Database connection failed: » . $e -> getMessage ());
>
?>
Well, I have not seen it mentioned anywhere and thought its worth mentioning. It might help someone. If you are wondering whether you can set multiple attributes then the answer is yes.
You can do it like this:
try $connection = new PDO(«mysql:host=$host; dbname=$dbname», $user, $password);
// You can begin setting all the attributes you want.
$connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$connection->setAttribute(PDO::ATTR_CASE, PDO::CASE_NATURAL);
$connection->setAttribute(PDO::ATTR_ORACLE_NULLS, PDO::NULL_EMPTY_STRING);
// That’s how you can set multiple attributes
>
catch(PDOException $e)
die(«Database connection failed: » . $e->getMessage());
>
I hope this helps somebody. 🙂
Note that contrary to most PDO methods, setAttribute does not throw a PDOException when it returns false.
It is worth noting that not all attributes may be settable via setAttribute(). For example, PDO::MYSQL_ATTR_MAX_BUFFER_SIZE is only settable in PDO::__construct(). You must pass PDO::MYSQL_ATTR_MAX_BUFFER_SIZE as part of the optional 4th parameter to the constructor. This is detailed in http://bugs.php.net/bug.php?id=38015
For PDO::ATTR_EMULATE_PREPARES, the manual states a boolean value is required. However, when getAttribute() is used to check this value, an integer (1 or 0) is returned rather than true or false.
This means that if you are checking a PDO object is configured as required then
// Check emulate prepares is off
if ( $pdo -> getAttribute (\ PDO :: ATTR_EMULATE_PREPARES ) !== false ) /* do something */
>
?>
will always ‘do something’, regardless.
// Check emulate prepares is off
if ( $pdo -> getAttribute (\ PDO :: ATTR_EMULATE_PREPARES ) != false ) /* do something */
>
?>
or
// Check emulate prepares is off
if ( $pdo -> getAttribute (\ PDO :: ATTR_EMULATE_PREPARES ) !== 0 ) /* do something */
>
?>
is needed instead.
Also worth noting that setAttribute() does, in fact, accept an integer value if you want to be consistent.
There is also a way to specifie the default fetch mode :
$connection = new PDO ( $connection_string );
$connection -> setAttribute ( PDO :: ATTR_DEFAULT_FETCH_MODE , PDO :: FETCH_OBJ );
?>