Sync mysql docs with EN

php · Nov 10, 2023 · cdcf679 · cdcf679
1 parent 2ce1a41
commit cdcf679
Show file tree

Hide file tree

Showing 33 changed files with 351 additions and 535 deletions.
diff --git a/reference/mysql/book.xml b/reference/mysql/book.xml
@@ -1,13 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 2b204e9c8e3f3d95a95418d520b995ac4c5eda6e Maintainer: seros Status: ready -->
+<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: seros Status: ready -->
 <!-- Reviewed: yes Maintainer: seros -->
-
+<!-- State: deprecated -->
 <book xml:id="book.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal"?>
+ <?phpdoc extension-membership="pecl"?>
  <title>API original de MySQL</title>
  <titleabbrev>MySQL (Original)</titleabbrev>
- 
+
  <!-- {{{ preface -->
  <preface xml:id="intro.mysql">
   &reftitle.intro;
@@ -30,13 +29,13 @@
   </para>
  </preface>
  <!-- }}} -->
- 
+
  &reference.mysql.setup;
  &reference.mysql.changelog;
  &reference.mysql.constants;
  &reference.mysql.examples;
  &reference.mysql.reference;
- 
+
 </book>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/mysql/changelog.xml b/reference/mysql/changelog.xml
@@ -1,26 +1,25 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 27e54b061f246ebc507cb23fe1837f38f0dcce7e Maintainer: regiemix Status: ready -->
+<!-- EN-Revision: 5fabd07880ab15b0ad2cf7eb055c7c2b36d7120f Maintainer: regiemix Status: ready -->
 <!-- Reviewed: no -->
 
 <appendix xmlns="http://docbook.org/ns/docbook" xml:id="changelog.mysql" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>&ChangelogListingTitle;</title>
  <para>&ChangelogListingDescription;</para>
- 
+
  <simplesect>
   <title>Registro de cambios general para la extensión ext/mysql</title>
   <para>
    Este registro de cambios hace referencia a la extensión ext/mysql.
   </para>
  </simplesect>
- 
+
  <simplesect xml:id="changelog.mysql.global">
   <title>Cambios globales ext/mysql</title>
   <para>
    La lista siguiente recoge los cambios realizados sobre las funciones de la extensión ext/mysql.
   </para>
   <para>
-   <informaltable>
+   <informaltable xml:id="changelog.mysql.global.table">
     <tgroup cols="2">
      <thead>
       <row>
@@ -38,38 +37,12 @@
         </para>
        </entry>
       </row>
-      <row>
-       <entry>5.5.0</entry>
-       <entry>
-        <para>
-         Esta extensión es obsoleta. Conectar a una base de datos MySQL
-         vía <function>mysql_connect</function>,
-         <function>mysql_pconnect</function> o una conexión implícita a través de alguna
-         otra <literal>mysql_*</literal> función devolverá un
-         error <constant>E_DEPRECATED</constant> .
-        </para>
-       </entry>
-      </row>
-      <row>
-       <entry>5.5.0</entry>
-       <entry>
-        <para>
-         Todas las funciones antiguas y alias obsoletos, ahora devolverán
-         errores <constant>E_DEPRECATED</constant> . Estas funciones son:
-        </para>
-        <para>
-         mysql(), mysql_fieldname(), mysql_fieldtable(), mysql_fieldlen(), mysql_fieldtype(), mysql_fieldflags(), mysql_selectdb(),
-         mysql_createdb(), mysql_dropdb(), mysql_freeresult(), mysql_numfields(), mysql_numrows(), mysql_listdbs(), mysql_listtables(),
-         mysql_listfields(), mysql_db_name(), mysql_dbname(), mysql_tablename(), and mysql_table_name().
-        </para>
-       </entry>
-      </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </simplesect>
- 
+
  <simplesect xml:id="changelog.mysql.functions">
   <title>Cambios sobre las funciones existentes</title>
   <para>
@@ -78,7 +51,7 @@
   </para>
   <?phpdoc generate-changelog-for="ref.mysql book.mysql"?>
  </simplesect>
- 
+
 </appendix>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/mysql/configure.xml b/reference/mysql/configure.xml
@@ -1,14 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: seros Status: ready -->
+<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: seros Status: ready -->
 <!-- Reviewed: no Maintainer: andresdzphp -->
 <section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
- 
+
  <warning>
   &mysql.alternative.note;
  </warning>
- 
+
  <para xml:id="mysql.configure">
   Para compilar, simplemente usar la opción de configuración
   <option role="configure">--with-mysql[=DIR]</option>
@@ -24,15 +23,15 @@
   Si se quisiera instalar la extensión de MySQL junto con la extensión MySQLi
   se debe usar la misma libreria de cliente para evitar cualquier conflicto.
  </para>
- 
+
  <section xml:id="mysql.installation.linux">
   <title>Instalación en Sistemas Linux</title>
   <para>
    Nota: <literal>[DIR]</literal> es la ruta a los ficheros de la biblioteca cliente de
    MySQL (<emphasis>cabeceras y bibliotecas</emphasis>), los cuales se pueden descargar desde
    <link xlink:href="&url.mysql;">MySQL</link>.
   </para>
-  <table>
+  <table xml:id="mysql.installation.compile.support">
    <title>Matriz de soporte en tiempo de compilación de ext/mysql</title>
    <tgroup cols="5">
     <thead>
@@ -80,7 +79,7 @@
    </tgroup>
   </table>
  </section>
- 
+
  <section xml:id="mysql.installation.windows">
   <title>Instalación en sistemas Windows</title>
   <section xml:id="mysql.installation.windows.php52">
