granicus.if.org Git - apache/blob - docs/manual/howto/cgi.html.es.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head>
   4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Tutorial de Apache: Contenido Dinámico con CGI - Servidor HTTP Apache Versión 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/quickreference.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>
  20 <p class="apache">Versión 2.5 del Servidor HTTP Apache</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Servidor HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentación</a> &gt; <a href="../">Versión 2.5</a> &gt; <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial de Apache: Contenido Dinámico con CGI</h1>
  25 <div class="toplang">
  26 <p><span>Idiomas disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  27 <a href="../es/howto/cgi.html" title="Español">&nbsp;es&nbsp;</a> |
  28 <a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  29 <a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  30 <a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  31 </div>
  32 </div>
  33 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introducción</a></li>
  34 <li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurando Apache para permitir CGI</a></li>
  35 <li><img alt="" src="../images/down.gif" /> <a href="#writing">Escribiendo un programa CGI</a></li>
  36 <li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">¡Pero todavía no funciona!</a></li>
  37 <li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">¿Qué ocurre entre bastidores?</a></li>
  38 <li><img alt="" src="../images/down.gif" /> <a href="#libraries">Módulos/librerías CGI</a></li>
  39 <li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Para más información</a></li>
  40 </ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div>
  41 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  42 <div class="section">
  43 <h2><a name="intro" id="intro">Introducción</a><a title="Enlace permanente" href="#intro" class="permalink">&para;</a></h2>
  44
  45                 <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>
  46
  47         <p>CGI (Common Gateway Interface) es un método por el cual
  48                 un servidor web puede interactuar con programas externos de
  49                 generación de contenido, a ellos nos referimos comúnmente como
  50                 programas CGI o scripts CGI. Es el método más común y sencillo de
  51         mostrar contenido dinámico en su sitio web. Este documento es una
  52                 introducción para configurar CGI en su servidor web Apache, y de
  53                 iniciación para escribir programas CGI.</p>
  54         </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  55 <div class="section">
  56 <h2><a name="configuring" id="configuring">Configurando Apache para permitir CGI</a><a title="Enlace permanente" href="#configuring" class="permalink">&para;</a></h2>
  57
  58
  59         <p>Para conseguir que sus programas CGI funcionen correctamente,
  60             deberá configurar Apache para que permita la ejecución de CGI. Hay
  61             distintas formas de hacerlo.</p>
  62
  63         <div class="warning">Nota: Si Apache ha sido compilado con soporte
  64         de módulos compartidos, necesitará que el módulo de CGI esté cargado;
  65         en su <code>httpd.conf</code> tiene que asegurarse de que la directiva
  66         <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
  67         no ha sido comentada. Una directiva configurada correctamente sería así:
  68
  69             <pre class="prettyprint lang-config">LoadModule cgid_module modules/mod_cgid.so</pre>
  70
  71
  72         En Windows, o si usa un mpm que no es multihilo, como prefork, una
  73         directiva configurada correctamente podría definirse así:
  74
  75         <pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre>
  76 </div>
  77
  78         <h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
  79
  80
  81             <p>La directiva
  82             <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
  83             indica a Apache que un directorio se ha configurado específicamente
  84             para programas CGI. Apache asumirá que cada fichero en este
  85             directorio es un programa CGI, e intentará ejecutarlos cuando un
  86             cliente solicita este recurso.</p>
  87
  88             <p>La directiva
  89             <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> se puede
  90             definir así:</p>
  91
  92             <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"</pre>
  93
  94
  95             <p>El ejemplo que se muestra es de un archivo de configuración
  96             <code>httpd.conf</code> por defecto si usted instaló Apache
  97             en la ubicación por defecto. La directiva
  98             <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> es muy
  99             parecida a la directiva <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>,
 100             ésta define un prefijo de URL que se enlaza a un directorio
 101             en particular. <code class="directive">Alias</code> y
 102             <code class="directive">ScriptAlias</code> se usan generalmente para
 103             directorios que se encuentran fuera del directorio
 104             <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. La diferencia
 105             entre <code class="directive">Alias</code> y <code class="directive">ScriptAlias</code>
 106             es que en <code class="directive">ScriptAlias</code> cualquier elemento
 107             debajo de ese prefijo de URL será considerado un programa CGI. Así,
 108             el ejemplo de más arriba le indica a Apache que
 109             cualquier solicitud para un recurso que comience con
 110             <code>/cgi-bin/</code> debería servirse desde el directorio
 111             <code>/usr/local/apache2/cgi-bin/</code>, y debería tratarse como un
 112             programa CGI.</p>
 113
 114             <p>Por ejemplo, si se solicita la URL
 115             <code>http://www.example.com/cgi-bin/test.pl</code>,
 116             Apache intentará ejecutar el archivo
 117             <code>/usr/local/apache2/cgi-bin/test.pl</code> y dar
 118             el resultado. Por supuesto el archivo debe existir y ser ejecutable,
 119             y dar el resultado de una manera específica o Apache devolverá
 120             un mensaje de error.</p>
 121
 122
 123         <h3><a name="nonscriptalias" id="nonscriptalias">CGI fuera de directorios ScriptAlias</a></h3>
 124
 125
 126             <p>Los programas CGI habitualmente se restringen a los directorios de
 127             <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> por razones de
 128             seguridad. De esta manera, los administradores pueden controlar de una
 129             manera más segura quien puede ejecutar programas CGI. Aun así, si no
 130             se toman suficientes precauciones, no hay ninguna razón por la que
 131             programas CGI no se puedan ejecutar desde directorios seleccionados de
 132             manera arbitraria. Por ejemplo, quizás quiera permitir que usuarios del
 133             sistema tengan contenido web en sus directorios home con la directiva
 134             <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Si quieren
 135             tener sus propios programas CGI, pero no tienen acceso al directorio
 136             principal <code>cgi-bin</code>, necesitarán ser capaces de
 137             ejecutar sus scripts CGI en algún otro sitio.</p>
 138
 139             <p>Hay dos pasos a seguir para permitir la ejecución CGI en directorios
 140             seleccionados de manera arbitraria. Primero, el handler
 141             <code>cgi-script</code> debe estar activado usando la directiva
 142             <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> o la directiva
 143             <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. Segundo, el parámetro
 144             <code>ExecCGI</code> debe estar definido en la directiva
 145             <code class="directive"><a href="../mod/core.html#options">Options</a></code>.</p>
 146
 147
 148         <h3><a name="options" id="options">Usando Options de manera explícita para permitir ejecución de
 149             CGI</a></h3>
 150
 151
 152             <p>Puede usar la directiva
 153             <code class="directive"><a href="../mod/core.html#options">Options</a></code>, en el archivo de
 154             configuración principal para especificar que se permite la ejecución
 155             de CGI en un directorio en particular:</p>
 156
 157             <pre class="prettyprint lang-config">&lt;Directory "/usr/local/apache2/htdocs/somedir"&gt;
 158     Options +ExecCGI
 159 &lt;/Directory&gt;</pre>
 160
 161
 162             <p>Esta directiva de aquí arriba le indica a Apache que debe
 163             permitir la ejecución de archivos CGI. También necesitará indicarle
 164             al servidor que los archivos son archivos CGI. La directiva
 165             <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> le indica al
 166             servidor que debe tratar a todos los archivos con la extensión
 167             <code>cgi</code> o <code>pl</code> como programas CGI:</p>
 168
 169             <pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre>
 170
 171
 172
 173         <h3><a name="htaccess" id="htaccess">Ficheros .htaccess</a></h3>
 174
 175
 176             <p>El <a href="htaccess.html">tutorial <code>.htaccess</code></a>
 177             enseña como activar programas CGI si no tienes acceso a
 178             <code>httpd.conf</code>.</p>
 179
 180
 181         <h3><a name="userdir" id="userdir">Directorios de Usuario</a></h3>
 182
 183
 184             <p>Para permitir la ejecución de programas CGI para cualquier
 185             archivo que acabe en <code>.cgi</code> en directorios de usuario,
 186             puedes usar la siguiente configuración:</p>
 187
 188             <pre class="prettyprint lang-config">&lt;Directory "/home/*/public_html"&gt;
 189     Options +ExecCGI
 190     AddHandler cgi-script .cgi
 191 &lt;/Directory&gt;</pre>
 192
 193
 194             <p>Si quiere designar un subdirectorio <code>cgi-bin</code> dentro
 195             de un directorio de usuario en el que todos los ficheros serán
 196             tratados como un programa CGI, puede usar lo siguiente:</p>
 197
 198             <pre class="prettyprint lang-config">&lt;Directory "/home/*/public_html/cgi-bin"&gt;
 199     Options ExecCGI
 200     SetHandler cgi-script
 201 &lt;/Directory&gt;</pre>
 202
 203
 204     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 205 <div class="section">
 206 <h2><a name="writing" id="writing">Escribiendo un programa CGI</a><a title="Enlace permanente" href="#writing" class="permalink">&para;</a></h2>
 207
 208
 209         <p>Hay dos diferencias principales entre programación ``regular'' y
 210         programación en CGI.</p>
 211
 212         <p>Primera, el resultado al completo de tu programa CGI debe estar
 213         precedido de una cabecera <a class="glossarylink" href="../glossary.html#mime-type" title="ver glosario">MIME-type</a>. Esta
 214         cabecera HTTP le indica al cliente que tipo de contenido está
 215         recibiendo. La mayor parte de las veces, ésto será algo como:</p>
 216
 217         <div class="example"><p><code>
 218             Content-type: text/html
 219         </code></p></div>
 220
 221         <p>Segunda, el resultado debe estar en formato HTML, o cualquier
 222         otro formato que su navegador sea capaz de mostrar. La mayor
 223         parte de las veces, será HTML, pero otras escribirá un programa
 224         CGI que devuelve una imagen gif, u otro contenido no-HTML.</p>
 225
 226         <p>Aparte de estas dos cosas, escribir un programa en CGI se
 227         parecerá bastante a cualquier otro programa que vaya a escribir.
 228         </p>
 229
 230
 231         <h3><a name="firstcgi" id="firstcgi">Su primer programa CGI</a></h3>
 232
 233
 234             <p>A continuación podrá ver un ejemplo de programa CGI que muestra
 235             una línea de texto en su navegador. Escriba lo siguiente,
 236             guárdelo en un archivo con el nombre <code>first.pl</code>, y
 237             póngalo en su directorio <code>cgi-bin</code>.</p>
 238
 239             <pre class="prettyprint lang-perl">#!/usr/bin/perl
 240 print "Content-type: text/html\n\n";
 241 print "Hola, Mundo.";</pre>
 242
 243
 244             <p>Incluso si Perl no le resulta familiar, podrá ver lo que está
 245             ocurriendo aquí. La primera línea le dice a Apache (o a
 246             cualquier shell en la que se esté ejecutando) que este programa
 247             puede ejecutarse con el intérprete en la ubicación
 248             <code>/usr/bin/perl</code>. La segunda línea imprime la
 249             declaración de Content-Type que mencionamos antes, seguida de
 250             dos pares de retornos de carro. Esto pone una línea en blanco
 251             después de la cabecera para indicar el final de las cabeceras
 252             HTTP, y el comienzo del cuerpo del contenido. La tercera
 253             imprime la cadena de caracteres "Hola, Mundo.". Y ese es el
 254             final del programa.</p>
 255
 256             <p>Si lo abre con su navegador favorito y le dice que solicite la
 257             dirección</p>
 258
 259             <div class="example"><p><code>
 260                 http://www.example.com/cgi-bin/first.pl
 261             </code></p></div>
 262
 263             <p>o donde quiera que pusiera el archivo, verá una línea
 264             <code>Hola, Mundo.</code> aparecerán la ventana del navegador. No es
 265             muy emocionante, pero una vez que consiga que funcione podrá hacer
 266             lo mismo con casi cualquier programa.</p>
 267
 268     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 269 <div class="section">
 270 <h2><a name="troubleshoot" id="troubleshoot">¡Pero todavía no funciona!</a><a title="Enlace permanente" href="#troubleshoot" class="permalink">&para;</a></h2>
 271
 272
 273         <p>Hay 4 cosas básicas que puede llegar a ver en su navegador cuando
 274         intenta acceder a un programa CGI desde la web:</p>
 275
 276         <dl>
 277             <dt>El resultado del programa CGI</dt>
 278             <dd>¡Genial! Esto indica que todo funcionó correctamente. Si el
 279             resultado es correcto, pero el navegador no lo procesa
 280             correctamente, asegúrese de que tiene especificado
 281             correctamente el <code>Content-Type</code> en su programa
 282             CGI.</dd>
 283
 284             <dt>El código fuente de su programa CGI o un mensaje del tipo
 285             "POST Method Not Allowed".</dt>
 286
 287             <dd>Eso significa que no ha configurado Apache de manera
 288             apropiada para interpretar su programa CGI. Relea la sección
 289             de <a href="#configuring">Configurando Apache</a> e intente
 290             encontrar qué le falta.</dd>
 291
 292             <dt>Un mensaje que empieza con "Forbidden"</dt>
 293             <dd>Eso significa que hay un problema de permisos. Compruebe el
 294             <a href="#errorlogs">Log de Errores de Apache</a> y la
 295             sección de más abajo de <a href="#permissions">Permisos de
 296             Fichero</a>.</dd>
 297
 298             <dt>Un mensaje indicando "Internal Server Error"</dt>
 299             <dd>Si comprueba el <a href="#errorlogs">Log de errores de
 300             Apache</a>, probablemente encontrará que indica "Premature
 301             end of script headers", posiblemente acompañado de otro
 302             mensaje de error generado por su programa CGI. En este caso,
 303             querrá comprobar cada una de las secciones de más adelante
 304             para ver qué impide que su programa CGI genere las cabeceras
 305             HTTP adecuadas.</dd>
 306             </dl>
 307
 308         <h3><a name="permissions" id="permissions">Permisos de Fichero</a></h3>
 309
 310
 311             <p>Recuerde que el servidor no se ejecuta con su usuario. Es decir,
 312             cuando el servidor arranca, está funcionando con un usuario sin
 313             privilegios, generalmente el usuario <code>nobody</code>, o
 314             <code>www-data</code>, así que necesitará permisos extra para
 315             ejecutar los archivos de los que usted es dueño. Generalmente,
 316             el método para dar permisos suficientes para que se pueda
 317             ejecutar con <code>nobody</code> es dar permisos de ejecución a
 318             todo el mundo en el fichero:</p>
 319
 320             <div class="example"><p><code>
 321                 chmod a+x first.pl
 322             </code></p></div>
 323
 324             <p>Además, si su programa lee desde o escribe a cualquier otro/s
 325             archivo/s, esos archivos necesitarán tener los permisos correctos
 326             para permitir esas acciones.</p>
 327
 328
 329
 330         <h3><a name="pathinformation" id="pathinformation">Información de Ruta y Entorno</a></h3>
 331
 332
 333             <p>Cuando ejecuta un programa desde la línea de comandos, usted tiene
 334             cierta información que se le pasa a la shell sin que usted se
 335             percate de ello. Por ejemplo, usted tiene un <code>PATH</code>,
 336             que le indica a la shell dónde debe buscar archivos a los que usted
 337             hace referencia.</p>
 338
 339             <p>Cuando un programa se ejecuta a través del servidor web como un
 340             programa CGI, puede que no tenga el mismo <code>PATH</code>.
 341             Cualquier programa que invoque desde su programa CGI (como por
 342             ejemplo <code>sendmail</code>) necesitará que se le indique la
 343             ruta absoluta, así la shell puede encontrarlos cuando intenta
 344             ejecutar su programa CGI.</p>
 345
 346             <p>Una manifestación común de esto es la ruta del intérprete del
 347             script (a menudo <code>perl</code>) indicado en la primera línea
 348             de su programa CGI, que parecerá algo como:</p>
 349
 350             <pre class="prettyprint lang-perl">#!/usr/bin/perl</pre>
 351
 352
 353             <p>Asegúrese de que éste es de hecho el path de su intérprete.</p>
 354             <div class="warning">
 355             Cuando edita scripts CGI en Windows, los caracteres de retorno de
 356             carro podrían añadirse a la línea donde se especifica el intérprete.
 357             Asegúrese de que los archivos se transfieren al servidor en modo
 358             ASCII. Fallar en esto puede acabar con avisos del tipo "Command not
 359             found" del Sistema Operativo, debido a que éste no reconoce los
 360             caracteres de final de línea interpretados como parte del nombre
 361             de fichero del intérprete.
 362             </div>
 363
 364
 365         <h3><a name="missingenv" id="missingenv">Faltan Variables de Entorno</a></h3>
 366
 367
 368             <p>Si su programa CGI depende de <a href="#env">variables de entorno</a> no estándar, necesitará
 369             asegurarse de que Apache pasa esas variables.</p>
 370
 371             <p>Cuando no encuentra ciertas cabeceras HTTP del entorno, asegúrese
 372             de que están formateadas según el
 373             <a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>,
 374             sección 4.2: Nombres de Cabeceras deben empezar con una letra,
 375             seguida solo de letras, números o guión. Cualquier cabecera
 376             que no cumpla esta regla será ignorada de manera silenciosa.</p>
 377
 378
 379
 380         <h3><a name="syntaxerrors" id="syntaxerrors">Errores de Programa</a></h3>
 381
 382
 383             <p>La mayor parte de las veces cuando un programa CGI falla, es por un
 384             problema en el programa mismo. Esto ocurre generalmente cuando se
 385             maneja bien con "esto del CGI", y ya no comete los dos errores
 386             mencionados más arriba. Lo primero que hay que hacer es asegurarse
 387             de que su programa se ejecuta correctamente en línea de comandos
 388             antes de probarlo a través del servidor web.  Por ejemplo,
 389             intente:</p>
 390
 391             <div class="example"><p><code>
 392                 cd /usr/local/apache2/cgi-bin<br />
 393                 ./first.pl
 394             </code></p></div>
 395
 396             <p>(No llame al intérprete de <code>perl</code>. La consola y Apache
 397             tienen que poder encontrar el intérprete usando línea
 398             <a href="#pathinformation">línea de información</a> en la primera
 399             línea del script.)</p>
 400
 401             <p>Lo primero que debe ver escrito por su programa es un conjunto de
 402             cabeceras HTTP, incluyendo el <code>Content-Type</code>,
 403             seguido de una línea en blanco.  Si ve alguna otra cosa, Apache
 404             devolverá el error <code>Premature end of script headers</code> si
 405             intenta lanzar el script en el servidor web. Vea
 406             <a href="#writing">Escribiendo un programa CGI</a> más arriba para
 407             más detalle.</p>
 408
 409
 410         <h3><a name="errorlogs" id="errorlogs">Log de Errores</a></h3>
 411
 412
 413             <p>El log de errores es su amigo. Cualquier cosa que vaya mal generará
 414             un mensaje en el log de errores. Debería mirar siempre ahí primero.
 415             Si el lugar donde está alojando su sitio web no permite que acceda
 416             al log de errores, probablemente debería alojarlo en otro sitio.
 417             Aprenda a leer el log de errores y se dará cuenta de que enseguida
 418             averiguará el motivo del error y lo solucionará rápidamente.</p>
 419
 420
 421         <h3><a name="suexec" id="suexec">Suexec</a></h3>
 422
 423
 424             <p>El programa de soporte <a href="../suexec.html">suexec</a> permite
 425             que programas CGI se ejecuten con permisos de usuario distintos,
 426             dependiendo del virtualhost o el directorio home donde se
 427             encuentren. Suexec tiene una comprobación de permisos muy estricta,
 428             y cualquier fallo en esa comprobación dará como resultado un error
 429             con el mensaje <code>Premature end of script headers</code>.</p>
 430
 431             <p>Para comprobar si está usando Suexec, ejecute
 432             <code>apachectl -V</code> y compruebe la ubicación de
 433             <code>SUEXEC_BIN</code>. Si Apache encuentra un binario
 434             <code class="program"><a href="../programs/suexec.html">suexec</a></code> al arrancar, suexec se activará.</p>
 435
 436             <p>A menos que comprenda suxec perfectamente, no debería usarlo.
 437             Para desactivar suexec, basta con eliminar el binario
 438             <code class="program"><a href="../programs/suexec.html">suexec</a></code> al que apunta <code>SUEXEC_BIN</code> y
 439             reiniciar el servidor. Si después de leer sobre
 440             <a href="../suexec.html">suexec</a> todavía quiere usarlo, entonces
 441             ejecute <code>suexec -V</code> para encontrar la ubicación del
 442             fichero log de suexec, y use ese log para encontrar que política no
 443             está cumpliendo.</p>
 444
 445     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 446 <div class="section">
 447 <h2><a name="behindscenes" id="behindscenes">¿Qué ocurre entre bastidores?</a><a title="Enlace permanente" href="#behindscenes" class="permalink">&para;</a></h2>
 448
 449
 450         <p>En cuanto tenga conocimiento avanzado de programación CGI, le será
 451         útil comprender más de lo que ocurre entre bastidores.
 452         Específicamente, cómo el navegador y el servidor se comunican el uno
 453         con el otro. Porque aunque esté muy bien escribir un programa que
 454         diga "Hola, Mundo.", no tiene una gran utilidad.</p>
 455
 456         <h3><a name="env" id="env">Variables de Entorno</a></h3>
 457
 458
 459             <p>Las variables de entorno son valores que están ahí cuando
 460             usa el ordenador. Son cosas útiles como el path (donde su ordenador
 461             busca el archivo específico que se lanza cuando usted escribe un
 462             comando), su nombre de usuario, el tipo de terminal que usa, etc.
 463             Para una lista completa de la variables de entorno normales que se
 464             se usan en su día a día escriba <code>env</code> en la línea de
 465             comandos.</p>
 466
 467             <p>Durante la transacción CGI, el servidor y el navegador también
 468             configuran variables de entorno, y así pueden comunicarse entre
 469             ellos. Cosas como el tipo de navegador (Netscape, IE, Lynx), el tipo
 470             de servidor (Apache, IIS, WebSite), el nombre del programa CGI que
 471             se está ejecutando, etc.</p>
 472
 473             <p>Estas variables están disponibles para el programador de CGI, y son
 474             la mitad de la historia de la comunicación cliente-servidor. La
 475             lista completa de las variables necesarias se encuentra en
 476             <a href="http://www.ietf.org/rfc/rfc3875">el RFC de Common Gateway
 477             Interface</a>.</p>
 478
 479             <p>Este sencillo programa CGI en Perl mostrará todas las variables
 480             de entorno que se están pasando entre el cliente y el navegador. Dos
 481             programas similares están incluidos en el directorio
 482             <code>cgi-bin</code> de la distribución de Apache. Tenga en cuenta
 483             que algunas variables son necesarias mientras que otras son
 484             opcionales, así que es posible que vea algunas variables que no
 485             están en la lista oficial. Adicionalmente, Apache aporta distintas
 486             maneras diferentes para que pueda
 487             <a href="../env.html">añadir sus variables de entorno</a> a las
 488             básicas que se proveen por defecto.</p>
 489
 490             <pre class="prettyprint lang-perl">#!/usr/bin/perl
 491 use strict;
 492 use warnings;
 493
 494 print "Content-type: text/html\n\n";
 495
 496 foreach my $key (keys %ENV) {
 497     print "$key --&gt; $ENV{$key}&lt;br&gt;";
 498 }</pre>
 499
 500
 501
 502         <h3><a name="stdin" id="stdin">STDIN y STDOUT</a></h3>
 503
 504
 505             <p>Otra comunicación entre el servidor y el cliente ocurre en la
 506             entrada estándar (<code>STDIN</code>) y la salida estándar
 507             (<code>STDOUT</code>). En el contexto normal de cada día,
 508             <code>STDIN</code> es la entrada con el teclado, o un fichero que se
 509             le da a un programa para que actúe sobre él, y <code>STDOUT</code>
 510             generalmente es la consola o la pantalla.</p>
 511
 512             <p>Cuando hace <code>POST</code> con un formulario de web a un programa
 513             CGI, los datos en ese formulario se empaquetan en un formato especial
 514             que se entrega a su programa CGI en el <code>STDIN</code>.
 515             Entonces el programa puede procesar la información como si le llegara
 516             desde el teclado, o desde un fichero.</p>
 517
 518             <p>El "formato especial" es muy sencillo. Un nombre de campo y su
 519             valor se asocian juntos con el signo igual (=), y pares de valores
 520             se asocian juntos con el ampersand ó et en español (&amp;).
 521             Caracteres inconvenientes como los espacios, ampersands y signos de
 522             igual, se convierten en su equivalente hexadecimal para no impidan
 523             el funcionamiento correcto del programa. La cadena de datos al
 524             completo será algo como:</p>
 525
 526   <div class="example"><p><code>
 527         name=Rich%20Bowen&amp;city=Lexington&amp;state=KY&amp;sidekick=Squirrel%20Monkey
 528   </code></p></div>
 529
 530             <p>A veces tendrá este tipo de cadena de caracteres al final de una
 531             URL. Cuando esto ocurre, el servidor pone esa cadena en una variable
 532             de entorno que se llama <code>QUERY_STRING</code>. Esto se llama
 533             solicitud <code>GET</code>. Su formulario HTML especifica si se usa
 534             un <code>GET</code> o un <code>POST</code> para entregar la
 535             información, configurando el atributo <code>METHOD</code> en la
 536             etiqueta <code>FORM</code>.</p>
 537
 538             <p>Su programa es el responsable de convertir esa cadena de
 539             caracteres en información útil. Afortunadamente, hay librerías y
 540             módulos disponibles que ayudan a procesar la información, así como a
 541             gestionar los distintos aspectos de su programa CGI.</p>
 542
 543     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 544 <div class="section">
 545 <h2><a name="libraries" id="libraries">Módulos/librerías CGI</a><a title="Enlace permanente" href="#libraries" class="permalink">&para;</a></h2>
 546
 547
 548         <p>Cuando escribe programas CGI, debería considerar usar una librería de
 549         código, o módulo, para hacer todo el trabajo más arduo por usted.
 550         Esto lleva a tener menos errores y un desarrollo de código más
 551         rápido.</p>
 552
 553         <p>Si está escribiendo un programa CGI en Perl, existen módulos
 554         disponibles en <a href="http://www.cpan.org/">CPAN</a>. El módulo más
 555         conocido para este propósito es <code>CGI.pm</code>. Quizás quiera
 556         considerar <code>CGI::Lite</code>, que implementa una funcionalidad
 557         mínima, que es todo lo que se necesita en la mayoría de los programas.</p>
 558
 559         <p>Si está escribiendo programas CGI en C, hay varidad de opciones. Una
 560         de estas es la librería <code>CGIC</code>, de
 561         <a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>.
 562         </p>
 563     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 564 <div class="section">
 565 <h2><a name="moreinfo" id="moreinfo">Para más información</a><a title="Enlace permanente" href="#moreinfo" class="permalink">&para;</a></h2>
 566
 567
 568         <p>La especificación actual de CGI está disponible en el
 569         <a href="http://www.ietf.org/rfc/rfc3875">RFC de Common Gateway
 570         Interface</a>.</p>
 571
 572         <p>Cuando envíe una pregunta sobre un problema de CGI, o bien a una
 573         lista de correo, o a un grupo de noticias, asegúrese de que facilita suficiente
 574         información de lo que ha ocurrido, de lo que espera que ocurra, y de
 575         lo que está ocurriendo en su lugar que es diferente, el servidor que
 576         está ejecutando, en qué lenguaje CGI está hecho su programa, y si es
 577         posible, el código que falla. Esto hará encontrar el problema mucho más
 578         fácil.</p>
 579
 580         <p>Tenga en cuenta que las preguntas sobre problemas CGI
 581         <strong>nunca</strong> deberían enviarse a la base de datos de bugs de
 582         bugs de Apache a menos que esté seguro de haber encontrado un
 583         problema en el código fuente de Apache.</p>
 584     </div></div>
 585 <div class="bottomlang">
 586 <p><span>Idiomas disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 587 <a href="../es/howto/cgi.html" title="Español">&nbsp;es&nbsp;</a> |
 588 <a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 589 <a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 590 <a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 591 </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&amp;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>
 592 <script type="text/javascript"><!--//--><![CDATA[//><!--
 593 var comments_shortname = 'httpd';
 594 var comments_identifier = 'http://httpd.apache.org/docs/trunk/howto/cgi.html';
 595 (function(w, d) {
 596     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 597         d.write('<div id="comments_thread"><\/div>');
 598         var s = d.createElement('script');
 599         s.type = 'text/javascript';
 600         s.async = true;
 601         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 602         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 603     }
 604     else {
 605         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 606     }
 607 })(window, document);
 608 //--><!]]></script></div><div id="footer">
 609 <p class="apache">Copyright 2018 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>
 610 <p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/quickreference.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[//><!--
 611 if (typeof(prettyPrint) !== 'undefined') {
 612     prettyPrint();
 613 }
 614 //--><!]]></script>
 615 </body></html>