Skip to content

Commit eaca1fa

Browse files
GirgiasGirgias
committed
igbinary : fix XML by converting para to simpara tags via script
1 parent af4cd8e commit eaca1fa

4 files changed

Lines changed: 57 additions & 55 deletions

File tree

‎reference/igbinary/functions/igbinary-serialize.xml‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: edd5686aff3f4b2d14eec931b875ee4e0e152b27 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.igbinary-serialize">
44
<refnamediv>
55
<refname>igbinary_serialize</refname>
@@ -12,17 +12,17 @@
1212
<type class="union"><type>string</type><type>false</type></type><methodname>igbinary_serialize</methodname>
1313
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Gera uma representação armazenável de um valor.
17-
</para>
18-
<para>
17+
</simpara>
18+
<simpara>
1919
Isso é útil para armazenar ou passar valores PHP sem
2020
perder seu tipo e estrutura.
21-
</para>
22-
<para>
21+
</simpara>
22+
<simpara>
2323
Para transformar a string serializada em um valor PHP novamente,
2424
a função <function>igbinary_unserialize</function> pode ser usada.
25-
</para>
25+
</simpara>
2626
</refsect1>
2727

2828
<refsect1 role="parameters">
@@ -31,28 +31,28 @@
3131
<varlistentry>
3232
<term><parameter>value</parameter></term>
3333
<listitem>
34-
<para>
34+
<simpara>
3535
O valor a ser serializado. <function>igbinary_serialize</function>
3636
lida com todos os tipos, exceto o tipo <type>resource</type> e alguns <type>object</type>s (veja nota abaixo).
3737
Mesmo &array;s que contenham referências a si mesmo podem ser processados ​​por <function>igbinary_serialize</function>.
3838
As referências circulares dentro do &array; ou &object; que está sendo serializado também serão armazenadas.
3939
Qualquer outra referência será perdida.
40-
</para>
41-
<para>
40+
</simpara>
41+
<simpara>
4242
Ao serializar objetos, igbinary tentará chamar as funções membro
4343
<link linkend="object.serialize">__serialize()</link> ou
4444
<link linkend="object.sleep">__sleep()</link> antes da serialização.
4545
Isso permite que o objeto faça qualquer limpeza de última hora, etc., antes
4646
de ser serializado. Da mesma forma, quando o objeto é restaurado usando
4747
<function>igbinary_unserialize</function>, a função membro <link linkend="object.unserialize">__unserialize()</link> ou
4848
<link linkend="object.wakeup">__wakeup()</link> será chamada.
49-
</para>
49+
</simpara>
5050
<note>
51-
<para>
51+
<simpara>
5252
Membros privados de &object;s têm o nome da classe anexado ao nome do
5353
membro; membros protegidos têm um <literal>'*'</literal> prefixando o nome do membro.
5454
Esses valores prefixados possuem bytes nulos em ambos os lados.
55-
</para>
55+
</simpara>
5656
</note>
5757
</listitem>
5858
</varlistentry>
@@ -61,16 +61,16 @@
6161

6262
<refsect1 role="returnvalues">
6363
&reftitle.returnvalues;
64-
<para>
64+
<simpara>
6565
Retorna uma string contendo uma representação de fluxo de bytes de
6666
<parameter>value</parameter> que pode ser armazenada em qualquer lugar.
67-
</para>
68-
<para>
67+
</simpara>
68+
<simpara>
6969
Observe que esta é uma string binária que pode incluir qualquer valor de byte e precisa
7070
ser armazenada e tratada como tal. Por exemplo,
7171
a saída de <function>igbinary_serialize</function> geralmente deve ser armazenada em um campo <literal>BLOB</literal>
7272
em um banco de dados, em vez de um campo <literal>CHAR</literal> ou <literal>TEXT</literal>.
73-
</para>
73+
</simpara>
7474
</refsect1>
7575

