Skip to content

Commit 647d489

Browse files
author
Pedro Antonio Gil Rodríguez
committed
Actualización a la última versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@329971 c90b9560-bf6c-de11-be94-00142212c4b1
1 parent d3262c6 commit 647d489

File tree

5 files changed

+121
-118
lines changed

5 files changed

+121
-118
lines changed

‎reference/mysqli/configure.xml

+8-9
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 0cce59a58b31aa547d8528100af40688ce98a71e Maintainer: yago Status: ready -->
3+
<!-- EN-Revision: cd09fab47b40563cb8b2316d817efc973d991713 Maintainer: seros Status: ready -->
44
<!-- Reviewed: no Maintainer: andresdzphp -->
5-
65
<section xml:id="mysqli.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
76

87
&reftitle.install;
@@ -56,21 +55,21 @@
5655
<entry>PHP &Version;</entry>
5756
<entry>&Default;</entry>
5857
<entry>&ConfigureOptions;: <link linkend="mysqlnd.overview">mysqlnd</link></entry>
59-
<entry>&ConfigureOptions;: <literal>libmysql</literal></entry>
58+
<entry>&ConfigureOptions;: <literal>libmysqlclient</literal></entry>
6059
<entry>&Changelog;</entry>
6160
</row>
6261
</thead>
6362
<tbody>
6463
<row>
6564
<entry>5.0.x, 5.1.x, 5.2.x</entry>
66-
<entry>libmysql</entry>
65+
<entry>libmysqlclient</entry>
6766
<entry>&NotAvailable;</entry>
6867
<entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
6968
<entry></entry>
7069
</row>
7170
<row>
7271
<entry>5.3.x</entry>
73-
<entry>libmysql</entry>
72+
<entry>libmysqlclient</entry>
7473
<entry><option role="configure">--with-mysqli=mysqlnd</option></entry>
7574
<entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
7675
<entry>mysqlnd ahora es soportada</entry>
@@ -89,7 +88,7 @@
8988
<para>
9089
Observe que es posible mezclar libremente extensiones de MySQL y bibliotecas
9190
cliente. Por ejemplo, es posible habilitar la extensión de MySQL
92-
para usar la Biblioteca Cliente de MySQL (libmysql), mientras se configura la
91+
para usar la Biblioteca Cliente de MySQL (libmysqlclient), mientras se configura la
9392
extensión <literal>mysqli</literal> para usar el Controlador Nativo de MySQL.
9493
No obstante, son posibles todas las permutaciones de extensiones y bibliotecas
9594
cliente.
@@ -101,14 +100,14 @@
101100
para usar el Controlador Nativo de MySQL:
102101
</para>
103102

