cvs: phpdoc-es / extensions.ent /faq general.xml html.xml /language operators.xml variables.xml /language/context socket.xml /reference/apache/functions apache-note.xml getallheaders.xml virtual.x Reply

Group: php.doc.es

Subscribe

Posted:7/21/2008 9:59:06 PM

Replies:0

Views:16

Items(0)

--lboshell1216677546 Content-Type: text/plain lboshell Mon Jul 21 21:59:06 2008 UTC Modified files: /phpdoc-es extensions.ent /phpdoc-es/faq general.xml html.xml /phpdoc-es/language operators.xml variables.xml /phpdoc-es/language/context socket.xml /phpdoc-es/reference/apache/functions apache-note.xml getallheaders.xml virtual.xml Log: Actualizaciones --lboshell1216677546 Content-Type: text/plain Content-Disposition: attachment; filename="lboshell-20080721215906.txt" http://cvs.php.net/viewvc.cgi/phpdoc-es/extensions.ent?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-es/extensions.ent diff -u phpdoc-es/extensions.ent:1.3 phpdoc-es/extensions.ent:1.4 --- phpdoc-es/extensions.ent:1.3 Thu Jun 5 22:55:16 2008 +++ phpdoc-es/extensions.ent Mon Jul 21 21:59:05 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: lboshell Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: lboshell Status: ready --> <!-- Entities for the categorized extension list, so it does not need @@ -11,6 +11,8 @@ Extensiones</title><para>Este apéndice categoriza más de 150 extensiones documentadas en el manual de PHP, de acuerdo a varios criterios.</para>'> +<!ENTITY extcat.alphabetical '<title>Alfabética</title>'> + <!-- ======================================================================= --> <!ENTITY extcat.purpose '<title>Propósito</title>'> http://cvs.php.net/viewvc.cgi/phpdoc-es/faq/general.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-es/faq/general.xml diff -u phpdoc-es/faq/general.xml:1.5 phpdoc-es/faq/general.xml:1.6 --- phpdoc-es/faq/general.xml:1.5 Thu Jun 12 04:15:32 2008 +++ phpdoc-es/faq/general.xml Mon Jul 21 21:59:05 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.25 Maintainer: lboshell Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.27 Maintainer: lboshell Status: ready --> <chapter xml:id="faq.general" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Información General</title> <titleabbrev>Información General</titleabbrev> @@ -39,10 +39,11 @@ (PHP: Pre-procesador de Hipertexto). Esto confunde a muchas personas ya que la primera palabra del acrónimo es el acrónimo mismo. Este tipo de acrónimo es llamado - recursivo. Los curiosos pueden visitar el <link + recursivo. Para más información, los curiosos pueden visitar el <link xlink:href="&url.foldoc;">Diccionario En-Línea Gratuito de la - Computación</link> para más información - sobre los acrónimos recursivos. + Computación</link> o la <link + xlink:href="&url.wiki.recursive-acronym;">entrada en Wikipedia sobre + acrónimos recursivos</link>. </para> </answer> </qandaentry> @@ -54,10 +55,10 @@ <answer> <para> PHP/FI 2.0 es una versión temprana de PHP y ya no es soportada. PHP 3 - es el sucesor de PHP/FI 2.0 y es mucho más agradable. PHP 4 es la + es el sucesor de PHP/FI 2.0 y es mucho más agradable. PHP 5 es la generación actual de PHP, la cual usa internamente el <link - xlink:href="&url.zend;">motor Zend</link>. PHP 5 usa el motor Zend 2 el - cual, entre otras cosas, ofrece muchas características de <link + xlink:href="&url.zend;">motor Zend 2</link>, el cual, entre otras + cosas, ofrece muchas características de <link linkend="language.oop5">Programación Orientada a Objetos</link> adicionales. </para> @@ -120,6 +121,51 @@ </answer> </qandaentry> + <qandaentry xml:id="faq.general.differences-45"> + <question> + <para>¿Cuáles son las diferencias entre PHP 4 y PHP 5?</para> + </question> + <answer> + <para> + Mientras PHP 5 fue diseñado intencionalmente para ser tan compatible + como fuera posible con versiones anteriores, existen algunos cambios + significativos. Algunos de estos cambios incluyen: + <itemizedlist> + <listitem> + <simpara>Un <link linkend="language.oop5">nuevo modelo de POO</link> + basado en el <emphasis>Motor Zend 2.0</emphasis></simpara> + </listitem> + <listitem> + <simpara>Una nueva extensión para soporte mejorado de MySQL</simpara> + </listitem> + <listitem> + <simpara>Soporte nativo incorporado para SQLite</simpara> + </listitem> + <listitem> + <simpara> + Una nueva constante de reporte de errores, <link + xlink:href="&url.php.migrating5-errorrep;">E_STRICT</link>, para + sugerencias sobre el código en tiempo de ejecución + </simpara> + </listitem> + <listitem> + <simpara> + Un grupo de nuevas <link + xlink:href="&url.php.migrating5-functions;">funciones</link> para + simplificar la creación de código (y reducir la necesidad de crear + sus propias funciones para muchos procedimientos comunes) + </simpara> + </listitem> + </itemizedlist> + Para más información detallada, por favor vea la sección sobre <link + xlink:href="&url.php.migrate-45;">Migración desde PHP 4 a PHP 5</link> + y la sección sobre <link + xlink:href="&url.php.backwards-incompatible;">Cambios Incompatibles + con Versiones Anteriores</link>. + </para> + </answer> + </qandaentry> + <qandaentry xml:id="faq.general.bug"> <question> <para> http://cvs.php.net/viewvc.cgi/phpdoc-es/faq/html.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-es/faq/html.xml diff -u phpdoc-es/faq/html.xml:1.3 phpdoc-es/faq/html.xml:1.4 --- phpdoc-es/faq/html.xml:1.3 Sat Jun 23 13:25:25 2007 +++ phpdoc-es/faq/html.xml Mon Jul 21 21:59:05 2008 @@ -1,52 +1,48 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.30 Maintainer: lboshell Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.31 Maintainer: lboshell Status: ready --> <chapter xml:id="faq.html" xmlns="http://docbook.org/ns/docbook"> <title>PHP y HTML</title> <titleabbrev>PHP y HTML</titleabbrev> <para> - PHP y HTML interact&uacute;an bastante: PHP puede generar HTML, y - HTML puede pasar informaci&oacute;n a PHP. Antes de leer estas - preguntas, es importante que aprenda c&oacute;mo <link - linkend="language.variables.external">recuperar variables desde el - exterior de PHP</link>. La p&aacute;gina del manual sobre este tema - incluye bastantes ejemplos tambi&eacute;n. Preste atenci&oacute;n - especialmente a lo que <literal>register_globals</literal> - representa para usted. + PHP y HTML interactúan bastante: PHP puede generar HTML, y HTML puede + pasar información a PHP. Antes de leer estas preguntas, es importante que + aprenda cómo recuperar <link + linkend="language.variables.external">variables desde fuentes + externas</link>. La página del manual sobre este tema incluye bastantes + ejemplos también. Preste atención especialmente a lo que + <literal>register_globals</literal> representa para usted. </para> <qandaset> <qandaentry xml:id="faq.html.encoding"> <question> <para> - &iquest;Qu&eacute; codificaci&oacute;n/decodificaci&oacute;n - necesito al pasar un valor a trav&eacute;s de un formulario/URL? + ¿Qué codificación/decodificación necesito al pasar un valor a través + de un formulario/URL? </para> </question> <answer> <para> - Existen varias etapas en las que la codificaci&oacute;n es - importante. Asumiendo que tiene un valor tipo - <type>string</type> <varname>$datos</varname>, que contiene la - cadena que desea pasar sin codificar, estas son las etapas - relevantes: + Existen varias etapas en las que la codificación es importante. + Asumiendo que tiene un valor tipo <type>string</type> + <varname>$datos</varname>, que contiene la cadena que desea pasar sin + codificar, estas son las etapas relevantes: <itemizedlist> <listitem> <para> - Interpretaci&oacute;n de HTML. Para especificar una cadena - cualquiera, es <emphasis>necesario</emphasis> incluirla en - comillas dobles, y aplicar - <function>htmlspecialchars</function> sobre el valor + Interpretación de HTML. Para especificar una cadena cualquiera, es + <emphasis>necesario</emphasis> incluirla en comillas dobles, y + aplicar <function>htmlspecialchars</function> sobre el valor completo. </para> </listitem> <listitem> <para> - URL: Una URL consiste de varias partes. Si desea que sus - datos sean interpretados como un &iacute;tem, es - <emphasis>necesario</emphasis> codificarla con - <function>urlencode</function>. + URL: Una URL consiste de varias partes. Si desea que sus datos sean + interpretados como un ítem, es <emphasis>necesario</emphasis> + codificarla con <function>urlencode</function>. </para> </listitem> </itemizedlist> @@ -66,12 +62,11 @@ <simpara> No es correcto aplicar <function>urlencode</function> sobre <varname>$datos</varname>, ya que es responsabilidad de los - navegadores codificar los datos. Todos los navegadores - populares lo hacen correctamente. Note que esto - ocurrir&aacute; independientemente del m&eacute;todo (es - decir, GET o POST). Sin embargo, solo notar&aacute; esto en el - caso de una petici&oacute;n GET, ya que las peticiones POST - usualmente son escondidas. + navegadores codificar los datos. Todos los navegadores populares lo + hacen correctamente. Note que esto ocurrirá independientemente del + método (es decir, GET o POST). Sin embargo, solo notará esto en el + caso de una petición GET, ya que las peticiones POST usualmente son + escondidas. </simpara> </note> <example> @@ -88,18 +83,15 @@ </example> <note> <simpara> - Los datos son mostrados en el navegador como es de esperarse, - ya que el navegador interpretar&aacute; los s&iacute;mbolos - HTML escapados. + Los datos son mostrados en el navegador como es de esperarse, ya que + el navegador interpretará los símbolos HTML escapados. </simpara> <simpara> - Luego de ser enviados, ya sea por GET o POST, los datos - ser&aacute;s codificados por el navegador para su - transferencia, y ser&aacute;n decodificados directamente por - PHP. As&iacute; que en lo que a usted concierne, no - necesitar&aacute; realizar ninguna - codificaci&oacute;n/decodificaci&oacute;n, todo es manejado - autom&aacute;ticamente. + Luego de ser enviados, ya sea por GET o POST, los datos serás + codificados por el navegador para su transferencia, y serán + decodificados directamente por PHP. Así que en lo que a usted + concierne, no necesitará realizar ninguna + codificación/decodificación, todo es manejado automáticamente. </simpara> </note> <example> @@ -115,27 +107,25 @@ </example> <note> <simpara> - En realidad est&aacute; imitando una petici&aacute;n HTML GET, - por lo tanto no es necesario aplicar - <function>urlencode</function> manualmente a los datos. + En realidad está imitando una peticián HTML GET, por lo tanto no es + necesario aplicar <function>urlencode</function> manualmente a los + datos. </simpara> </note> <note> <simpara> - Es necesario usar <function>htmlspecialchars</function> sobre - la URL completa, ya que la URL ocurre como el valor de un - atributo HTML. En este caso, el navegador primero - reemplazar&aacute; las entidades HTML especiales por los - caracteres correctos en el valor, y luego pasa la URL. PHP - entender&aacute; la URL correctamente, ya que ya usado + Es necesario usar <function>htmlspecialchars</function> sobre la URL + completa, ya que la URL ocurre como el valor de un atributo HTML. En + este caso, el navegador primero reemplazará las entidades HTML + especiales por los caracteres correctos en el valor, y luego pasa la + URL. PHP entenderá la URL correctamente, ya que ya usado <function>urlencode</function> sobre los datos. </simpara> <simpara> - Notar&aacute; que el caracter <literal>&amp;</literal> en la - URL es reemplazado por <literal>&amp;amp;</literal>. Aunque la - mayor&iacute;a de navegadores entender&aacute;n el caracter si - olvida esto, no siempre es posible que ocurra. As&iacute; que - incluso si su URL no es din&aacute;mica, es + Notará que el caracter <literal>&amp;</literal> en la URL es + reemplazado por <literal>&amp;amp;</literal>. Aunque la mayoría de + navegadores entenderán el caracter si olvida esto, no siempre es + posible que ocurra. Así que incluso si su URL no es dinámica, es <emphasis>necesario</emphasis> usar <function>htmlspecialchars</function> sobre la URL. </simpara> @@ -149,42 +139,37 @@ <question> <para> Intento usar una etiqueta &lt;input type="image"&gt;, pero las - variables <varname>$foo.x</varname> y <varname>$foo.y</varname> - no est&aacute;n disponibles. <varname>$_GET['foo.x']</varname> - no existe tampoco. &iquest;D&oacute;nde est&aacute;n? + variables <varname>$foo.x</varname> y <varname>$foo.y</varname> no + están disponibles. <varname>$_GET['foo.x']</varname> no existe + tampoco. ¿Dónde están? </para> </question> <answer> <para> - Cuando se env&iacute;a un formulario, es posible usar una imagen - en lugar del bot&oacute;n de env&iacute;o est&aacute;ndar con - una etiqueta como esta: + Cuando se envía un formulario, es posible usar una imagen en lugar del + botón de envío estándar con una etiqueta como esta: <programlisting role="html"> <![CDATA[ <input type="image" src="imagen.gif" name="foo" /> ]]> </programlisting> - Cuando el usuario pulsa sobre la imagen, el formulario - acompa&ntilde;ante ser&aacute; transmitido al servidor con dos - variables adicionales: <varname>foo.x</varname> y - <varname>foo.y</varname>. - </para> - <para> - Dado que <varname>foo.x</varname> y <varname>foo.y</varname> - habr&iacute;an representado nombres de variable inv&aacute;lidos - en PHP, &eacute;stos son convertidos autom&aacute;ticamente a - <varname>foo_x</varname> y <varname>foo_y</varname>. Es decir, - los puntos son reemplazados con caracteres de - subrayado. As&iacute; que, es posible acceder a estas variables - como cualquier otra descrita en la secci&oacute;n sobre - recuperaci&oacute;n de <link - linkend="language.variables.external">variables desde el - exterior de PHP</link>. Por ejemplo, - <varname>$_GET['foo_x']</varname>. + Cuando el usuario pulsa sobre la imagen, el formulario acompañante + será transmitido al servidor con dos variables adicionales: + <varname>foo.x</varname> y <varname>foo.y</varname>. + </para> + <para> + Dado que <varname>foo.x</varname> y <varname>foo.y</varname> habrían + representado nombres de variable inválidos en PHP, éstos son + convertidos automáticamente a <varname>foo_x</varname> y + <varname>foo_y</varname>. Es decir, los puntos son reemplazados con + caracteres de subrayado. Así que, es posible acceder a estas variables + como cualquier otra descrita en la sección sobre recuperación de <link + linkend="language.variables.external">variables desde fuentes + externas</link>. Por ejemplo, <varname>$_GET['foo_x']</varname>. <note> <para> - Los espacios en nombres de variables de petici&oacute;n son - convertidos a caracteres de subrayado. + Los espacios en nombres de variables de petición son convertidos a + caracteres de subrayado. </para> </note> </para> @@ -193,15 +178,14 @@ <qandaentry xml:id="faq.html.arrays"> <question> - <para>&iquest;C&oacute;mo creo matrices en un &lt;form&gt; - HTML?</para> + <para>¿Cómo creo matrices en un &lt;form&gt; HTML?</para> </question> <answer> <para> - Para hacer que el resultado de &lt;form&gt; sea enviado como un - valor <link linkend="language.types.array">array</link> a su - script PHP, se deben nombrar los elementos &lt;input&gt;, - &lt;select&gt; o &lt;textarea&gt; de esta forma: + Para hacer que el resultado de &lt;form&gt; sea enviado como un valor + <link linkend="language.types.array">array</link> a su script PHP, se + deben nombrar los elementos &lt;input&gt;, &lt;select&gt; o + &lt;textarea&gt; de esta forma: <programlisting role="html"> <![CDATA[ <input name="MiMatriz[]" /> @@ -210,10 +194,10 @@ <input name="MiMatriz[]" /> ]]> </programlisting> - Note los par&eacute;ntesis cuadrados despu&eacute;s del nombre - de la variable, ellos son los que la convierten en una - matriz. Es posible agrupar los elementos en diferentes matrices - asignando el mismo nombre a elementos diferentes: + Note los paréntesis cuadrados después del nombre de la variable, ellos + son los que la convierten en una matriz. Es posible agrupar los + elementos en diferentes matrices asignando el mismo nombre a elementos + diferentes: <programlisting role="html"> <![CDATA[ <input name="MiMatriz[]" /> @@ -222,9 +206,9 @@ <input name="MiOtraMatriz[]" /> ]]> </programlisting> - Esto produce dos matrices, MiMatriz y MiOtraMatriz, que son - enviadas al script PHP. Tambi&eacute;n es posible asignar claves - espec&iacute;ficas a sus matrices: + Esto produce dos matrices, MiMatriz y MiOtraMatriz, que son enviadas + al script PHP. También es posible asignar claves específicas a sus + matrices: <programlisting role="html"> <![CDATA[ <input name="OtraMatriz[]" /> @@ -233,24 +217,22 @@ <input name="OtraMatriz[telefono]" /> ]]> </programlisting> - La matriz OtraMatriz ahora tendr&aacute; las claves 0, 1, email - y phone. + La matriz OtraMatriz ahora tendrá las claves 0, 1, email y phone. </para> <para> <note> <para> Especificar claves de matrices es opcional en HTML. Si no - especifica las claves, la matriz es llenada en el orden en - que aparecen los elementos en el formulario. Nuestro primer - ejemplo contendr&aacute; las claves 0, 1, 2 y 3. + especifica las claves, la matriz es llenada en el orden en que + aparecen los elementos en el formulario. Nuestro primer ejemplo + contendrá las claves 0, 1, 2 y 3. </para> </note> </para> <para> - Vea tambi&eacute;n <link linkend="ref.array">Funciones de - Matrices</link> y <link - linkend="language.variables.external">Variables desde el - exterior de PHP</link>. + Vea también <link linkend="ref.array">Funciones de Matrices</link> y + <link linkend="language.variables.external">Variables Desde Fuentes + Externas</link>. </para> </answer> </qandaentry> @@ -258,57 +240,51 @@ <qandaentry xml:id="faq.html.select-multiple"> <question> <para> - &iquest;C&oacute;mo obtengo todos los resultados de una etiqueta - de selecci&oacute;n m&uacute;ltiple en HTML? + ¿Cómo obtengo todos los resultados de una etiqueta de selección + múltiple en HTML? </para> </question> <answer> <para> - La etiquete de selecci&oacute;n m&uacute;ltiple en una - construcci&oacute;n HTML le permite a los usuarios elegir varios - &iacute;tems desde una lista. Estos &iacute;tems son pasados - entonces al gestor de acci&oacute;n del formulario. El problema - es que todos son pasados con el mismo nombre de control. Es - decir, + La etiqueta de selección múltiple en una construcción HTML le permite + a los usuarios elegir varios ítems desde una lista. Estos ítems son + pasados entonces al gestor de acción del formulario. El problema es + que todos son pasados con el mismo nombre de control. Es decir, <programlisting role="html"> <![CDATA[ <select name="var" multiple="yes"> ]]> </programlisting> - Cada opci&oacute;n elegida llegar&aacute; al gestor de - acci&oacute;n como: + Cada opción elegida llegará al gestor de acción como: <programlisting> var=opcion1 var=opcion2 var=opcion3 </programlisting> - Cada opci&oacute;n sobrescribir&aacute; los contenidos de la - variable <varname>$var</varname> previa. La soluci&oacute;n es - usar la caracter&iacute;stica de PHP "matriz desde un elemento - de formulario". Debe usarse la siguiente forma: + Cada opción sobrescribirá los contenidos de la variable + <varname>$var</varname> previa. La solución es usar la característica + de PHP "matriz desde un elemento de formulario". Debe usarse la + siguiente forma: <programlisting role="html"> <![CDATA[ <select name="var[]" multiple="yes"> ]]> </programlisting> - Esto le dice a PHP que debe tratar <varname>$var</varname> como - una matriz y cada asignaci&oacute;n de valor a var[] agrega un - &iacute;tem a la matriz. El primer elemento se convierte en - <varname>$var[0]</varname>, el siguiente - <varname>$var[1]</varname>, etc. La funci&oacute;n - <function>count</function> puede usarse para determinar - cu&aacute;ntas opciones fueron seleccionadas, y la - funci&oacute;n <function>sort</function> puede ser usada para - ordenar la matriz de opciones si es necesario. + Esto le dice a PHP que debe tratar <varname>$var</varname> como una + matriz y cada asignación de valor a var[] agrega un ítem a la matriz. + El primer elemento se convierte en <varname>$var[0]</varname>, el + siguiente <varname>$var[1]</varname>, etc. La función + <function>count</function> puede usarse para determinar cuántas + opciones fueron seleccionadas, y la función <function>sort</function> + puede ser usada para ordenar la matriz de opciones si es necesario. </para> <para> - Note que si est&aacute; usando JavaScript los caracteres + Note que si está usando JavaScript los caracteres <literal>[]</literal> en el nombre del elemento pueden causar - problemas cuando intente referirse al elemento por su - nombre. Use su ID num&eacute;rico de elemento de formulario en - su lugar, o encierre el nombre de variables en comillas - sencillas y &uacute;selo como &iacute;ndice de la matriz de - elementos, por ejemplo: + problemas cuando intente referirse al elemento por su nombre. Use su + ID numérico de elemento de formulario en su lugar, o encierre el + nombre de variables en comillas sencillas y úselo como índice de la + matriz de elementos, por ejemplo: <programlisting> variable = documents.forms[0].elements['var[]']; </programlisting> @@ -319,40 +295,36 @@ <qandaentry xml:id="faq.html.javascript-variable"> <question> <para> - &iquest;C&oacute;mo puedo pasar una variable de Javascript a - PHP? + ¿Cómo puedo pasar una variable de Javascript a PHP? </para> </question> <answer> <para> - Ya que Javascript es una tecnolog&iacute;a (usualmente) del lado - del cliente, y PHP es (usualmente) una tecnolog&iacute;a del - lado del servidor, y dado que HTTP es un protocolo "sin - estados", los dos lenguajes no pueden compartir variables - directamente. + Ya que Javascript es una tecnología (usualmente) del lado del cliente, + y PHP es (usualmente) una tecnología del lado del servidor, y dado que + HTTP es un protocolo "sin estados", los dos lenguajes no pueden + compartir variables directamente. </para> <para> - Sin embargo, es posible pasar variables entre los dos. Una forma - de hacerlo es generar c&oacute;digo Javascript con PHP, y hacer - que el navegador se refresque a s&iacute; mismo, pasando - variables espec&iacute;ficas de vuelta al script PHP. El ejemplo - a continuaci&oacute;n muestra precisamente c&oacute;mo hacer - esto -- permite que c&oacute;digo PHP capture la altura y el - ancho de la pantalla, algo que normalmente s&oacute;lo es - posible en el lado del cliente. + Sin embargo, es posible pasar variables entre los dos. Una forma de + hacerlo es generar código Javascript con PHP, y hacer que el navegador + se refresque a sí mismo, pasando variables específicas de vuelta al + script PHP. El ejemplo a continuación muestra precisamente cómo hacer + esto -- permite que código PHP capture la altura y el ancho de la + pantalla, algo que normalmente sólo es posible en el lado del cliente. </para> <para> <programlisting role="php"> <![CDATA[ <?php if (isset($_GET['ancho']) AND isset($_GET['altura'])) { - // imprimir las variables de geometria + // imprimir las variables de geometría echo "El ancho de la pantalla es: ". $_GET['ancho'] ."<br />\n"; echo "La altura de la pantalla es: ". $_GET['altura'] ."<br />\n"; } else { - // pasar las variables de geometria + // pasar las variables de geometría // (preservar la cadena query original - // -- las variables post deberan ser pasadas de otra forma) + // -- las variables post deberán ser pasadas de otra forma) echo "<script language='javascript'>\n"; echo " location.href=\"${_SERVER['SCRIPT_NAME']}?${_SERVER['QUERY_STRING']}" http://cvs.php.net/viewvc.cgi/phpdoc-es/language/operators.xml?r1=1.35&r2=1.36&diff_format=u Index: phpdoc-es/language/operators.xml diff -u phpdoc-es/language/operators.xml:1.35 phpdoc-es/language/operators.xml:1.36 --- phpdoc-es/language/operators.xml:1.35 Mon Jun 16 16:50:45 2008 +++ phpdoc-es/language/operators.xml Mon Jul 21 21:59:05 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.35 $ --> -<!-- EN-Revision: 1.125 Maintainer: lboshell Status: ready --> +<!-- $Revision: 1.36 $ --> +<!-- EN-Revision: 1.126 Maintainer: lboshell Status: ready --> <chapter xml:id="language.operators" xmlns="http://docbook.org/ns/docbook"> <title>Operadores</title> <simpara> @@ -58,9 +58,8 @@ <tbody> <row> <entry>no-asociativo</entry> - <entry>new</entry> - <entry><link - linkend="language.oop5.basic.new">new</link></entry> + <entry>clone new</entry> + <entry><link linkend="language.oop5.cloning">clone</link> y <link linkend="language.oop5.basic.new">new</link></entry> </row> <row> <entry>izquierda</entry> http://cvs.php.net/viewvc.cgi/phpdoc-es/language/variables.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-es/language/variables.xml diff -u phpdoc-es/language/variables.xml:1.15 phpdoc-es/language/variables.xml:1.16 --- phpdoc-es/language/variables.xml:1.15 Wed Jun 4 02:24:27 2008 +++ phpdoc-es/language/variables.xml Mon Jul 21 21:59:05 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.100 Maintainer: lboshell Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.101 Maintainer: lboshell Status: ready --> <chapter xml:id="language.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Variables</title> @@ -721,7 +721,7 @@ </sect1> <sect1 xml:id="language.variables.external"> - <title>Variables externas a PHP</title> + <title>Variables Desde Fuentes Externas</title> <sect2 xml:id="language.variables.external.form"> <title>Formularios HTML (GET y POST)</title> http://cvs.php.net/viewvc.cgi/phpdoc-es/language/context/socket.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-es/language/context/socket.xml diff -u phpdoc-es/language/context/socket.xml:1.1 phpdoc-es/language/context/socket.xml:1.2 --- phpdoc-es/language/context/socket.xml:1.1 Mon Jun 16 16:50:45 2008 +++ phpdoc-es/language/context/socket.xml Mon Jul 21 21:59:05 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: lboshell Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.4 Maintainer: lboshell Status: ready --> <refentry xml:id="context.socket" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" role="noversion"> <refnamediv> http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/apache/functions/apache-note.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-es/reference/apache/functions/apache-note.xml diff -u phpdoc-es/reference/apache/functions/apache-note.xml:1.4 phpdoc-es/reference/apache/functions/apache-note.xml:1.5 --- phpdoc-es/reference/apache/functions/apache-note.xml:1.4 Sat Jun 23 13:25:26 2007 +++ phpdoc-es/reference/apache/functions/apache-note.xml Mon Jul 21 21:59:05 2008 @@ -1,12 +1,11 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: lboshell Status: ready --> -<!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: lboshell Status: ready --> <refentry xml:id="function.apache-note" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>apache_note</refname> - <refpurpose>Obtener y establecer las notas de petici&oacute;n de - apache</refpurpose> + <refpurpose>Obtener y establecer las notas de petición de + apache</refpurpose> </refnamediv> <refsect1 role="description"> @@ -17,9 +16,15 @@ <methodparam choice="opt"><type>string</type><parameter>valor_nota</parameter></methodparam> </methodsynopsis> <para> - <function>apache_note</function> es una funci&oacute;n - espec&iacute;fica de Apache que obtiene y define valores en la - tabla <literal>notes</literal> de una petici&oacute;n. + Esta función es una envoltura para las instrucciones + <literal>table_get</literal> y + <literal>table_set</literal> de Apache. Edita las tablas de notas que + existen durante una petición. El propósito de la tabla es permitir la + comunicación entre módulos de Apache. + </para> + <para> + El principal uso para <function>apache_note</function> es el paso de + información desde un módulo a otro al interior de la misma petición. </para> </refsect1> @@ -51,14 +56,79 @@ &reftitle.returnvalues; <para> Si es llamada con un argumento, devuelve el valor actual de la nota - <literal>nombre_nota</literal>. Si es llamada con dos argumentos, - define el valor de la nota <literal>nombre_nota</literal> a + <literal>nombre_nota</literal>. Si es llamada con dos argumentos, define + el valor de la nota <literal>nombre_nota</literal> a <literal>valor_nota</literal> y devuelve el valor previo de la nota - <literal>nombre_nota</literal>. Si la nota no puede ser recuperada, - se devuelve &false;. + <literal>nombre_nota</literal>. Si la nota no puede ser recuperada, se + devuelve &false;. </para> </refsect1> - </refentry> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Paso de información entre PHP y Perl</title> + <programlisting role="php"> +<![CDATA[ +<?php + +apache_note('nombre', 'Fredrik Ekengren'); + +// Llamar script perl +virtual("/perl/algun_script.pl"); + +$resultado = apache_note("datos_resultado"); +?> +]]> + </programlisting> + <programlisting role="perl"> +<![CDATA[ +# Obtener el objeto de petición de Apache +my $r = Apache->request()->main(); + +# Obtener los datos pasados +my $nombre = $r->notes('nombre'); + +# aquí va el procesamiento + +# Pasar los resultados de vuelta a PHP +$r->notes('datos_resultado', $resultado); +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Registro de valores en access.log</title> + <programlisting role="php"> +<![CDATA[ +<?php + +apache_note('sessionID', session_id()); + +?> +]]> + </programlisting> + <programlisting role="apache"> +<![CDATA[ +# "%{sessionID}n" puede ser usado en la directiva LogFormat +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>virtual</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/apache/functions/getallheaders.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-es/reference/apache/functions/getallheaders.xml diff -u phpdoc-es/reference/apache/functions/getallheaders.xml:1.5 phpdoc-es/reference/apache/functions/getallheaders.xml:1.6 --- phpdoc-es/reference/apache/functions/getallheaders.xml:1.5 Sat Jun 23 13:25:26 2007 +++ phpdoc-es/reference/apache/functions/getallheaders.xml Mon Jul 21 21:59:05 2008 @@ -1,12 +1,11 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.11 Maintainer: lboshell Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.13 Maintainer: lboshell Status: ready --> <!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 --> <refentry xml:id="function.getallheaders" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>getallheaders</refname> - <refpurpose>Recuperar todas las cabeceras de petici&oacute;n - HTTP</refpurpose> + <refpurpose>Recuperar todas las cabeceras de petición HTTP</refpurpose> </refnamediv> <refsect1 role="description"> @@ -16,14 +15,13 @@ <void/> </methodsynopsis> <para> - Recupera todas las cabeceras HTTP de la petici&oacute;n actual. + Recupera todas las cabeceras HTTP de la petición actual. </para> <para> - Esta funci&oacute;n es un alias de - <function>apache_request_headers</function>. Por favor lea la - documentaci&oacute;n de <function>apache_request_headers</function> - para m&aacute;s informaci&oacute;n sobre c&oacute;mo trabaja esta - funci&oacute;n. + Esta función es un alias de <function>apache_request_headers</function>. + Por favor lea la documentación de + <function>apache_request_headers</function> para más información sobre + cómo trabaja esta función. </para> &apache.req.module; </refsect1> @@ -31,8 +29,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Una matriz asociativa de todas las cabeceras HTTP en la - petici&oacute;n actual, o &false; en caso de fallo. + Una matriz asociativa de todas las cabeceras HTTP en la petición actual, + o &false; en caso de fallo. </para> </refsect1> @@ -52,9 +50,8 @@ <entry>4.3.0</entry> <entry> Se convierte en un alias de - <function>apache_request_headers</function>. B&aacute;sicamente, - fue renombrada. Esto se debe a que esta funci&oacute;n solo - trabaja con Apache. + <function>apache_request_headers</function>. Básicamente, fue + renombrada. Esto se debe a que esta función solo trabaja con Apache. </entry> </row> </tbody> @@ -63,6 +60,26 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ejemplo de <function>getallheaders</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +foreach (getallheaders() as $nombre => $valor) { + echo "$nombre: $valor\n"; +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; &note.apache.nsapi-module; http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/apache/functions/virtual.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-es/reference/apache/functions/virtual.xml diff -u phpdoc-es/reference/apache/functions/virtual.xml:1.9 phpdoc-es/reference/apache/functions/virtual.xml:1.10 --- phpdoc-es/reference/apache/functions/virtual.xml:1.9 Sat Jun 23 13:25:26 2007 +++ phpdoc-es/reference/apache/functions/virtual.xml Mon Jul 21 21:59:05 2008 @@ -1,11 +1,11 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.15 Maintainer: lboshell Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.16 Maintainer: lboshell Status: ready --> <!-- splitted from ./en/functions/apache.xml, last change in rev 1.20 --> <refentry xml:id="function.virtual" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>virtual</refname> - <refpurpose>Realizar una sub-petici&oacute;n de Apache</refpurpose> + <refpurpose>Realizar una sub-petición de Apache</refpurpose> </refnamediv> <refsect1 role="description"> @@ -15,20 +15,17 @@ <methodparam><type>string</type><parameter>nombre_archivo</parameter></methodparam> </methodsynopsis> <para> - <function>virtual</function> es una funci&oacute;n - espec&iacute;fica de Apache que es similar a - <literal>&lt;!--#include virtual...--&gt;</literal> en - mod_include. Realiza una sub-petici&oacute;n de Apache. Es - &uacute;til para incluir scripts CGI o archivos .shtml, o cualquier - otra cosa que quisiera procesar a trav&eacute;s de Apache. Note que - para un script CGI, el script debe generar cabeceras CGI - v&aacute;lidas. Esto quiere decir que, por lo menos, debe generar - una cabecera Content-type. + <function>virtual</function> es una función específica de Apache que es + similar a <literal>&lt;!--#include virtual...--&gt;</literal> en + mod_include. Realiza una sub-petición de Apache. Es útil para incluir + scripts CGI o archivos .shtml, o cualquier otra cosa que quisiera + procesar a través de Apache. Note que para un script CGI, el script debe + generar cabeceras CGI válidas. Esto quiere decir que, por lo menos, debe + generar una cabecera Content-type. </para> <para> - Para ejecutar la sub-petici&oacute;n, todos los b&uacute;feres son - terminados y volcados al navegador, y las cabeceras pendientes son - enviadas tambi&eacute;n. + Para ejecutar la sub-petición, todos los búferes son terminados y + volcados al navegador, y las cabeceras pendientes son enviadas también. </para> &apache.req.module; </refsect1> @@ -41,7 +38,7 @@ <term><parameter>nombre_archivo</parameter></term> <listitem> <para> - El archivo sobre el que se efectuar&aacute; el comando virtual. + El archivo sobre el que se efectuará el comando virtual. </para> </listitem> </varlistentry> @@ -52,8 +49,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Ejecuta el comando virtual en caso de &eacute;xito, o devuelvo - &false; si ocurre un error. + Ejecuta el comando virtual en caso de éxito, o devuelve &false; si ocurre + un error. </para> </refsect1> @@ -72,9 +69,9 @@ <row> <entry>4.0.6</entry> <entry> - Esta funci&oacute;n puede ser usada sobre archivos PHP. Sin - embargo, usualmente es mejor usar <function>include</function> - o <function>require</function> para archivos PHP. + Esta función puede ser usada sobre archivos PHP. Sin embargo, + usualmente es mejor usar <function>include</function> o + <function>require</function> para archivos PHP. </entry> </row> </tbody> @@ -83,27 +80,43 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + Vea <function>apache_note</function> para un ejemplo. + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <warning> <para> - La cadena de petici&oacute;n puede ser pasada al archivo incluido - pero la variable <varname>$_GET</varname> es copiada desde el - script padre, y solo <varname>$_SERVER['QUERY_STRING']</varname> - se llena con la cadena de query pasada. Puede que la cadena query - s&oacute;lo pueda ser pasada cuando se usa Apache 2. El archivo - solicitado no ser&aacute; listado en el archivo de registro (log) - access de Apache. + La cadena de petición puede ser pasada al archivo incluido pero la + variable <varname>$_GET</varname> es copiada desde el script padre, y + solo <varname>$_SERVER['QUERY_STRING']</varname> se llena con la cadena + de query pasada. Puede que la cadena query sólo pueda ser pasada cuando + se usa Apache 2. El archivo solicitado no será listado en el archivo de + registro (log) access de Apache. </para> </warning> <note> <para> - Las variables de entorno definidas en el archivo solicitado no - est&aacute;n disponibles desde el script que hace el llamado. + Las variables de entorno definidas en el archivo solicitado no están + disponibles desde el script que hace el llamado. </para> </note> &note.apache.nsapi-module; </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>apache_note</function></member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file --lboshell1216677546--

lbosh...@php.net ("Leonardo Boshell") 7/21/2008 9:59:06 PM Header Report as Spam

Reply:

| or Email(not shown): Name: | Register | Login Alert me when someone responds to this posting.