LMPX.COM |
Home | Linux | Mysql | PHP | XML | ||
|
|
|||
From: Leonardo Boshell Date: Mon Jul 21 15:59:06 2008 Subject: 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.xml
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
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ú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 <link
- linkend="language.variables.external">recuperar variables desde el
- exterior de PHP</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.
+ 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>
- ¿Qué codificación/decodificación
- necesito al pasar un valor a travé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ó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ó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 í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á 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.
+ 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á los sí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á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.
+ 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á imitando una peticiá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á 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
+ 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á que el caracter <literal>&</literal> en la
- URL es reemplazado por <literal>&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
+ Notará que el caracter <literal>&</literal> en la URL es
+ reemplazado por <literal>&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 <input type="image">, pero las
- 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?
+ 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ía un formulario, es posible usar una imagen
- en lugar del botón de envío está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ñ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 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ó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>¿Cómo creo matrices en un <form>
- HTML?</para>
+ <para>¿Cómo creo matrices en un <form> HTML?</para>
</question>
<answer>
<para>
- Para hacer que el resultado de <form> sea enviado como un
- valor <link linkend="language.types.array">array</link> a su
- script PHP, se deben nombrar los elementos <input>,
- <select> o <textarea> de esta forma:
+ Para hacer que el resultado de <form> sea enviado como un valor
+ <link linkend="language.types.array">array</link> a su script PHP, se
+ deben nombrar los elementos <input>, <select> o
+ <textarea> de esta forma:
<programlisting role="html">
<![CDATA[
<input name="MiMatriz[]" />
@@ -210,10 +194,10 @@
<input name="MiMatriz[]" />
]]>
</programlisting>
- 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:
+ 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én es posible asignar claves
- especí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á 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á 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é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>
- ¿Cómo obtengo todos los resultados de una etiqueta
- de selección mú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ó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,
+ 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ón elegida llegará al gestor de
- acción como:
+ Cada opción elegida llegará al gestor de acción como:
<programlisting>
var=opcion1
var=opcion2
var=opcion3
</programlisting>
- 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:
+ 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ó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.
+ 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á 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é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:
+ 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>
- ¿Có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í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.
+ 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ó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.
+ 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ó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ón
- específica de Apache que obtiene y define valores en la
- tabla <literal>notes</literal> de una petició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ó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ón actual.
+ Recupera todas las cabeceras HTTP de la petición actual.
</para>
<para>
- 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.
+ 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ó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ásicamente,
- fue renombrada. Esto se debe a que esta funció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;
¬e.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ó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ón
- específica de Apache que es similar a
- <literal><!--#include virtual...--></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.
+ <function>virtual</function> es una función específica de Apache que es
+ similar a <literal><!--#include virtual...--></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ón, todos los búferes son
- terminados y volcados al navegador, y las cabeceras pendientes son
- enviadas tambié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á 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 é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ó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ó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.
+ 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á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>
¬e.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
| Navigate in group php.doc.es at sever news.php.net | |
| Previous | Next |
| © No Copyright You are free to use Anything |
Site Maintained by PHP Developer
Powered By PHP Consultants |