mirror of
https://github.com/php/doc-es.git
synced 2026-03-23 23:12:09 +01:00
igbinary : fix XML by converting para to simpara tags via script
This commit is contained in:
Gina Peter Banyard
@@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: edd5686aff3f4b2d14eec931b875ee4e0e152b27 Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.igbinary-serialize">
|
||||
<refnamediv>
|
||||
@@ -13,16 +13,16 @@
|
||||
<type class="union"><type>string</type><type>false</type></type><methodname>igbinary_serialize</methodname>
|
||||
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
|
||||
</methodsynopsis>
|
||||
<para>
|
||||
<simpara>
|
||||
Genera una representación almacenable de un valor.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Es una técnica práctica para almacenar o pasar valores PHP entre scripts, sin perder su estructura ni su tipo.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Para reconvertir la cadena sérializada en un valor PHP,
|
||||
la función <function>igbinary_unserialize</function> puede ser utilizada.
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
@@ -31,14 +31,14 @@
|
||||
<varlistentry>
|
||||
<term><parameter>value</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
<simpara>
|
||||
El valor a serializar. <function>igbinary_serialize</function>
|
||||
gestiona todos los tipos excepto los <type>recurso</type>s y ciertos <type>objeto</type>s (confiere la nota a continuación).
|
||||
Incluso los &array;x que contienen referencias a sí mismos pueden ser serializados con <function>igbinary_serialize</function>.
|
||||
Las referencias circulares dentro de un &array; o de un &object; a serializar serán igualmente almacenadas.
|
||||
Cualquier otra referencia será perdida.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Al serializar objetos, igbinary intentará llamar a los métodos mágicos
|
||||
<link linkend="object.serialize">__serialize()</link> o
|
||||
<link linkend="object.sleep">__sleep()</link> antes de la serialización.
|
||||
@@ -46,13 +46,13 @@
|
||||
De igual manera, cuando el objeto es restaurado utilizando la función
|
||||
<function>igbinary_unserialize</function>, uno de los métodos mágicos <link linkend="object.unserialize">__unserialize()</link>
|
||||
o <link linkend="object.wakeup">__wakeup()</link> es llamado.
|
||||
</para>
|
||||
</simpara>
|
||||
<note>
|
||||
<para>
|
||||
<simpara>
|
||||
Los atributos privados de un objeto tendrán el nombre de la clase prefijado al nombre del atributo;
|
||||
los atributos protegidos serán prefijados con un asterisco <literal>'*'</literal>.
|
||||
Estos valores prefijados tienen caracteres nulos en ambos lados.
|
||||
</para>
|
||||
</simpara>
|
||||
</note>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -61,16 +61,16 @@
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
<simpara>
|
||||
Retorna una cadena de caracteres que contiene una representación del parámetro <parameter>value</parameter>
|
||||
en forma de flujo de bytes que puede ser almacenado en cualquier lugar.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Es de notar que es una cadena binaria que puede incluir caracteres nulos, y debe por lo tanto ser almacenada y gestionada como tal.
|
||||
Por ejemplo, en una base de datos, la salida de la función <function>igbinary_serialize</function>
|
||||
debe, en general, ser almacenada en un campo de tipo <literal>BLOB</literal>
|
||||
en lugar de en un campo de tipo <literal>CHAR</literal> o <literal>TEXT</literal>.
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="examples">
|
||||
@@ -102,17 +102,17 @@ array (
|
||||
<refsect1 role="notes">
|
||||
&reftitle.notes;
|
||||
<note>
|
||||
<para>
|
||||
<simpara>
|
||||
Es de notar que muchos objetos internos de PHP no pueden ser serializados. Sin embargo, aquellos que pueden
|
||||
implementan ya sea la interfaz <interfacename>Serializable</interfacename> o los métodos mágicos
|
||||
<link linkend="object.serialize">__serialize()</link>/<link linkend="object.unserialize">__unserialize()</link>
|
||||
o <link linkend="object.sleep">__sleep()</link>/<link linkend="object.wakeup">__wakeup()</link>.
|
||||
Si una clase interna no cumple ninguna de estas condiciones, no puede ser serializada de manera fiable.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Existen excepciones históricas a esta regla, donde objetos internos pueden ser serializados
|
||||
sin implementar ni la interfaz ni los métodos mágicos.
|
||||
</para>
|
||||
</simpara>
|
||||
</note>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: edd5686aff3f4b2d14eec931b875ee4e0e152b27 Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.igbinary-unserialize">
|
||||
<refnamediv>
|
||||
@@ -20,7 +20,7 @@
|
||||
<function>igbinary_serialize</function> y la convierte en una variable PHP.
|
||||
</simpara>
|
||||
<warning>
|
||||
<para>
|
||||
<simpara>
|
||||
Las entradas de usuario no confiables no deben pasarse a la función
|
||||
<function>igbinary_unserialize</function>.
|
||||
La deserialización puede resultar en la ejecución de código cargado y ejecutado durante la instanciación
|
||||
@@ -28,20 +28,20 @@
|
||||
este comportamiento.
|
||||
En su lugar, un estándar de intercambio seguro como JSON (a través de <function>json_decode</function> y
|
||||
<function>json_encode</function>) debe usarse para pasar datos serializados al usuario.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Si es indispensable deserializar datos serializados provenientes del exterior, la función
|
||||
<function>hash_hmac</function> puede usarse para validar los datos.
|
||||
Es importante verificar que nadie haya alterado los datos.
|
||||
</para>
|
||||
</simpara>
|
||||
</warning>
|
||||
<warning>
|
||||
<para>
|
||||
<simpara>
|
||||
El protocolo de serialización por igbinary no permite distinguir entre los diferentes grupos de
|
||||
referencias. Todas las referencias PHP a un valor dado son vistas como miembros de un mismo
|
||||
grupo durante la deserialización, incluso si pertenecían a grupos diferentes antes de la
|
||||
serialización.
|
||||
</para>
|
||||
</simpara>
|
||||
</warning>
|
||||
</refsect1>
|
||||
|
||||
@@ -51,26 +51,26 @@
|
||||
<varlistentry>
|
||||
<term><parameter>str</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
<simpara>
|
||||
La cadena serializada, generada por <function>igbinary_serialize</function>.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Si la variable deserializada es un &object;, después de reconstruirla con éxito,
|
||||
PHP intentará automáticamente llamar a los métodos mágicos
|
||||
<link linkend="object.unserialize">__unserialize()</link> o
|
||||
<link linkend="object.wakeup">__wakeup()</link> (si alguno de ellos existe).
|
||||
</para>
|
||||
</simpara>
|
||||
<note>
|
||||
<title>
|
||||
La directiva <link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
|
||||
</title>
|
||||
<para>
|
||||
<simpara>
|
||||
La función de retrollamada especificada en la directiva
|
||||
<link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
|
||||
es llamada cuando una clase no definida es deserializada.
|
||||
Si ninguna función de retrollamada es especificada, el objeto será instanciado
|
||||
como <classname>__PHP_Incomplete_Class</classname>.
|
||||
</para>
|
||||
</simpara>
|
||||
</note>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -79,34 +79,34 @@
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
<simpara>
|
||||
El valor convertido es retornado por la función, y puede ser de tipo <type>&boolean;</type>,
|
||||
<type>&integer;</type>, <type>&float;</type>, <type>&string;</type>,
|
||||
<type>&array;</type>, <type>&object;</type>, o de tipo <type>null</type>.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
Si la cadena pasada no puede ser deserializada, esta función retorna &false; y
|
||||
un diagnóstico <constant>E_NOTICE</constant> o <constant>E_WARNING</constant> es emitido.
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<para>
|
||||
<simpara>
|
||||
Los objetos pueden lanzar un <classname>Throwable</classname> en su gestor de deserialización.
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="notes">
|
||||
&reftitle.notes;
|
||||
<warning>
|
||||
<para>
|
||||
<simpara>
|
||||
&null; o &false; es retornado ya sea en caso de error o después de deserializar
|
||||
el resultado de la serialización de &null; o &false;. Es posible discriminar entre estos dos casos
|
||||
especiales comparando el valor del parámetro <parameter>str</parameter> con el resultado de la ejecución
|
||||
de <code>igbinary_serialize(null)</code> o de <code>igbinary_serialize(false)</code>
|
||||
o bien atrapando un diagnóstico <constant>E_NOTICE</constant>.
|
||||
</para>
|
||||
</simpara>
|
||||
</warning>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: edd5686aff3f4b2d14eec931b875ee4e0e152b27 Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<section xmlns="http://docbook.org/ns/docbook" xml:id="igbinary.configuration">
|
||||
&reftitle.runtime;
|
||||
@@ -59,10 +59,10 @@
|
||||
<type>bool</type>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
<simpara>
|
||||
Activa o no el compactado de strings duplicados.
|
||||
El valor por omisión es On.
|
||||
</para>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
@@ -72,9 +72,9 @@
|
||||
<type>string</type>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
<simpara>
|
||||
Igbinary es utilizado como gestor de sesión al establecer el valor de esta opción a <literal>igbinary</literal>.
|
||||
</para>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
@@ -1,21 +1,21 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 605553e228c78a9368736f4ff36d185cf7e6eb22 Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: PhilDaiguille Status: ready -->
|
||||
<!-- Reviewed: yes -->
|
||||
<chapter xml:id="igbinary.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="igbinary.setup">
|
||||
&reftitle.setup;
|
||||
|
||||
<section xml:id="igbinary.installation">
|
||||
&reftitle.install;
|
||||
<para>
|
||||
<simpara>
|
||||
&pecl.moved;
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
&pecl.info;
|
||||
<link xlink:href="&url.pecl.package;igbinary">&url.pecl.package;igbinary</link>.
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
&pecl.windows.download.avail;
|
||||
</para>
|
||||
</simpara>
|
||||
</section>
|
||||
|
||||
&reference.igbinary.ini;
|
||||
|
||||
Reference in New Issue
Block a user