@@ -125,7 +124,7 @@
    </para>
   </section>
  </section>
- 
+
  <section xml:id="mysql.installation.notes">
   <title>Notas de la instalación de MySQL</title>
   <warning>

diff --git a/reference/mysql/constants.xml b/reference/mysql/constants.xml
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: carlos Status: ready -->
+<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: carlos Status: ready -->
 <!-- Reviewed: no Maintainer: carlos -->
 <appendix xml:id="mysql.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
  <para>
-  Es posible especificar flags adicionales para el cliente en las funciones 
-  <function>mysql_connect</function> y <function>mysql_pconnect</function>. 
+  Es posible especificar flags adicionales para el cliente en las funciones
+  <function>mysql_connect</function> y <function>mysql_pconnect</function>.
   Están definidas las siguientes constantes:
   <table xml:id="mysql.client-flags">
    <title>Constantes del cliente MySQL</title>
@@ -34,19 +34,19 @@
      <row xml:id="constant.mysql-client-ssl">
       <entry><constant>MYSQL_CLIENT_SSL</constant></entry>
       <entry>
-       Usar encriptación SSL. Este flag solo esta disponible con la versión de la libreria 
-       de cliente de MySQL 4.x o superior. La versión 3.23.x se incluye tanto con PHP 4 como 
+       Usar encriptación SSL. Este flag solo esta disponible con la versión de la libreria
+       de cliente de MySQL 4.x o superior. La versión 3.23.x se incluye tanto con PHP 4 como
        con los binarios para Windows de PHP 5.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
- 
+
  <para>
   La función <function>mysql_fetch_array</function> utiliza una constante para los diferentes tipos de arrays resultantes. Estan definidas las siguientes constantes:
-  <table>
+  <table xml:id="mysql.constants.fetch">
    <title>MySQL fetch constantes</title>
    <tgroup cols="2">
     <thead>
@@ -65,7 +65,7 @@
      <row xml:id="constant.mysql-both">
       <entry><constant>MYSQL_BOTH</constant></entry>
       <entry>
-       Las columnas son devueltas en un array que tiene tanto índice numérico como un índice con los nombres de los campos. 
+       Las columnas son devueltas en un array que tiene tanto índice numérico como un índice con los nombres de los campos.
       </entry>
      </row>
      <row xml:id="constant.mysql-num">

diff --git a/reference/mysql/functions/mysql-connect.xml b/reference/mysql/functions/mysql-connect.xml
@@ -1,13 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 8b5940cadeb4f1c8492f4a7f70743a2be807cf39 Maintainer: jesus_cova  Status: ready -->
+<!-- EN-Revision: 554db5a3a3ac77910d68349eefa37e2c9a9da628 Maintainer: jesus_cova  Status: ready -->
 <!-- Reviewed: yes Maintainer: seros -->
 <refentry xml:id="function.mysql-connect"  xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysql_connect</refname>
   <refpurpose>Abre una conexión al servidor MySQL</refpurpose>
  </refnamediv>
- 
+
  <refsynopsisdiv>
   <warning>
    &mysql.alternative.note;
@@ -17,22 +16,22 @@
    </simplelist>
   </warning>
  </refsynopsisdiv>
- 
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>resource</type><methodname>mysql_connect</methodname>
+   <type class="union"><type>resource</type><type>false</type></type><methodname>mysql_connect</methodname>
    <methodparam  choice="opt"><type>string</type><parameter>server</parameter><initializer>ini_get("mysql.default_host")</initializer></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysql.default_user")</initializer></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysql.default_password")</initializer></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>new_link</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>new_link</parameter><initializer>&false;</initializer></methodparam>
    <methodparam  choice="opt"><type>int</type><parameter>client_flags</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    Abre o reutiliza una conexión a un servidor MySQL.
   </para>
  </refsect1>
- 
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -41,7 +40,7 @@
      <term><parameter>server</parameter></term>
      <listitem>
       <para>
-       El servidor MySQL. También se puede incluir un número de puerto. P.ej.  
+       El servidor MySQL. También se puede incluir un número de puerto. P.ej.
        "nombre_anfitrión:puerto" o una ruta a un socket local, p.ej. ":/ruta/al/socket" para
        el servidor local.
       </para>
@@ -73,7 +72,7 @@
        &sqlsafemode;, éste parámetro es ignorado y se usa la contraseña vacía.
       </para>
      </listitem>
-    </varlistentry>   
+    </varlistentry>
     <varlistentry>
      <term><parameter>new_link</parameter></term>
      <listitem>
@@ -108,39 +107,14 @@
    </variablelist>
   </para>
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Devuelve un identificador de enlace de MySQL en caso de éxito &return.falseforfailure;.
   </para>
  </refsect1>
-
- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>5.5.0</entry>
-       <entry>
-        Esta función generará un error de nivel
-        <constant>E_DEPRECATED</constant>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -216,7 +190,7 @@ mysql_close($enlace);
    </example>
   </para>
  </refsect1>
- 
+
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
@@ -240,7 +214,7 @@ mysql_close($enlace);
   </note>
   <note>
    <para>
-    Se pPuede suprimir el mensaje de error en caso de fallo anteponiendo  
+    Se pPuede suprimir el mensaje de error en caso de fallo anteponiendo
     un <link linkend="language.operators.errorcontrol">@</link>
     al nombre de la función.
    </para>
@@ -255,7 +229,7 @@ mysql_close($enlace);
    </para>
   </note>
  </refsect1>
- 
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>