diff options
Diffstat (limited to '')
| -rw-r--r-- | docs/manual/howto/cgi.html.es | 416 |
1 files changed, 210 insertions, 206 deletions
diff --git a/docs/manual/howto/cgi.html.es b/docs/manual/howto/cgi.html.es index 530adbb..a77eca4 100644 --- a/docs/manual/howto/cgi.html.es +++ b/docs/manual/howto/cgi.html.es @@ -7,7 +7,7 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -<title>Tutorial de Apache: Contenido Dinámico con CGI - Servidor HTTP Apache Versión 2.4</title> +<title>Tutorial de Apache: Contenido Dinámico con CGI - Servidor HTTP Apache Versión 2.4</title> <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> @@ -16,61 +16,65 @@ <link href="../images/favicon.ico" rel="shortcut icon" /></head> <body id="manual-page"><div id="page-header"> -<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p> -<p class="apache">Versión 2.4 del Servidor HTTP Apache</p> +<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p> +<p class="apache">Versión 2.4 del Servidor HTTP Apache</p> <img alt="" src="../images/feather.png" /></div> <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> <div id="path"> -<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial de Apache: Contenido Dinámico con CGI</h1> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial de Apache: Contenido Dinámico con CGI</h1> <div class="toplang"> <p><span>Idiomas disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/howto/cgi.html" title="Español"> es </a> | -<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../es/howto/cgi.html" title="Español"> es </a> | +<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> +<div class="outofdate">Esta traducción podría estar + obsoleta. Consulte la versión en inglés de la + documentación para comprobar si se han producido cambios + recientemente.</div> </div> -<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introducción</a></li> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introducción</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurando Apache para permitir CGI</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#writing">Escribiendo un programa CGI</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">¡Pero todavía no funciona!</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">¿Qué ocurre entre bastidores?</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#libraries">Módulos/librerías CGI</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Para más información</a></li> -</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div> +<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">¡Pero todavía no funciona!</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">¿Qué ocurre entre bastidores?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#libraries">Módulos/librerías CGI</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Para más información</a></li> +</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="intro" id="intro">Introducción</a></h2> +<h2><a name="intro" id="intro">Introducción</a></h2> - <table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table> + <table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table> - <p>CGI (Common Gateway Interface) es un método por el cual + <p>CGI (Common Gateway Interface) es un método por el cual un servidor web puede interactuar con programas externos de - generación de contenido, a ellos nos referimos comúnmente como - programas CGI o scripts CGI. Es el método más común y sencillo de - mostrar contenido dinámico en su sitio web. Este documento es una - introducción para configurar CGI en su servidor web Apache, y de - iniciación para escribir programas CGI.</p> + generación de contenido, a ellos nos referimos comúnmente como + programas CGI o scripts CGI. Es el método más común y sencillo de + mostrar contenido dinámico en su sitio web. Este documento es una + introducción para configurar CGI en su servidor web Apache, y de + iniciación para escribir programas CGI.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="configuring" id="configuring">Configurando Apache para permitir CGI</a></h2> <p>Para conseguir que sus programas CGI funcionen correctamente, - deberá configurar Apache para que permita la ejecución de CGI. Hay + deberá configurar Apache para que permita la ejecución de CGI. Hay distintas formas de hacerlo.</p> <div class="warning">Nota: Si Apache ha sido compilado con soporte - de módulos compartidos, necesitará que el módulo de CGI esté cargado; + de módulos compartidos, necesitará que el módulo de CGI esté cargado; en su <code>httpd.conf</code> tiene que asegurarse de que la directiva <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> - no ha sido comentada. Una directiva configurada correctamente sería así: + no ha sido comentada. Una directiva configurada correctamente sería así: <pre class="prettyprint lang-config">LoadModule cgid_module modules/mod_cgid.so</pre> En Windows, o si usa un mpm que no es multihilo, como prefork, una - directiva configurada correctamente podría definirse así: + directiva configurada correctamente podría definirse así: <pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre> </div> @@ -80,43 +84,43 @@ <p>La directiva <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> - indica a Apache que un directorio se ha configurado específicamente - para programas CGI. Apache asumirá que cada fichero en este - directorio es un programa CGI, e intentará ejecutarlos cuando un + indica a Apache que un directorio se ha configurado específicamente + para programas CGI. Apache asumirá que cada fichero en este + directorio es un programa CGI, e intentará ejecutarlos cuando un cliente solicita este recurso.</p> <p>La directiva <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> se puede - definir así:</p> + definir así:</p> <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"</pre> - <p>El ejemplo que se muestra es de un archivo de configuración - <code>httpd.conf</code> por defecto si usted instaló Apache - en la ubicación por defecto. La directiva + <p>El ejemplo que se muestra es de un archivo de configuración + <code>httpd.conf</code> por defecto si usted instaló Apache + en la ubicación por defecto. La directiva <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> es muy parecida a la directiva <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, - ésta define un prefijo de URL que se enlaza a un directorio + ésta define un prefijo de URL que se enlaza a un directorio en particular. <code class="directive">Alias</code> y <code class="directive">ScriptAlias</code> se usan generalmente para directorios que se encuentran fuera del directorio <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. La diferencia entre <code class="directive">Alias</code> y <code class="directive">ScriptAlias</code> es que en <code class="directive">ScriptAlias</code> cualquier elemento - debajo de ese prefijo de URL será considerado un programa CGI. Así, - el ejemplo de más arriba le indica a Apache que + debajo de ese prefijo de URL será considerado un programa CGI. Así, + el ejemplo de más arriba le indica a Apache que cualquier solicitud para un recurso que comience con - <code>/cgi-bin/</code> debería servirse desde el directorio - <code>/usr/local/apache2/cgi-bin/</code>, y debería tratarse como un + <code>/cgi-bin/</code> debería servirse desde el directorio + <code>/usr/local/apache2/cgi-bin/</code>, y debería tratarse como un programa CGI.</p> <p>Por ejemplo, si se solicita la URL <code>http://www.example.com/cgi-bin/test.pl</code>, - Apache intentará ejecutar el archivo + Apache intentará ejecutar el archivo <code>/usr/local/apache2/cgi-bin/test.pl</code> y dar el resultado. Por supuesto el archivo debe existir y ser ejecutable, - y dar el resultado de una manera específica o Apache devolverá + y dar el resultado de una manera específica o Apache devolverá un mensaje de error.</p> @@ -126,32 +130,32 @@ <p>Los programas CGI habitualmente se restringen a los directorios de <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> por razones de seguridad. De esta manera, los administradores pueden controlar de una - manera más segura quien puede ejecutar programas CGI. Aun así, si no - se toman suficientes precauciones, no hay ninguna razón por la que + manera más segura quien puede ejecutar programas CGI. Aun así, si no + se toman suficientes precauciones, no hay ninguna razón por la que programas CGI no se puedan ejecutar desde directorios seleccionados de - manera arbitraria. Por ejemplo, quizás quiera permitir que usuarios del + manera arbitraria. Por ejemplo, quizás quiera permitir que usuarios del sistema tengan contenido web en sus directorios home con la directiva <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Si quieren tener sus propios programas CGI, pero no tienen acceso al directorio - principal <code>cgi-bin</code>, necesitarán ser capaces de - ejecutar sus scripts CGI en algún otro sitio.</p> + principal <code>cgi-bin</code>, necesitarán ser capaces de + ejecutar sus scripts CGI en algún otro sitio.</p> - <p>Hay dos pasos a seguir para permitir la ejecución CGI en directorios + <p>Hay dos pasos a seguir para permitir la ejecución CGI en directorios seleccionados de manera arbitraria. Primero, el handler <code>cgi-script</code> debe estar activado usando la directiva <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> o la directiva - <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. Segundo, el parámetro + <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. Segundo, el parámetro <code>ExecCGI</code> debe estar definido en la directiva <code class="directive"><a href="../mod/core.html#options">Options</a></code>.</p> - <h3><a name="options" id="options">Usando Options de manera explícita para permitir ejecución de + <h3><a name="options" id="options">Usando Options de manera explícita para permitir ejecución de CGI</a></h3> <p>Puede usar la directiva <code class="directive"><a href="../mod/core.html#options">Options</a></code>, en el archivo de - configuración principal para especificar que se permite la ejecución + configuración principal para especificar que se permite la ejecución de CGI en un directorio en particular:</p> <pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/somedir"> @@ -159,11 +163,11 @@ </Directory></pre> - <p>Esta directiva de aquí arriba le indica a Apache que debe - permitir la ejecución de archivos CGI. También necesitará indicarle + <p>Esta directiva de aquí arriba le indica a Apache que debe + permitir la ejecución de archivos CGI. También necesitará indicarle al servidor que los archivos son archivos CGI. La directiva <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> le indica al - servidor que debe tratar a todos los archivos con la extensión + servidor que debe tratar a todos los archivos con la extensión <code>cgi</code> o <code>pl</code> como programas CGI:</p> <pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre> @@ -174,16 +178,16 @@ <p>El <a href="htaccess.html">tutorial <code>.htaccess</code></a> - enseña como activar programas CGI si no tienes acceso a + enseña como activar programas CGI si no tienes acceso a <code>httpd.conf</code>.</p> <h3><a name="userdir" id="userdir">Directorios de Usuario</a></h3> - <p>Para permitir la ejecución de programas CGI para cualquier + <p>Para permitir la ejecución de programas CGI para cualquier archivo que acabe en <code>.cgi</code> en directorios de usuario, - puedes usar la siguiente configuración:</p> + puedes usar la siguiente configuración:</p> <pre class="prettyprint lang-config"><Directory "/home/*/public_html"> Options +ExecCGI @@ -192,7 +196,7 @@ <p>Si quiere designar un subdirectorio <code>cgi-bin</code> dentro - de un directorio de usuario en el que todos los ficheros serán + de un directorio de usuario en el que todos los ficheros serán tratados como un programa CGI, puede usar lo siguiente:</p> <pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin"> @@ -206,13 +210,13 @@ <h2><a name="writing" id="writing">Escribiendo un programa CGI</a></h2> - <p>Hay dos diferencias principales entre programación ``regular'' y - programación en CGI.</p> + <p>Hay dos diferencias principales entre programación ``regular'' y + programación en CGI.</p> <p>Primera, el resultado al completo de tu programa CGI debe estar precedido de una cabecera <a class="glossarylink" href="../glossary.html#mime-type" title="ver glosario">MIME-type</a>. Esta - cabecera HTTP le indica al cliente que tipo de contenido está - recibiendo. La mayor parte de las veces, ésto será algo como:</p> + cabecera HTTP le indica al cliente que tipo de contenido está + recibiendo. La mayor parte de las veces, ésto será algo como:</p> <div class="example"><p><code> Content-type: text/html @@ -220,88 +224,88 @@ <p>Segunda, el resultado debe estar en formato HTML, o cualquier otro formato que su navegador sea capaz de mostrar. La mayor - parte de las veces, será HTML, pero otras escribirá un programa + parte de las veces, será HTML, pero otras escribirá un programa CGI que devuelve una imagen gif, u otro contenido no-HTML.</p> <p>Aparte de estas dos cosas, escribir un programa en CGI se - parecerá bastante a cualquier otro programa que vaya a escribir. + parecerá bastante a cualquier otro programa que vaya a escribir. </p> <h3><a name="firstcgi" id="firstcgi">Su primer programa CGI</a></h3> - <p>A continuación podrá ver un ejemplo de programa CGI que muestra - una línea de texto en su navegador. Escriba lo siguiente, - guárdelo en un archivo con el nombre <code>first.pl</code>, y - póngalo en su directorio <code>cgi-bin</code>.</p> + <p>A continuación podrá ver un ejemplo de programa CGI que muestra + una línea de texto en su navegador. Escriba lo siguiente, + guárdelo en un archivo con el nombre <code>first.pl</code>, y + póngalo en su directorio <code>cgi-bin</code>.</p> <pre class="prettyprint lang-perl">#!/usr/bin/perl print "Content-type: text/html\n\n"; print "Hola, Mundo.";</pre> - <p>Incluso si Perl no le resulta familiar, podrá ver lo que está - ocurriendo aquí. La primera línea le dice a Apache (o a - cualquier shell en la que se esté ejecutando) que este programa - puede ejecutarse con el intérprete en la ubicación - <code>/usr/bin/perl</code>. La segunda línea imprime la - declaración de Content-Type que mencionamos antes, seguida de - dos pares de retornos de carro. Esto pone una línea en blanco - después de la cabecera para indicar el final de las cabeceras + <p>Incluso si Perl no le resulta familiar, podrá ver lo que está + ocurriendo aquí. La primera línea le dice a Apache (o a + cualquier shell en la que se esté ejecutando) que este programa + puede ejecutarse con el intérprete en la ubicación + <code>/usr/bin/perl</code>. La segunda línea imprime la + declaración de Content-Type que mencionamos antes, seguida de + dos pares de retornos de carro. Esto pone una línea en blanco + después de la cabecera para indicar el final de las cabeceras HTTP, y el comienzo del cuerpo del contenido. La tercera imprime la cadena de caracteres "Hola, Mundo.". Y ese es el final del programa.</p> <p>Si lo abre con su navegador favorito y le dice que solicite la - dirección</p> + dirección</p> <div class="example"><p><code> http://www.example.com/cgi-bin/first.pl </code></p></div> - <p>o donde quiera que pusiera el archivo, verá una línea - <code>Hola, Mundo.</code> aparecerán la ventana del navegador. No es - muy emocionante, pero una vez que consiga que funcione podrá hacer + <p>o donde quiera que pusiera el archivo, verá una línea + <code>Hola, Mundo.</code> aparecerán la ventana del navegador. No es + muy emocionante, pero una vez que consiga que funcione podrá hacer lo mismo con casi cualquier programa.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="troubleshoot" id="troubleshoot">¡Pero todavía no funciona!</a></h2> +<h2><a name="troubleshoot" id="troubleshoot">¡Pero todavía no funciona!</a></h2> - <p>Hay 4 cosas básicas que puede llegar a ver en su navegador cuando + <p>Hay 4 cosas básicas que puede llegar a ver en su navegador cuando intenta acceder a un programa CGI desde la web:</p> <dl> <dt>El resultado del programa CGI</dt> - <dd>¡Genial! Esto indica que todo funcionó correctamente. Si el + <dd>¡Genial! Esto indica que todo funcionó correctamente. Si el resultado es correcto, pero el navegador no lo procesa - correctamente, asegúrese de que tiene especificado + correctamente, asegúrese de que tiene especificado correctamente el <code>Content-Type</code> en su programa CGI.</dd> - <dt>El código fuente de su programa CGI o un mensaje del tipo + <dt>El código fuente de su programa CGI o un mensaje del tipo "POST Method Not Allowed".</dt> <dd>Eso significa que no ha configurado Apache de manera - apropiada para interpretar su programa CGI. Relea la sección + apropiada para interpretar su programa CGI. Relea la sección de <a href="#configuring">Configurando Apache</a> e intente - encontrar qué le falta.</dd> + encontrar qué le falta.</dd> <dt>Un mensaje que empieza con "Forbidden"</dt> <dd>Eso significa que hay un problema de permisos. Compruebe el <a href="#errorlogs">Log de Errores de Apache</a> y la - sección de más abajo de <a href="#permissions">Permisos de + sección de más abajo de <a href="#permissions">Permisos de Fichero</a>.</dd> <dt>Un mensaje indicando "Internal Server Error"</dt> <dd>Si comprueba el <a href="#errorlogs">Log de errores de - Apache</a>, probablemente encontrará que indica "Premature - end of script headers", posiblemente acompañado de otro + Apache</a>, probablemente encontrará que indica "Premature + end of script headers", posiblemente acompañado de otro mensaje de error generado por su programa CGI. En este caso, - querrá comprobar cada una de las secciones de más adelante - para ver qué impide que su programa CGI genere las cabeceras + querrá comprobar cada una de las secciones de más adelante + para ver qué impide que su programa CGI genere las cabeceras HTTP adecuadas.</dd> </dl> @@ -309,71 +313,71 @@ print "Hola, Mundo.";</pre> <p>Recuerde que el servidor no se ejecuta con su usuario. Es decir, - cuando el servidor arranca, está funcionando con un usuario sin + cuando el servidor arranca, está funcionando con un usuario sin privilegios, generalmente el usuario <code>nobody</code>, o - <code>www-data</code>, así que necesitará permisos extra para - ejecutar los archivos de los que usted es dueño. Generalmente, - el método para dar permisos suficientes para que se pueda - ejecutar con <code>nobody</code> es dar permisos de ejecución a + <code>www-data</code>, así que necesitará permisos extra para + ejecutar los archivos de los que usted es dueño. Generalmente, + el método para dar permisos suficientes para que se pueda + ejecutar con <code>nobody</code> es dar permisos de ejecución a todo el mundo en el fichero:</p> <div class="example"><p><code> chmod a+x first.pl </code></p></div> - <p>Además, si su programa lee desde o escribe a cualquier otro/s - archivo/s, esos archivos necesitarán tener los permisos correctos + <p>Además, si su programa lee desde o escribe a cualquier otro/s + archivo/s, esos archivos necesitarán tener los permisos correctos para permitir esas acciones.</p> - <h3><a name="pathinformation" id="pathinformation">Información de Ruta y Entorno</a></h3> + <h3><a name="pathinformation" id="pathinformation">Información de Ruta y Entorno</a></h3> - <p>Cuando ejecuta un programa desde la línea de comandos, usted tiene - cierta información que se le pasa a la shell sin que usted se + <p>Cuando ejecuta un programa desde la línea de comandos, usted tiene + cierta información que se le pasa a la shell sin que usted se percate de ello. Por ejemplo, usted tiene un <code>PATH</code>, - que le indica a la shell dónde debe buscar archivos a los que usted + que le indica a la shell dónde debe buscar archivos a los que usted hace referencia.</p> - <p>Cuando un programa se ejecuta a través del servidor web como un + <p>Cuando un programa se ejecuta a través del servidor web como un programa CGI, puede que no tenga el mismo <code>PATH</code>. Cualquier programa que invoque desde su programa CGI (como por - ejemplo <code>sendmail</code>) necesitará que se le indique la - ruta absoluta, así la shell puede encontrarlos cuando intenta + ejemplo <code>sendmail</code>) necesitará que se le indique la + ruta absoluta, así la shell puede encontrarlos cuando intenta ejecutar su programa CGI.</p> - <p>Una manifestación común de esto es la ruta del intérprete del - script (a menudo <code>perl</code>) indicado en la primera línea - de su programa CGI, que parecerá algo como:</p> + <p>Una manifestación común de esto es la ruta del intérprete del + script (a menudo <code>perl</code>) indicado en la primera línea + de su programa CGI, que parecerá algo como:</p> <pre class="prettyprint lang-perl">#!/usr/bin/perl</pre> - <p>Asegúrese de que éste es de hecho el path de su intérprete.</p> + <p>Asegúrese de que éste es de hecho el path de su intérprete.</p> <div class="warning"> Cuando edita scripts CGI en Windows, los caracteres de retorno de - carro podrían añadirse a la línea donde se especifica el intérprete. - Asegúrese de que los archivos se transfieren al servidor en modo + carro podrían añadirse a la línea donde se especifica el intérprete. + Asegúrese de que los archivos se transfieren al servidor en modo ASCII. Fallar en esto puede acabar con avisos del tipo "Command not - found" del Sistema Operativo, debido a que éste no reconoce los - caracteres de final de línea interpretados como parte del nombre - de fichero del intérprete. + found" del Sistema Operativo, debido a que éste no reconoce los + caracteres de final de línea interpretados como parte del nombre + de fichero del intérprete. </div> <h3><a name="missingenv" id="missingenv">Faltan Variables de Entorno</a></h3> - <p>Si su programa CGI depende de <a href="#env">variables de entorno</a> no estándar, necesitará + <p>Si su programa CGI depende de <a href="#env">variables de entorno</a> no estándar, necesitará asegurarse de que Apache pasa esas variables.</p> - <p>Cuando no encuentra ciertas cabeceras HTTP del entorno, asegúrese - de que están formateadas según el + <p>Cuando no encuentra ciertas cabeceras HTTP del entorno, asegúrese + de que están formateadas según el <a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>, - sección 4.2: Nombres de Cabeceras deben empezar con una letra, - seguida solo de letras, números o guión. Cualquier cabecera - que no cumpla esta regla será ignorada de manera silenciosa.</p> + sección 4.2: Nombres de Cabeceras deben empezar con una letra, + seguida solo de letras, números o guión. Cualquier cabecera + que no cumpla esta regla será ignorada de manera silenciosa.</p> @@ -383,9 +387,9 @@ print "Hola, Mundo.";</pre> <p>La mayor parte de las veces cuando un programa CGI falla, es por un problema en el programa mismo. Esto ocurre generalmente cuando se maneja bien con "esto del CGI", y ya no comete los dos errores - mencionados más arriba. Lo primero que hay que hacer es asegurarse - de que su programa se ejecuta correctamente en línea de comandos - antes de probarlo a través del servidor web. Por ejemplo, + mencionados más arriba. Lo primero que hay que hacer es asegurarse + de que su programa se ejecuta correctamente en línea de comandos + antes de probarlo a través del servidor web. Por ejemplo, intente:</p> <div class="example"><p><code> @@ -393,29 +397,29 @@ print "Hola, Mundo.";</pre> ./first.pl </code></p></div> - <p>(No llame al intérprete de <code>perl</code>. La consola y Apache - tienen que poder encontrar el intérprete usando línea - <a href="#pathinformation">línea de información</a> en la primera - línea del script.)</p> + <p>(No llame al intérprete de <code>perl</code>. La consola y Apache + tienen que poder encontrar el intérprete usando línea + <a href="#pathinformation">línea de información</a> en la primera + línea del script.)</p> <p>Lo primero que debe ver escrito por su programa es un conjunto de cabeceras HTTP, incluyendo el <code>Content-Type</code>, - seguido de una línea en blanco. Si ve alguna otra cosa, Apache - devolverá el error <code>Premature end of script headers</code> si + seguido de una línea en blanco. Si ve alguna otra cosa, Apache + devolverá el error <code>Premature end of script headers</code> si intenta lanzar el script en el servidor web. Vea - <a href="#writing">Escribiendo un programa CGI</a> más arriba para - más detalle.</p> + <a href="#writing">Escribiendo un programa CGI</a> más arriba para + más detalle.</p> <h3><a name="errorlogs" id="errorlogs">Log de Errores</a></h3> - <p>El log de errores es su amigo. Cualquier cosa que vaya mal generará - un mensaje en el log de errores. Debería mirar siempre ahí primero. - Si el lugar donde está alojando su sitio web no permite que acceda - al log de errores, probablemente debería alojarlo en otro sitio. - Aprenda a leer el log de errores y se dará cuenta de que enseguida - averiguará el motivo del error y lo solucionará rápidamente.</p> + <p>El log de errores es su amigo. Cualquier cosa que vaya mal generará + un mensaje en el log de errores. Debería mirar siempre ahí primero. + Si el lugar donde está alojando su sitio web no permite que acceda + al log de errores, probablemente debería alojarlo en otro sitio. + Aprenda a leer el log de errores y se dará cuenta de que enseguida + averiguará el motivo del error y lo solucionará rápidamente.</p> <h3><a name="suexec" id="suexec">Suexec</a></h3> @@ -424,68 +428,68 @@ print "Hola, Mundo.";</pre> <p>El programa de soporte <a href="../suexec.html">suexec</a> permite que programas CGI se ejecuten con permisos de usuario distintos, dependiendo del virtualhost o el directorio home donde se - encuentren. Suexec tiene una comprobación de permisos muy estricta, - y cualquier fallo en esa comprobación dará como resultado un error + encuentren. Suexec tiene una comprobación de permisos muy estricta, + y cualquier fallo en esa comprobación dará como resultado un error con el mensaje <code>Premature end of script headers</code>.</p> - <p>Para comprobar si está usando Suexec, ejecute - <code>apachectl -V</code> y compruebe la ubicación de + <p>Para comprobar si está usando Suexec, ejecute + <code>apachectl -V</code> y compruebe la ubicación de <code>SUEXEC_BIN</code>. Si Apache encuentra un binario - <code class="program"><a href="../programs/suexec.html">suexec</a></code> al arrancar, suexec se activará.</p> + <code class="program"><a href="../programs/suexec.html">suexec</a></code> al arrancar, suexec se activará.</p> - <p>A menos que comprenda suxec perfectamente, no debería usarlo. + <p>A menos que comprenda suxec perfectamente, no debería usarlo. Para desactivar suexec, basta con eliminar el binario <code class="program"><a href="../programs/suexec.html">suexec</a></code> al que apunta <code>SUEXEC_BIN</code> y - reiniciar el servidor. Si después de leer sobre - <a href="../suexec.html">suexec</a> todavía quiere usarlo, entonces - ejecute <code>suexec -V</code> para encontrar la ubicación del - fichero log de suexec, y use ese log para encontrar que política no - está cumpliendo.</p> + reiniciar el servidor. Si después de leer sobre + <a href="../suexec.html">suexec</a> todavía quiere usarlo, entonces + ejecute <code>suexec -V</code> para encontrar la ubicación del + fichero log de suexec, y use ese log para encontrar que política no + está cumpliendo.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="behindscenes" id="behindscenes">¿Qué ocurre entre bastidores?</a></h2> +<h2><a name="behindscenes" id="behindscenes">¿Qué ocurre entre bastidores?</a></h2> - <p>En cuanto tenga conocimiento avanzado de programación CGI, le será - útil comprender más de lo que ocurre entre bastidores. - Específicamente, cómo el navegador y el servidor se comunican el uno - con el otro. Porque aunque esté muy bien escribir un programa que + <p>En cuanto tenga conocimiento avanzado de programación CGI, le será + útil comprender más de lo que ocurre entre bastidores. + Específicamente, cómo el navegador y el servidor se comunican el uno + con el otro. Porque aunque esté muy bien escribir un programa que diga "Hola, Mundo.", no tiene una gran utilidad.</p> <h3><a name="env" id="env">Variables de Entorno</a></h3> - <p>Las variables de entorno son valores que están ahí cuando - usa el ordenador. Son cosas útiles como el path (donde su ordenador - busca el archivo específico que se lanza cuando usted escribe un + <p>Las variables de entorno son valores que están ahí cuando + usa el ordenador. Son cosas útiles como el path (donde su ordenador + busca el archivo específico que se lanza cuando usted escribe un comando), su nombre de usuario, el tipo de terminal que usa, etc. Para una lista completa de la variables de entorno normales que se - se usan en su día a día escriba <code>env</code> en la línea de + se usan en su día a día escriba <code>env</code> en la línea de comandos.</p> - <p>Durante la transacción CGI, el servidor y el navegador también - configuran variables de entorno, y así pueden comunicarse entre + <p>Durante la transacción CGI, el servidor y el navegador también + configuran variables de entorno, y así pueden comunicarse entre ellos. Cosas como el tipo de navegador (Netscape, IE, Lynx), el tipo de servidor (Apache, IIS, WebSite), el nombre del programa CGI que - se está ejecutando, etc.</p> + se está ejecutando, etc.</p> - <p>Estas variables están disponibles para el programador de CGI, y son - la mitad de la historia de la comunicación cliente-servidor. La + <p>Estas variables están disponibles para el programador de CGI, y son + la mitad de la historia de la comunicación cliente-servidor. La lista completa de las variables necesarias se encuentra en <a href="http://www.ietf.org/rfc/rfc3875">el RFC de Common Gateway Interface</a>.</p> - <p>Este sencillo programa CGI en Perl mostrará todas las variables - de entorno que se están pasando entre el cliente y el navegador. Dos - programas similares están incluidos en el directorio - <code>cgi-bin</code> de la distribución de Apache. Tenga en cuenta + <p>Este sencillo programa CGI en Perl mostrará todas las variables + de entorno que se están pasando entre el cliente y el navegador. Dos + programas similares están incluidos en el directorio + <code>cgi-bin</code> de la distribución de Apache. Tenga en cuenta que algunas variables son necesarias mientras que otras son - opcionales, así que es posible que vea algunas variables que no - están en la lista oficial. Adicionalmente, Apache aporta distintas + opcionales, así que es posible que vea algunas variables que no + están en la lista oficial. Adicionalmente, Apache aporta distintas maneras diferentes para que pueda - <a href="../env.html">añadir sus variables de entorno</a> a las - básicas que se proveen por defecto.</p> + <a href="../env.html">añadir sus variables de entorno</a> a las + básicas que se proveen por defecto.</p> <pre class="prettyprint lang-perl">#!/usr/bin/perl use strict; @@ -502,93 +506,93 @@ foreach my $key (keys %ENV) { <h3><a name="stdin" id="stdin">STDIN y STDOUT</a></h3> - <p>Otra comunicación entre el servidor y el cliente ocurre en la - entrada estándar (<code>STDIN</code>) y la salida estándar - (<code>STDOUT</code>). En el contexto normal de cada día, + <p>Otra comunicación entre el servidor y el cliente ocurre en la + entrada estándar (<code>STDIN</code>) y la salida estándar + (<code>STDOUT</code>). En el contexto normal de cada día, <code>STDIN</code> es la entrada con el teclado, o un fichero que se - le da a un programa para que actúe sobre él, y <code>STDOUT</code> + le da a un programa para que actúe sobre él, y <code>STDOUT</code> generalmente es la consola o la pantalla.</p> <p>Cuando hace <code>POST</code> con un formulario de web a un programa CGI, los datos en ese formulario se empaquetan en un formato especial que se entrega a su programa CGI en el <code>STDIN</code>. - Entonces el programa puede procesar la información como si le llegara + Entonces el programa puede procesar la información como si le llegara desde el teclado, o desde un fichero.</p> <p>El "formato especial" es muy sencillo. Un nombre de campo y su valor se asocian juntos con el signo igual (=), y pares de valores - se asocian juntos con el ampersand ó et en español (&). + se asocian juntos con el ampersand ó et en español (&). Caracteres inconvenientes como los espacios, ampersands y signos de igual, se convierten en su equivalente hexadecimal para no impidan el funcionamiento correcto del programa. La cadena de datos al - completo será algo como:</p> + completo será algo como:</p> <div class="example"><p><code> name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey </code></p></div> - <p>A veces tendrá este tipo de cadena de caracteres al final de una + <p>A veces tendrá este tipo de cadena de caracteres al final de una URL. Cuando esto ocurre, el servidor pone esa cadena en una variable de entorno que se llama <code>QUERY_STRING</code>. Esto se llama solicitud <code>GET</code>. Su formulario HTML especifica si se usa un <code>GET</code> o un <code>POST</code> para entregar la - información, configurando el atributo <code>METHOD</code> en la + información, configurando el atributo <code>METHOD</code> en la etiqueta <code>FORM</code>.</p> <p>Su programa es el responsable de convertir esa cadena de - caracteres en información útil. Afortunadamente, hay librerías y - módulos disponibles que ayudan a procesar la información, así como a + caracteres en información útil. Afortunadamente, hay librerías y + módulos disponibles que ayudan a procesar la información, así como a gestionar los distintos aspectos de su programa CGI.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="libraries" id="libraries">Módulos/librerías CGI</a></h2> +<h2><a name="libraries" id="libraries">Módulos/librerías CGI</a></h2> - <p>Cuando escribe programas CGI, debería considerar usar una librería de - código, o módulo, para hacer todo el trabajo más arduo por usted. - Esto lleva a tener menos errores y un desarrollo de código más - rápido.</p> + <p>Cuando escribe programas CGI, debería considerar usar una librería de + código, o módulo, para hacer todo el trabajo más arduo por usted. + Esto lleva a tener menos errores y un desarrollo de código más + rápido.</p> - <p>Si está escribiendo un programa CGI en Perl, existen módulos - disponibles en <a href="http://www.cpan.org/">CPAN</a>. El módulo más - conocido para este propósito es <code>CGI.pm</code>. Quizás quiera + <p>Si está escribiendo un programa CGI en Perl, existen módulos + disponibles en <a href="http://www.cpan.org/">CPAN</a>. El módulo más + conocido para este propósito es <code>CGI.pm</code>. Quizás quiera considerar <code>CGI::Lite</code>, que implementa una funcionalidad - mínima, que es todo lo que se necesita en la mayoría de los programas.</p> + mínima, que es todo lo que se necesita en la mayoría de los programas.</p> - <p>Si está escribiendo programas CGI en C, hay varidad de opciones. Una - de estas es la librería <code>CGIC</code>, de + <p>Si está escribiendo programas CGI en C, hay varidad de opciones. Una + de estas es la librería <code>CGIC</code>, de <a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="moreinfo" id="moreinfo">Para más información</a></h2> +<h2><a name="moreinfo" id="moreinfo">Para más información</a></h2> - <p>La especificación actual de CGI está disponible en el + <p>La especificación actual de CGI está disponible en el <a href="http://www.ietf.org/rfc/rfc3875">RFC de Common Gateway Interface</a>.</p> - <p>Cuando envíe una pregunta sobre un problema de CGI, o bien a una - lista de correo, o a un grupo de noticias, asegúrese de que facilita suficiente - información de lo que ha ocurrido, de lo que espera que ocurra, y de - lo que está ocurriendo en su lugar que es diferente, el servidor que - está ejecutando, en qué lenguaje CGI está hecho su programa, y si es - posible, el código que falla. Esto hará encontrar el problema mucho más - fácil.</p> + <p>Cuando envíe una pregunta sobre un problema de CGI, o bien a una + lista de correo, o a un grupo de noticias, asegúrese de que facilita suficiente + información de lo que ha ocurrido, de lo que espera que ocurra, y de + lo que está ocurriendo en su lugar que es diferente, el servidor que + está ejecutando, en qué lenguaje CGI está hecho su programa, y si es + posible, el código que falla. Esto hará encontrar el problema mucho más + fácil.</p> <p>Tenga en cuenta que las preguntas sobre problemas CGI - <strong>nunca</strong> deberían enviarse a la base de datos de bugs de - bugs de Apache a menos que esté seguro de haber encontrado un - problema en el código fuente de Apache.</p> + <strong>nunca</strong> deberían enviarse a la base de datos de bugs de + bugs de Apache a menos que esté seguro de haber encontrado un + problema en el código fuente de Apache.</p> </div></div> <div class="bottomlang"> <p><span>Idiomas disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/howto/cgi.html" title="Español"> es </a> | -<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../es/howto/cgi.html" title="Español"> es </a> | +<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> -</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html'; @@ -606,8 +610,8 @@ var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2019 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> -<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +<p class="apache">Copyright 2024 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); } |