<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 9d792d3c559fb0df638d3d8c649de7e02861cc4d Maintainer: PhilDaiguille Status: ready -->

<!-- Reviewed: no -->

<refentry xml:id="pdo.setattribute" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>PDO::setAttribute</refname>

<refpurpose>

Configura un atributo PDO

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis role="PDO">

<modifier>public</modifier> <type>bool</type><methodname>PDO::setAttribute</methodname>

<methodparam><type>int</type><parameter>attribute</parameter></methodparam>

<methodparam><type>mixed</type><parameter>value</parameter></methodparam>

</methodsynopsis>

<para>

Configura un atributo del gestor de base de datos. Algunos de los

atributos genéricos se listan a continuación; algunos controladores disponen de

configuraciones adicionales.

Cabe señalar que los atributos específicos de un controlador

<emphasis>no deben</emphasis> ser utilizados con otros controladores.

<variablelist>

<varlistentry>

<term><constant>PDO::ATTR_CASE</constant></term>

<listitem>

<para>

Fuerza los nombres de columnas a una casilla particular.

Puede tomar una de las siguientes valores:

</para>

<variablelist>

<varlistentry>

<term><constant>PDO::CASE_LOWER</constant></term>

<listitem>

<simpara>

Fuerza los nombres de columnas en minúsculas.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::CASE_NATURAL</constant></term>

<listitem>

<simpara>

Deja los nombres de columnas tal como son devueltos por el controlador de base de datos.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::CASE_UPPER</constant></term>

<listitem>

<simpara>

Fuerza los nombres de columnas en mayúsculas.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_ERRMODE</constant></term>

<listitem>

<para>

El modo para reportar los errores de PDO.

Puede tomar una de las siguientes valores:

</para>

<variablelist>

<varlistentry>

<term><constant>PDO::ERRMODE_SILENT</constant></term>

<listitem>

<simpara>

Define solo los códigos de error.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ERRMODE_WARNING</constant></term>

<listitem>

<simpara>

Emite diagnósticos <constant>E_WARNING</constant>.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ERRMODE_EXCEPTION</constant></term>

<listitem>

<simpara>

Lanza excepciones <classname>PDOException</classname>.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_ORACLE_NULLS</constant></term>

<listitem>

<note>

<simpara>

Este atributo está disponible con todos los controladores, no solo Oracle.

</simpara>

</note>

<para>

Determina si y cómo &null; y las cadenas vacías deben ser convertidas.

Puede tomar una de las siguientes valores:

</para>

<variablelist>

<varlistentry>

<term><constant>PDO::NULL_NATURAL</constant></term>

<listitem>

<simpara>

No se realiza ninguna conversión.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::NULL_EMPTY_STRING</constant></term>

<listitem>

<simpara>

Las cadenas vacías son convertidas en &null;.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::NULL_TO_STRING</constant></term>

<listitem>

<simpara>

&null; es convertido en cadena vacía.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_STRINGIFY_FETCHES</constant></term>

<listitem>

<para>

Controla si los valores recuperados (excepto &null;) son convertidos en strings.

Acepta un valor de tipo <type>bool</type>: &true; para activar y &false;

para desactivar (valor por omisión).

Los valores &null; permanecen inalterados, excepto si <constant>PDO::ATTR_ORACLE_NULLS</constant>

está definido en <constant>PDO::NULL_TO_STRING</constant>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_STATEMENT_CLASS</constant></term>

<listitem>

<para>

Configura la clase de resultado derivada de PDOStatement

y definida por el usuario.

<!-- TODO improve description of the value it takes, or refer to other docs -->

Requiere <literal>array(string classname, array(mixed constructor_args))</literal>.

</para>

<caution>

<simpara>

No puede ser utilizado con las instancias persistentes de PDO.

</simpara>

</caution>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_TIMEOUT</constant></term>

<listitem>

<para>

Especifica la duración del tiempo límite en segundos.

Toma un valor de tipo <type>int</type>.

</para>

<note>

<para>

No todos los controladores soportan esta opción, y su significado puede

diferir en función de los controladores. Por ejemplo, SQLite esperará durante

este período para obtener un bloqueo de escritura, pero otros controladores

pueden interpretar esto como un tiempo límite de conexión o de lectura.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_AUTOCOMMIT</constant></term>

<listitem>

<note>

<simpara>

Disponible únicamente para los controladores OCI, Firebird y MySQL.

</simpara>

</note>

<para>

Determina si cada consulta es autocommit.

Toma un valor de tipo <type>bool</type>: &true; para activar y

&false; para desactivar. Por omisión, &true;.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_EMULATE_PREPARES</constant></term>

<listitem>

<note>

<simpara>

Disponible únicamente para los controladores OCI, Firebird y MySQL.

</simpara>

</note>

<para>

Configura la activación o desactivación de las consultas preparadas emuladas.

Algunos controladores no soportan las consultas preparadas nativamente o

tienen un soporte limitado.

Si se define en &true; PDO siempre emulará las consultas preparadas,

de lo contrario PDO intentará utilizar las consultas preparadas nativas.

En el caso de que el controlador no pueda preparar la consulta actual,

PDO siempre recaerá en la emulación de consultas preparadas.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::MYSQL_ATTR_USE_BUFFERED_QUERY</constant></term>

<listitem>

<note>

<simpara>

Disponible únicamente para el controlador MySQL.

</simpara>

</note>

<para>

Configura el uso de consultas con búfer.

Toma un valor de tipo <type>bool</type>: &true; para activar y

&false; para desactivar. Por omisión, &true;.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>PDO::ATTR_DEFAULT_FETCH_MODE</constant></term>

<listitem>

<para>

Define el modo de recuperación.

Una descripción de los modos y cómo utilizarlos está disponible en

la documentación de <methodname>PDOStatement::fetch</methodname>.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>attribute</parameter></term>

<listitem>

<para>

El atributo a modificar.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>value</parameter></term>

<listitem>

<para>

El valor al que definir el <parameter>attribute</parameter>,

esto puede requerir un tipo específico dependiendo del atributo.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

&return.success;

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>PDO::getAttribute</function></member>

<member><function>PDOStatement::getAttribute</function></member>

<member><function>PDOStatement::setAttribute</function></member>

</simplelist>

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->