104-
<programlisting role="shell">
105-
<![CDATA[
103+
<programlisting role="shell">
104+
<![CDATA[
106105
./configure --with-mysql=/usr/bin/mysql_config \
107106
--with-mysqli=mysqlnd \
108107
--with-pdo-mysql=mysqlnd
109108
[other options]
110109
]]>
111-
</programlisting>
110+
</programlisting>
112111
</section>
113112

114113
<section xml:id="mysqli.installation.windows">

‎reference/mysqli/ini.xml

+74-75
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7afe7c875019605f355748d0a886d568f4c3f2fd Maintainer: argosback Status: ready -->
3+
<!-- EN-Revision: cd09fab47b40563cb8b2316d817efc973d991713 Maintainer: seros Status: ready -->
44
<!-- Reviewed: no Maintainer: andresdzphp -->
55
<section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.runtime;
@@ -164,25 +164,24 @@
164164
<literal>MYSQL_PORT</literal>.
165165
</para>
166166
</listitem>
167-
</varlistentry>
168-
169-
<varlistentry xml:id="ini.mysqli.default-socket">
170-
<term>
171-
<parameter>mysqli.default_socket</parameter>
172-
<type>string</type>
173-
</term>
174-
<listitem>
175-
<para>
176-
El nombre de socket predeterminado para usar cuando se conecta a un
177-
servidor de base de datos local, si no se especifica ningún nombre de
178-
otro conector.
179-
</para>
180-
</listitem>
181-
</varlistentry>
182-
<varlistentry xml:id="ini.mysqli.default-host">
183-
<term>
184-
<parameter>mysqli.default_host</parameter>
185-
<type>string</type>
167+
</varlistentry>
168+
169+
<varlistentry xml:id="ini.mysqli.default-socket">
170+
<term>
171+
<parameter>mysqli.default_socket</parameter>
172+
<type>string</type>
173+
</term>
174+
<listitem>
175+
<para>
176+
El nombre de socket predeterminado a usar cuando se conecta a un servidor
177+
de bases de datos local si no se especifica ningún otro nombre de socket.
178+
</para>
179+
</listitem>
180+
</varlistentry>
181+
<varlistentry xml:id="ini.mysqli.default-host">
182+
<term>
183+
<parameter>mysqli.default_host</parameter>
184+
<type>string</type>
186185
</term>
187186
<listitem>
188187
<para>
@@ -191,66 +190,66 @@
191190
<link linkend="ini.safe-mode">safe mode</link>.
192191
</para>
193192
</listitem>
194-
</varlistentry>
195-
196-
<varlistentry xml:id="ini.mysqli.default-user">
197-
<term>
198-
<parameter>mysqli.default_user</parameter>
199-
<type>string</type>
200-
</term>
201-
<listitem>
202-
<para>
203-
El nombre de usuario predeterminado a usar cuando se conecta a la base de datos
204-
servidor si no se indica otra. No se aplica en
205-
<link linkend="ini.safe-mode">safe mode</link>.
206-
</para>
207-
</listitem>
208-
</varlistentry>
209-
210-
<varlistentry xml:id="ini.mysqli.default-pw">
211-
<term>
212-
<parameter>mysqli.default_pw</parameter>
213-
<type>string</type>
214-
</term>
215-
<listitem>
216-
<para>
217-
La contraseña predeterminada a usar cuando se conecta a la base de datos
218-
servidor si no se indica otra. No se aplica en
219-
<link linkend="ini.safe-mode">safe mode</link>.
220-
</para>
221-
</listitem>
222-
</varlistentry>
223-
224-
<varlistentry xml:id="ini.mysqli.reconnect">
225-
<term>
226-
<parameter>mysqli.reconnect</parameter>
227-
<type>integer</type>
228-
</term>
229-
<listitem>
230-
<para>
231-
Vuelve a conectar automáticamente si se pierde la conexión.
232-
</para>
233-
</listitem>
234-
</varlistentry>
235-
236-
<varlistentry xml:id="ini.mysqli.cache-size">
237-
<term>
238-
<parameter>mysqli.cache_size</parameter>
239-
<type>integer</type>
240-
</term>
241-
<listitem>
242-
<para>
243-
&mysqli.available.mysqlnd;
244-
</para>
245-
</listitem>
246-
</varlistentry>
247-
193+
</varlistentry>
194+
195+
<varlistentry xml:id="ini.mysqli.default-user">
196+
<term>
197+
<parameter>mysqli.default_user</parameter>
198+
<type>string</type>
199+
</term>
200+
<listitem>
201+
<para>
202+
El nombre de usuario predeterminado a usar cuando se conecta a la base de datos
203+
servidor si no se indica otra. No se aplica en
204+
<link linkend="ini.safe-mode">safe mode</link>.
205+
</para>
206+
</listitem>
207+
</varlistentry>
208+
209+
<varlistentry xml:id="ini.mysqli.default-pw">
210+
<term>
211+
<parameter>mysqli.default_pw</parameter>
212+
<type>string</type>
213+
</term>
214+
<listitem>
215+
<para>
216+
La contraseña predeterminada a usar cuando se conecta a la base de datos
217+
servidor si no se indica otra. No se aplica en
218+
<link linkend="ini.safe-mode">safe mode</link>.
219+
</para>
220+
</listitem>
221+
</varlistentry>
222+
223+
<varlistentry xml:id="ini.mysqli.reconnect">
224+
<term>
225+
<parameter>mysqli.reconnect</parameter>
226+
<type>integer</type>
227+
</term>
228+
<listitem>
229+
<para>
230+
Vuelve a conectar automáticamente si se pierde la conexión.
231+
</para>
232+
</listitem>
233+
</varlistentry>
234+
235+
<varlistentry xml:id="ini.mysqli.cache-size">
236+
<term>
237+
<parameter>mysqli.cache_size</parameter>
238+
<type>integer</type>
239+
</term>
240+
<listitem>
241+
<para>
242+
&mysqli.available.mysqlnd;
243+
</para>
244+
</listitem>
245+
</varlistentry>
246+
248247
</variablelist>
249248
</para>
250249
<para>
251250
El usuario no puede modificar <literal>MYSQL_OPT_READ_TIMEOUT</literal> mediante una llamada
252251
a la API o con ajustes de configuración en tiempo de ejecución. Tenga en cuenta que si fuera
253-
posible habría diferencias entre cómo interpretarían <literal>libmysql</literal> y
252+
posible habría diferencias entre cómo interpretarían <literal>libmysqlclient</literal> y
254253
los flujos el valor de <literal>MYSQL_OPT_READ_TIMEOUT</literal>.
255254
</para>
256255
</section>

‎reference/mysqli/mysqli/query.xml

+20-16
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,14 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d316f465df3ecaf4fe09440a05c261553c27d12d Maintainer: yago Status: ready -->
3+
<!-- EN-Revision: cd09fab47b40563cb8b2316d817efc973d991713 Maintainer: seros Status: ready -->
44
<!-- Reviewed: no Maintainer: andresdzphp -->
5-
65
<refentry xml:id="mysqli.query" xmlns="http://docbook.org/ns/docbook">
76
<refnamediv>
87
<refname>mysqli::query</refname>
98
<refname>mysqli_query</refname>
109
<refpurpose>Realiza una consulta a la Base de Datos</refpurpose>
1110
</refnamediv>
12-
11+
1312
<refsect1 role="description">
1413
&reftitle.description;
1514
<para>&style.oop;</para>
@@ -26,19 +25,23 @@
2625
<methodparam choice="opt"><type>int</type><parameter>resultmode</parameter><initializer>MYSQLI_STORE_RESULT</initializer></methodparam>
2726
</methodsynopsis>
2827
<para>
29-
Realiza una consulta o busqueda(<parameter>query</parameter>) contra la base de datos.
28+
Realiza una consulta o busqueda(<parameter>query</parameter>) en la base de datos.
3029
</para>
3130
<para>
32-
Esta funcion,funcionalmente, es identica a la llamada a
31+
Para consultas que no sean DML (distintas de INSERT, UPDATE o DELETE),
32+
esta funcion es similar a invocar a
3333
<function>mysqli_real_query</function> seguida de
3434
<function>mysqli_use_result</function> o
3535
<function>mysqli_store_result</function>.
3636
</para>
3737
<note>
3838
<para>
39-
En el caso de pasarle una declaracion a
40-
<function>mysqli_query</function> que sea mayor a
41-
<literal>max_allowed_packet</literal> del servidor, el codigo de error retornado difiere dependiendo de que se este usando los controladores nativos de MySQL(<literal>mysqlnd</literal>) o la libreria para cliente MySQL (<literal>libmysql</literal>). El comportamiento sera el siguiente:
39+
En el caso de pasarle una sentencia a
40+
<function>mysqli_query</function> que sea mayor que
41+
<literal>max_allowed_packet</literal> del servidor, los códigos
42+
de error retornados difieren dependiendo de si se está usando el Controlador
43+
Nativo de MySQL(<literal>mysqlnd</literal>) o la Biblioteca Cliente de MySQL
44+
(<literal>libmysqlclient</literal>). El comportamiento es el siguiente:
4245
</para>
4346
<itemizedlist>
4447
<listitem>
@@ -56,14 +59,15 @@
5659
</listitem>
5760
<listitem>
5861
<para>
59-
<literal>libmysql</literal> en toda las plataformas retorna el error
60-
2006. Esto significa <quote>que el servidor salio de linea</quote>.
62+
<literal>libmysqlclient</literal> en toda las plataformas retorna el código de
63+
error 2006. Este mensaje de error significa que <quote>el servidor se
64+
ha salido</quote>.
6165
</para>
6266
</listitem>
6367
</itemizedlist>
6468
</note>
6569
</refsect1>
66-
70+
6771
<refsect1 role="parameters">
6872
&reftitle.parameters;
6973
<para>
@@ -101,7 +105,7 @@
101105
</variablelist>
102106
</para>
103107
</refsect1>
104-
108+
105109
<refsect1 role="returnvalues">
106110
&reftitle.returnvalues;
107111
<para>
@@ -110,7 +114,7 @@
110114
El objeto de la clase <classname>mysqli_result</classname>. Para otras consultas <function>mysqli_query</function> retornara &true; si tiene exito.
111115
</para>
112116
</refsect1>
113-
117+
114118
<refsect1 role="changelog">
115119
&reftitle.changelog;
116120
<para>
@@ -134,7 +138,7 @@
134138
</informaltable>
135139
</para>
136140
</refsect1>
137-
141+
138142
<refsect1 role="examples">
139143
&reftitle.examples;
140144
<example>
@@ -231,7 +235,7 @@ Error: Commands out of sync; You can't run this command now
231235
</screen>
232236
</example>
233237
</refsect1>
234-
238+
235239
<refsect1 role="seealso">
236240
&reftitle.seealso;
237241
<para>
@@ -242,7 +246,7 @@ Error: Commands out of sync; You can't run this command now
242246
</simplelist>
243247
</para>
244248
</refsect1>
245-
249+
246250
</refentry>
247251

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

‎reference/mysqli/notes.xml

+17-16
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,35 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d2c9cd6da46d4920fcb365cdc636e8f37fd6cf3e Maintainer: jpberdejo Status: ready -->
3+
<!-- EN-Revision: cd09fab47b40563cb8b2316d817efc973d991713 Maintainer: seros Status: ready -->
4+
<!-- Reviewed: no -->
45
<chapter xml:id="mysqli.notes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<title>Notas</title>
6-
7+
78
<para>Algunas notas sobre la implementación:</para>
8-
9+
910
<orderedlist>
1011
<listitem>
1112
<para>
12-
El soporte para <literal>MYSQL_TYPE_GEOMETRY</literal> fue agregado
13-
a la extensión MySQLi en PHP 5.3.
13+
El soporte para <literal>MYSQL_TYPE_GEOMETRY</literal> fue agregado
14+
a la extensión MySQLi en PHP 5.3.
1415
</para>
1516
</listitem>
1617
<listitem>
1718
<para>
18-
Nótese que existen diferentes implementaciones internas en
19-
<literal>libmysql</literal> y <literal>mysqlnd</literal> para manejar
20-
columnas del tipo <literal>MYSQL_TYPE_GEOMETRY</literal>. En términos generales,
21-
<literal>mysqlnd</literal> asignará significativamente menos memoria. Por
22-
ejemplo, si hay una columna <literal>POINT</literal>
23-
en un set de resultado, <literal>libmysql</literal> puede pre-asignar
24-
hasta 4GB de RAM aunque se necesitan menos de 50 bytes
25-
para mantener una comuna <literal>POINT</literal> en memoria. La asignación
26-
de memoria es mucho menor, menos de 50 bytes, si se
27-
utiliza <literal>mysqlnd</literal>.
19+
Nótese que existen diferentes implementaciones internas en
20+
<literal>libmysqlclient</literal> y <literal>mysqlnd</literal> para manejar
21+
columnas del tipo <literal>MYSQL_TYPE_GEOMETRY</literal>. En términos generales,
22+
<literal>mysqlnd</literal> asignará significativamente menos memoria. Por
23+
ejemplo, si hay una columna <literal>POINT</literal>
24+
en un set de resultado, <literal>libmysqlclient</literal> puede pre-asignar
25+
hasta 4GB de RAM aunque se necesitan menos de 50 bytes
26+
para mantener una comuna <literal>POINT</literal> en memoria. La asignación
27+
de memoria es mucho menor, menos de 50 bytes, si se
28+
utiliza <literal>mysqlnd</literal>.
2829
</para>
2930
</listitem>
3031
</orderedlist>
31-
32+
3233
</chapter>
3334

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

0 commit comments

Comments
 (0)