Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial de Apache: Contenido Dinmico con CGI - Servidor Apache HTTP Versin 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" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Mdulos</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">Versin 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/">Documentacin</a> > <a href="../">Versin 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial de Apache: Contenido Dinmico 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="Espaol"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Franais"> 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>
<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">Introduccin</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 todava 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">Mdulos/libreras CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Para ms informacin</a></li>
</ul><h3>Consulte tambin</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">Introduccin</a></h2>
<table class="related"><tr><th>Mdulos 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 mtodo por el cual
un servidor web puede interactuar con programas externos de
generacin de contenido, a ellos nos referimos comnmente como
programas CGI o scripts CGI. Es el mtodo ms comn y sencillo de
mostrar contenido dinmico en su sitio web. Este documento es una
introduccin para configurar CGI en su servidor web Apache, y de
iniciacin 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 ejecucin de CGI. Hay
distintas formas de hacerlo.</p>
<div class="warning">Nota: Si Apache ha sido compilado con soporte
de mdulos compartidos, necesitar que el mdulo 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 sera 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 podra definirse as:
<pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre>
</div>
<h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
<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 especficamente
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>
<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 configuracin
<code>httpd.conf</code> por defecto si usted instal Apache
en la ubicacin 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
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 ms arriba le indica a Apache que
cualquier solicitud para un recurso que comience con
<code>/cgi-bin/</code> debera servirse desde el directorio
<code>/usr/local/apache2/cgi-bin/</code>, y debera 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
<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 especfica o Apache devolver
un mensaje de error.</p>
<h3><a name="nonscriptalias" id="nonscriptalias">CGI fuera de directorios ScriptAlias</a></h3>
<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 ms segura quien puede ejecutar programas CGI. Aun as, si no
se toman suficientes precauciones, no hay ninguna razn por la que
programas CGI no se puedan ejecutar desde directorios seleccionados de
manera arbitraria. Por ejemplo, quizs 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>, necesitarn ser capaces de
ejecutar sus scripts CGI en algn otro sitio.</p>
<p>Hay dos pasos a seguir para permitir la ejecucin 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 parmetro
<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 explcita para permitir ejecucin 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
configuracin principal para especificar que se permite la ejecucin
de CGI en un directorio en particular:</p>
<pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/somedir">
Options +ExecCGI
</Directory></pre>
<p>Esta directiva de aqu arriba le indica a Apache que debe
permitir la ejecucin de archivos CGI. Tambin 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 extensin
<code>cgi</code> o <code>pl</code> como programas CGI:</p>
<pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre>
<h3><a name="htaccess" id="htaccess">Ficheros .htaccess</a></h3>
<p>El <a href="htaccess.html">tutorial <code>.htaccess</code></a>
ensea 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 ejecucin de programas CGI para cualquier
archivo que acabe en <code>.cgi</code> en directorios de usuario,
puedes usar la siguiente configuracin:</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options +ExecCGI
AddHandler cgi-script .cgi
</Directory></pre>
<p>Si quiere designar un subdirectorio <code>cgi-bin</code> dentro
de un directorio de usuario en el que todos los ficheros sern
tratados como un programa CGI, puede usar lo siguiente:</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="writing" id="writing">Escribiendo un programa CGI</a></h2>
<p>Hay dos diferencias principales entre programacin ``regular'' y
programacin 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>
<div class="example"><p><code>
Content-type: text/html
</code></p></div>
<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
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.
</p>
<h3><a name="firstcgi" id="firstcgi">Su primer programa CGI</a></h3>
<p>A continuacin podr ver un ejemplo de programa CGI que muestra
una lnea de texto en su navegador. Escriba lo siguiente,
gurdelo en un archivo con el nombre <code>first.pl</code>, y
pngalo 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 lnea le dice a Apache (o a
cualquier shell en la que se est ejecutando) que este programa
puede ejecutarse con el intrprete en la ubicacin
<code>/usr/bin/perl</code>. La segunda lnea imprime la
declaracin de Content-Type que mencionamos antes, seguida de
dos pares de retornos de carro. Esto pone una lnea en blanco
despus 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
direccin</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 lnea
<code>Hola, Mundo.</code> aparecern 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 todava no funciona!</a></h2>
<p>Hay 4 cosas bsicas 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
resultado es correcto, pero el navegador no lo procesa
correctamente, asegrese de que tiene especificado
correctamente el <code>Content-Type</code> en su programa
CGI.</dd>
<dt>El cdigo 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 seccin
de <a href="#configuring">Configurando Apache</a> e intente
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
seccin de ms 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 acompaado de otro
mensaje de error generado por su programa CGI. En este caso,
querr comprobar cada una de las secciones de ms adelante
para ver qu impide que su programa CGI genere las cabeceras
HTTP adecuadas.</dd>
</dl>
<h3><a name="permissions" id="permissions">Permisos de Fichero</a></h3>
<p>Recuerde que el servidor no se ejecuta con su usuario. Es decir,
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 dueo. Generalmente,
el mtodo para dar permisos suficientes para que se pueda
ejecutar con <code>nobody</code> es dar permisos de ejecucin a
todo el mundo en el fichero:</p>
<div class="example"><p><code>
chmod a+x first.pl
</code></p></div>
<p>Adems, si su programa lee desde o escribe a cualquier otro/s
archivo/s, esos archivos necesitarn tener los permisos correctos
para permitir esas acciones.</p>
<h3><a name="pathinformation" id="pathinformation">Informacin de Ruta y Entorno</a></h3>
<p>Cuando ejecuta un programa desde la lnea de comandos, usted tiene
cierta informacin 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 dnde debe buscar archivos a los que usted
hace referencia.</p>
<p>Cuando un programa se ejecuta a travs 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
ejecutar su programa CGI.</p>
<p>Una manifestacin comn de esto es la ruta del intrprete del
script (a menudo <code>perl</code>) indicado en la primera lnea
de su programa CGI, que parecer algo como:</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl</pre>
<p>Asegrese de que ste es de hecho el path de su intrprete.</p>
<div class="warning">
Cuando edita scripts CGI en Windows, los caracteres de retorno de
carro podran aadirse a la lnea donde se especifica el intrprete.
Asegrese 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 lnea interpretados como parte del nombre
de fichero del intrprete.
</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 estndar, necesitar
asegurarse de que Apache pasa esas variables.</p>
<p>Cuando no encuentra ciertas cabeceras HTTP del entorno, asegrese
de que estn formateadas segn el
<a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>,
seccin 4.2: Nombres de Cabeceras deben empezar con una letra,
seguida solo de letras, nmeros o guin. Cualquier cabecera
que no cumpla esta regla ser ignorada de manera silenciosa.</p>
<h3><a name="syntaxerrors" id="syntaxerrors">Errores de Programa</a></h3>
<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 ms arriba. Lo primero que hay que hacer es asegurarse
de que su programa se ejecuta correctamente en lnea de comandos
antes de probarlo a travs del servidor web. Por ejemplo,
intente:</p>
<div class="example"><p><code>
cd /usr/local/apache2/cgi-bin<br />
./first.pl
</code></p></div>
<p>(No llame al intrprete de <code>perl</code>. La consola y Apache
tienen que poder encontrar el intrprete usando lnea
<a href="#pathinformation">lnea de informacin</a> en la primera
lnea 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 lnea 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> ms arriba para
ms 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. Debera mirar siempre ah primero.
Si el lugar donde est alojando su sitio web no permite que acceda
al log de errores, probablemente debera 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 rpidamente.</p>
<h3><a name="suexec" id="suexec">Suexec</a></h3>
<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 comprobacin de permisos muy estricta,
y cualquier fallo en esa comprobacin 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 ubicacin 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>
<p>A menos que comprenda suxec perfectamente, no debera 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 despus de leer sobre
<a href="../suexec.html">suexec</a> todava quiere usarlo, entonces
ejecute <code>suexec -V</code> para encontrar la ubicacin del
fichero log de suexec, y use ese log para encontrar que poltica 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>
<p>En cuanto tenga conocimiento avanzado de programacin CGI, le ser
til comprender ms de lo que ocurre entre bastidores.
Especficamente, cmo 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 estn ah cuando
usa el ordenador. Son cosas tiles como el path (donde su ordenador
busca el archivo especfico 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 da a da escriba <code>env</code> en la lnea de
comandos.</p>
<p>Durante la transaccin CGI, el servidor y el navegador tambin
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>
<p>Estas variables estn disponibles para el programador de CGI, y son
la mitad de la historia de la comunicacin 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 estn pasando entre el cliente y el navegador. Dos
programas similares estn incluidos en el directorio
<code>cgi-bin</code> de la distribucin 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
estn en la lista oficial. Adicionalmente, Apache aporta distintas
maneras diferentes para que pueda
<a href="../env.html">aadir sus variables de entorno</a> a las
bsicas que se proveen por defecto.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
use strict;
use warnings;
print "Content-type: text/html\n\n";
foreach my $key (keys %ENV) {
print "$key --> $ENV{$key}<br>";
}</pre>
<h3><a name="stdin" id="stdin">STDIN y STDOUT</a></h3>
<p>Otra comunicacin entre el servidor y el cliente ocurre en la
entrada estndar (<code>STDIN</code>) y la salida estndar
(<code>STDOUT</code>). En el contexto normal de cada da,
<code>STDIN</code> es la entrada con el teclado, o un fichero que se
le da a un programa para que acte 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 informacin 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 espaol (&).
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>
<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
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
informacin, 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 informacin til. Afortunadamente, hay libreras y
mdulos disponibles que ayudan a procesar la informacin, 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">Mdulos/libreras CGI</a></h2>
<p>Cuando escribe programas CGI, debera considerar usar una librera de
cdigo, o mdulo, para hacer todo el trabajo ms arduo por usted.
Esto lleva a tener menos errores y un desarrollo de cdigo ms
rpido.</p>
<p>Si est escribiendo un programa CGI en Perl, existen mdulos
disponibles en <a href="http://www.cpan.org/">CPAN</a>. El mdulo ms
conocido para este propsito es <code>CGI.pm</code>. Quizs quiera
considerar <code>CGI::Lite</code>, que implementa una funcionalidad
mnima, que es todo lo que se necesita en la mayora de los programas.</p>
<p>Si est escribiendo programas CGI en C, hay varidad de opciones. Una
de estas es la librera <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 ms informacin</a></h2>
<p>La especificacin actual de CGI est disponible en el
<a href="http://www.ietf.org/rfc/rfc3875">RFC de Common Gateway
Interface</a>.</p>
<p>Cuando enve una pregunta sobre un problema de CGI, o bien a una
lista de correo, o a un grupo de noticias, asegrese de que facilita suficiente
informacin 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 cdigo que falla. Esto har encontrar el problema mucho ms
fcil.</p>
<p>Tenga en cuenta que las preguntas sobre problemas CGI
<strong>nunca</strong> deberan enviarse a la base de datos de bugs de
bugs de Apache a menos que est seguro de haber encontrado un
problema en el cdigo 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="Espaol"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Franais"> 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>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licencia bajo los trminos de <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Mdulos</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();
}
//--><!]]></script>
</body></html>