7676
<refsect1 role="examples">
@@ -102,18 +102,18 @@ array (
102102
<refsect1 role="notes">
103103
&reftitle.notes;
104104
<note>
105-
<para>
105+
<simpara>
106106
Observe que muitos objetos integrados no PHP não podem ser serializados. No entanto, aqueles com
107107
essa habilidade implementam a interface <interfacename>Serializable</interfacename> ou os métodos
108108
mágicos <link linkend="object.serialize">__serialize()</link>/<link linkend="object.unserialize">__unserialize()</link>
109109
ou <link linkend="object.sleep">__sleep()</link>/<link linkend="object.wakeup">__wakeup()</link>. Se uma
110110
classe interna não atender a nenhum desses requisitos, ela não poderá ser serializada
111111
de forma confiável com nenhum serializador.
112-
</para>
113-
<para>
112+
</simpara>
113+
<simpara>
114114
Existem algumas exceções históricas à regra acima, onde alguns objetos internos
115115
poderiam ser serializados sem implementar a interface ou expor os métodos.
116-
</para>
116+
</simpara>
117117
</note>
118118
</refsect1>
119119

‎reference/igbinary/functions/igbinary-unserialize.xml‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: edd5686aff3f4b2d14eec931b875ee4e0e152b27 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.igbinary-unserialize">
44
<refnamediv>
55
<refname>igbinary_unserialize</refname>
@@ -19,27 +19,27 @@
1919
<function>igbinary_serialize</function> e a converte de volta em um valor PHP.
2020
</simpara>
2121
<warning>
22-
<para>
22+
<simpara>
2323
Entradas não confiáveis de usuários ​​não devem ser passadas para <function>igbinary_unserialize</function>.
2424
A desserialização pode resultar no carregamento e execução do código devido à instanciação
2525
e carregamento automático do objeto, e um usuário mal-intencionado pode explorar
2626
isso. Em vez disso, um formato de intercâmbio de dados padrão e seguro, como JSON (via
2727
<function>json_decode</function> e <function>json_encode</function>) deve ser usado,
2828
se dados serializados precisarem ser passados ​​para um cliente.
29-
</para>
30-
<para>
29+
</simpara>
30+
<simpara>
3131
Se houver necessidade de desserializar dados serializados armazenados externamente,
3232
<function>hash_hmac</function> pode ser usada para validação de dados.
3333
É importante garantir que ninguém tenha adulterado os dados.
34-
</para>
34+
</simpara>
3535
</warning>
3636
<warning>
37-
<para>
37+
<simpara>
3838
O formato de serialização igbinary não fornece uma maneira de distinguir entre diferentes grupos de
3939
referência para o mesmo valor. Todas as referências PHP a um determinado valor são tratadas como parte
4040
do mesmo grupo de referência quando desserializadas,
4141
mesmo que façam parte de grupos de referência diferentes quando serializadas.
42-
</para>
42+
</simpara>
4343
</warning>
4444
</refsect1>
4545

@@ -49,27 +49,27 @@
4949
<varlistentry>
5050
<term><parameter>str</parameter></term>
5151
<listitem>
52-
<para>
52+
<simpara>
5353
A string serializada gerada por <function>igbinary_serialize</function>.
54-
</para>
55-
<para>
54+
</simpara>
55+
<simpara>
5656
Se o valor que está sendo desserializado for um &object;, após a reconstrução
5757
bem-sucedida do objeto, o igbinary tentará automaticamente chamar os métodos
5858
<link linkend="object.unserialize">__unserialize()</link> ou
5959
<link linkend="object.wakeup">__wakeup()</link> (se existirem).
60-
</para>
60+
</simpara>
6161
<note>
6262
<title>
6363
Diretiva
6464
<link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
6565
</title>
66-
<para>
66+
<simpara>
6767
A função de retorno especificada na diretiva
6868
<link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
6969
é chamada quando uma classe indefinida é desserializada.
7070
Se nenhuma função de retorno for especificada, o objeto será instanciado como
7171
uma <classname>__PHP_Incomplete_Class</classname>.
72-
</para>
72+
</simpara>
7373
</note>
7474
</listitem>
7575
</varlistentry>
@@ -78,34 +78,34 @@
7878

7979
<refsect1 role="returnvalues">
8080
&reftitle.returnvalues;
81-
<para>
81+
<simpara>
8282
O valor convertido é retornado, e pode ser dos tipos <type>bool</type>,
8383
<type>int</type>, <type>float</type>, <type>string</type>,
8484
<type>array</type>, <type>object</type> ou <type>null</type>.
85-
</para>
86-
<para>
85+
</simpara>
86+
<simpara>
8787
Caso a string passada não for desserializável, &false; é retornado e
8888
um <constant>E_NOTICE</constant> ou <constant>E_WARNING</constant> é emitido.
89-
</para>
89+
</simpara>
9090
</refsect1>
9191

9292
<refsect1 role="errors">
9393
&reftitle.errors;
94-
<para>
94+
<simpara>
9595
Objetos podem lançar <classname>Throwable</classname>s em seus manipuladores de desserialização.
96-
</para>
96+
</simpara>
9797
</refsect1>
9898

9999
<refsect1 role="notes">
100100
&reftitle.notes;
101101
<warning>
102-
<para>
102+
<simpara>
103103
&null; ou &false; serão retornados tanto em caso de erro quanto em caso de desserialização
104104
dos valores &null; ou &false; serializados. É possível capturar este caso especial
105105
comparando <parameter>str</parameter> com
106106
<code>igbinary_serialize(null)</code> ou <code>igbinary_serialize(false)</code>
107107
ou capturando o <constant>E_NOTICE</constant> emitido.
108-
</para>
108+
</simpara>
109109
</warning>
110110
</refsect1>
111111

‎reference/igbinary/ini.xml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: edd5686aff3f4b2d14eec931b875ee4e0e152b27 Maintainer: fernandowobeto Status: ready -->
2+
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: fernandowobeto Status: ready -->
33
<!-- CREDITS: fernandowobeto -->
44
<section xmlns="http://docbook.org/ns/docbook" xml:id="igbinary.configuration">
55
&reftitle.runtime;
@@ -59,10 +59,10 @@
5959
<type>bool</type>
6060
</term>
6161
<listitem>
62-
<para>
62+
<simpara>
6363
Habilita ou desabilita a compactação de strings duplicadas.
6464
O padrão é On.
65-
</para>
65+
</simpara>
6666
</listitem>
6767
</varlistentry>
6868

@@ -72,9 +72,9 @@
7272
<type>string</type>
7373
</term>
7474
<listitem>
75-
<para>
75+
<simpara>
7676
Igbinary é usado como manipulador de sessão definindo este valor como <literal>igbinary</literal>.
77-
</para>
77+
</simpara>
7878
</listitem>
7979
</varlistentry>
8080

‎reference/igbinary/setup.xml‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 605553e228c78a9368736f4ff36d185cf7e6eb22 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
2-
<chapter xml:id="igbinary.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 43dd38b94fbf8a9e3efc9c5bfde27c14b9e2ce9c Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="igbinary.setup">
35
&reftitle.setup;
46

57
<section xml:id="igbinary.installation">
68
&reftitle.install;
7-
<para>
9+
<simpara>
810
&pecl.moved;
9-
</para>
10-
<para>
11+
</simpara>
12+
<simpara>
1113
&pecl.info;
1214
<link xlink:href="&url.pecl.package;igbinary">&url.pecl.package;igbinary</link>.
13-
</para>
14-
<para>
15+
</simpara>
16+
<simpara>
1517
&pecl.windows.download.avail;
16-
</para>
18+
</simpara>
1719
</section>
1820

1921
&reference.igbinary.ini;

0 commit comments

Comments
 (0)