Can you please activate this account? ---------- Forwarded message ---------- From: Yago Ferrer <y...@php.net> Date: 2010/4/19 Subject: Re: [PHP-DOC] SVN Account Request: jesus_cova To: Jesús Rafael Cova Huerta <linkinparknirvana1...@gmail.com> Cc: phpdoc@lists.php.net, Philip Olson <phi...@roshambo.org>
Hi, I talked with Jesús Cova and he wants to keep translating files. Please find attached some of the files he translated. Thanks! 2010/4/18 Jesús Rafael Cova Huerta <linkinparknirvana1...@gmail.com> I would like to have an SVN account to help with the Spanish translation of > the PHP Manual. I'm coming part from user yago. > -- Yago Ferrer -- Yago Ferrer
<?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 297028 $ --> <!-- EN-Revision: 297028 Maintainer: jesus_cova Status: ready --> <refentry xml:id="function.mysql-affected-rows" xmlns="http://docbook.org/ns/docbook";> <refnamediv> <refname>mysql_affected_rows</refname> <refpurpose>Obtiene el número de filas afectadas en la anterior operación de MySQL</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>mysql_affected_rows</methodname> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> Obtiene el número de filas afectadas por la última consulta INSERT, UPDATE, REPLACE o DELETE asociada con <parameter>link_identifier</parameter>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> &mysql.linkid.description; </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Devuelve el número de filas afectadas en caso de éxito, y -1 si la última consulta fallo. </para> <para> Si la consulta anterior fue DELETE con ninguna clausula WHERE, todos los registros han sido borrados de la tabla pero ésta función devolverá cero con una versión anterior a MySQL 4.1.2. </para> <para> Al utilizar UPDATE, MySQL no va a actualizar las columnas donde el nuevo valor es el mismo que el anterior. Esto crea la posibilidad que <function>mysql_affected_rows</function> no pueda equivaler en realidad al número de filas encontradas, solamente el número de filas que estuvo literalmente afectada por la consulta. </para> <para> La declaración REPLACE primero borra el registro con la misma clave primaria y luego inserta el nuevo registro. Esta función devuelve el número de registros borrados mas el número de registros insertados. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Ejemplo de <function>mysql_affected_rows</function></title> <programlisting role="php"> <![CDATA[ <?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectar: ' . mysql_error()); } mysql_select_db('mydb'); /* Debería devolver el número correcto de registros borrados */ mysql_query('DELETE FROM mytable WHERE id < 10'); printf("Registros borrados: %d\n", mysql_affected_rows()); /* con una clausula WHERE que nunca es verdad, debería devolver 0 */ mysql_query('DELETE FROM mytable WHERE 0'); printf("Registros borrados: %d\n", mysql_affected_rows()); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Registros borrados: 10 Registros borrados: 0 ]]> </screen> </example> </para> <para> <example> <title>Ejemplo de <function>mysql_affected_rows</function> al utilizar transacciones</title> <programlisting role="php"> <![CDATA[ <?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectar: ' . mysql_error()); } mysql_select_db('mydb'); /* Actualizar registros */ mysql_query("UPDATE mytable SET used=1 WHERE id < 10"); printf ("Registros actualizados: %d\n", mysql_affected_rows()); mysql_query("COMMIT"); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Registros actualizados: 10 ]]> </screen> </example> </para> </refsect1> <refsect1 role="notes"> &reftitle.notes; <note> <title>Transacciones</title> <para> Si se usa transacciones, es necesario llamar <function>mysql_affected_rows</function> después de la consulta INSERT, UPDATE, o DELETE, no después del COMMIT. </para> </note> <note> <title>Declaraciones SELECT</title> <para> Para conocer el número de filas devueltas por un SELECT, se puede usar usar <function>mysql_num_rows</function>. </para> </note> <note> <title>Cascada de Claves Foráneas</title> <para> <function>mysql_affected_rows</function> no cuenta la filas afectadas implícitamente aunque a través del uso de ON DELETE CASCADE and/or ON UPDATE CASCADE en las restricciones de las claves foráneas. </para> </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mysql_num_rows</function></member> <member><function>mysql_info</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 -->
<?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 297028 $ --> <!-- EN-Revision: 297028 Maintainer: jesus_cova Status: ready --> <refentry xml:id="function.mysql-client-encoding" xmlns="http://docbook.org/ns/docbook";> <refnamediv> <refname>mysql_client_encoding</refname> <refpurpose>Devuelve el nombre de la colección de caracteres</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>mysql_client_encoding</methodname> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> Recupera la variable <literal>character_set</literal> de MySQL. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> &mysql.linkid.description; </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Devuelve el nombre por defecto de la colección de caracteres para la actual conexión. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Ejemplo de <function>mysql_client_encoding</function></title> <programlisting role="php"> <![CDATA[ <?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); $charset = mysql_client_encoding($link); echo "La actual conexión de caracteres es: $charset\n"; ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ La actual conexión de caracteres es: latin1 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mysql_set_charset</function></member> <member><function>mysql_real_escape_string</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 -->
<?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 297028 $ --> <!-- EN-Revision: 297028 Maintainer: jesus_cova Status: ready --> <refentry xml:id="function.mysql-close" xmlns="http://docbook.org/ns/docbook";> <refnamediv> <refname>mysql_close</refname> <refpurpose>Cierra la conexión de MySQL</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>mysql_close</methodname> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> <function>mysql_close</function> cierra la conexión no continua al servidor de MySQL que es asociada con el identificador de enlace especificado. Si <parameter>link_identifier</parameter> no es especificado, el último enlace abierto es usado. </para> <para> Frecuentemente no es necesario usar a <function>mysql_close</function>, como enlaces abiertos no continuos son automáticamente cerrados al final de la ejecución de el script. Ver también <link linkend="language.types.resource.self-destruct">liberando recursos</link>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> &mysql.linkid.description; </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Ejemplo de <function>mysql_close</function></title> <programlisting role="php"> <![CDATA[ <?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectar: ' . mysql_error()); } echo 'Conectado satisfactoriamente'; mysql_close($link); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Conectado satisfactoriamente ]]> </screen> </example> </para> </refsect1> <refsect1 role="notes"> &reftitle.notes; <note> <para> <function>mysql_close</function> no va a cerrar los enlaces continuos creados por <function>mysql_pconnect</function>. </para> </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mysql_connect</function></member> <member><function>mysql_free_result</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 -->
<?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 298136 $ --> <!-- EN-Revision: 298136 Maintainer: jesus_cova Status: ready --> <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> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</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>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> <variablelist> <varlistentry> <term><parameter>server</parameter></term> <listitem> <para> El servidor MySQL. También se puede incluir un número de puerto. Ej. "nombredehost:puerto" o una ruta a una toma local ejemplo ":/ruta/ala/toma" para el servidor local. </para> <para> Si la directiva PHP <link linkend="ini.mysql.default-host"> mysql.default_host</link> no está definida (por defecto), el valor por defecto es 'localhost:3306'. En &sqlsafemode;, éste parámetro es ignorado y el valor 'localhost:3306' es siempre usado. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>username</parameter></term> <listitem> <para> El nombre de usuario. El valor por defecto es definido por <link linkend="ini.mysql.default-user">mysql.default_user</link>. En &sqlsafemode;, éste parámetro es ignorado y el nombre de usuario que posee el proceso del servidor es usado. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>password</parameter></term> <listitem> <para> La contraseña. El valor por defecto es definido por <link linkend="ini.mysql.default-password">mysql.default_password</link>. En &sqlsafemode;, éste parámetro es ignorado y la contraseña vacía es usada. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>new_link</parameter></term> <listitem> <para> Si se realiza una segunda llamada <function>mysql_connect</function> con los mismos argumentos, un nuevo enlace no será establecido, en lugar, el identificador de enlace del enlace ya abierto será devuelto. El parámetro <parameter>new_link</parameter> modifica éste comportamiento y crea <function>mysql_connect</function> siempre un nuevo enlace abierto, aun si <function>mysql_connect</function> fue llamada antes con los mismos parámetros. En &sqlsafemode;, éste parámetro es ignorado. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>client_flags</parameter></term> <listitem> <para> El parámetro <parameter>client_flags</parameter> puede ser una combinación de las siguientes constantes: 128 (permiten <literal>LOAD DATA LOCAL</literal> manejo), <constant>MYSQL_CLIENT_SSL</constant>, <constant>MYSQL_CLIENT_COMPRESS</constant>, <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> o <constant>MYSQL_CLIENT_INTERACTIVE</constant>. Lea la sección acerca de <xref linkend="mysql.client-flags" /> para más información. En &sqlsafemode;, éste parámetro es ignorado. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Devuelve un identificador de enlace a 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>4.3.0</entry> <entry> Añadido el parámetro <parameter>client_flags</parameter>. </entry> </row> <row> <entry>4.2.0</entry> <entry> Añadido el parámetro <parameter>new_link</parameter>. </entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Ejemplo de <function>mysql_connect</function></title> <programlisting role="php"> <![CDATA[ <?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectarse: ' . mysql_error()); } echo 'Conectado satisfactoriamente'; mysql_close($link); ?> ]]> </programlisting> </example> </para> <para> <example> <title>Ejemplo usando la sintaxis <literal>hostname:port</literal> de <function>mysql_connect</function></title> <programlisting role="php"> <![CDATA[ <?php // nos conectamos a example.com y al puerto 3307 $link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectarse: ' . mysql_error()); } echo 'Conectado satisfactoriamente'; mysql_close($link); // nos conectamos a example.com y al puerto 3307 $link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectarse: ' . mysql_error()); } echo 'Conectado satisfactoriamente'; mysql_close($link); ?> ]]> </programlisting> </example> </para> <para> <example> <title><function>mysql_connect</function>ejemplo usando la sintaxis ":/path/to/socket"</title> <programlisting role="php"> <![CDATA[ <?php // nos conectamos a localhost y a la toma ej. /tmp/mysql.sock // variante 1: omitir el localhost $link = mysql_connect(':/tmp/mysql', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectarse: ' . mysql_error()); } echo 'Conectado satisfactoriamente'; mysql_close($link); // variante 2: con localhost $link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password'); if (!$link) { die('No pudo conectarse: ' . mysql_error()); } echo 'Conectado satisfactoriamente'; mysql_close($link); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="notes"> &reftitle.notes; <note> <para> Siempre que se especifique a "localhost" o "localhost:port" como servidor, la biblioteca de MySQL del cliente invalidara esto y intentara conectarse a una toma local (llamada tubería en Windows). Si tu quieres usar TCP/IP, usa "127.0.0.1" en lugar de "localhost". Si la biblioteca de MySQL del cliente intenta conectar a una incorrecta toma local, deberías colocar una ruta correcta como <xref linkend="ini.mysql.default-host" /> en tu configuración de PHP y dejando el campo del servidor en blanco. </para> </note> <note> <para> El enlace al servidor se cerrara tan pronto finalice la ejecución del script, a menos que se cierre antes por una llamada explicita a <function>mysql_close</function>. </para> </note> <note> <para> Se Puede suprimir los mensajes de error en caso de fallo anteponiendo un <link linkend="language.operators.errorcontrol">@</link> a la función del nombre. </para> </note> <note> <para> El error "Can't create TCP/IP socket (10106)" usualmente significa que la <link linkend="ini.variables-order">variables_order</link> configuración directiva no contiene carácter <literal>E</literal>. En Windows, si el ambiente no es copiado la variable <literal>SYSTEMROOT</literal> de ambiente no va a estar disponible y el PHP tendrá problemas de carga con la toma de Windows. </para> </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mysql_pconnect</function></member> <member><function>mysql_close</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 -->
<?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 297028 $ --> <!-- EN-Revision: 297028 Maintainer: jesus_cova Status: ready --> <refentry xml:id="function.mysql-errno" xmlns="http://docbook.org/ns/docbook"; xmlns:xlink="http://www.w3.org/1999/xlink";> <refnamediv> <refname>mysql_errno</refname> <refpurpose>Devuelve un mensaje de error con un valor numérico de la operación anterior con MySQL</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>mysql_errno</methodname> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> Devuelve un error numérico de la última función de MySQL. </para> <para> Los errores que vienen del proceso final de la base de datos ya no emiten peligros. A su vez, utilizan <function>mysql_errno</function> para recuperar el código con error. Nótese que ésta función solamente devolverá el código con error de la mas reciente función ejecutada de MySQL (sin incluir a <function>mysql_error</function> y <function>mysql_errno</function>), asi que si se quiere usar, hay que asegurarse de revisar el valor antes de llamar otra función de MySQL. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> &mysql.linkid.description; </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Devuelve un error numérico de la última función de MySQL, o <literal>0</literal> (cero) si no ha ocurrido un error. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Ejemplo de<function>mysql_errno</function></title> <programlisting role="php"> <![CDATA[ <?php $link = mysql_connect("localhost", "mysql_user", "mysql_password"); if (!mysql_select_db("nonexistentdb", $link)) { echo mysql_errno($link) . ": " . mysql_error($link). "\n"; } mysql_select_db("kossu", $link); if (!mysql_query("SELECT * FROM nonexistenttable", $link)) { echo mysql_errno($link) . ": " . mysql_error($link) . "\n"; } ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ 1049: Unknown database 'nonexistentdb' 1146: Table 'kossu.nonexistenttable' doesn't exist ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mysql_error</function></member> <member><link xlink:href="&url.mysql.docs.error;">MySQL error codes</link></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 --> â
