| (C)ommon(G)ateway(I)nterface.
CGI no es más que una forma de COMUNICAR
información entre un servidor de web y un programa EJECUTABLE
NATIVO que está en la misma máquina que dicho servidor.
Comunicar información en ambos sentidos (parámetros
y resultados). No es un lenguaje, sólo una forma de pasar
información. Lo mismo que la línea de comandos del
sistema operativo. De ahí la "interfaz". Un programa
CGI puede estar hecho en CUALQUIER COSA siempre que:
1) Se ejecute en la máquina del servidor
2) Sea capaz de leer variables de entorno y la entrada estándar
del sistema operativo (concepto cuasi universal)
3) Sea capaz de escribir en la salida estándar del sistema
operativo
4) El servidor sea capaz de ejecutarlo (ej: en NT quizás
haya problemas para ejecutar un CGI gráfico)
Para crear el CGI se puede usar Visual Basic,
Perl, Rexx, Clipper, Visual C, Borland C, Delphi, etc...
Una vez creado el CGI en tu ordenador, lo pasas al servidor y lo
compilas allí.
El hecho de que CGI esté universalmente soportado ayuda a
que el fuente de un programa CGI pueda recompilarse y funcionar
en cualquier entorno. No obstante, eso dependerá mucho de
qué lenguaje se use para desarrollar el programa. Por ejemplo,
ISAPI sólo funciona[rá] en Windows.
1.1 Como crear un CGI
y ponerlo en tu página
Voy a describir aquí los pasos que
uso yo para compilar, copiar y ejecutar un CGI en C y en PERL. Según
el proveedor de hosting, puede que los pasos a seguir sean diferentes
pero no deberían variar mucho. Si tienes algun problema,
consulta con tu proveedor.
1.2.1 Si usas C...
1.2.1.1 Compilando
tu CGI
Para compilar el fichero en el servidor,
hay que pedir amablemente a los proveedores de hosting que nos den
una cuenta personal en users para compilar CGIs. Una vez obtenido
el permiso, podemos seguir con el ejemplo. Tenemos el fichero 'prueba.c'
en el directorio c:\pruebas.
Contenido del fichero 'prueba.c':
#include<stdio.h>
main()
{
printf("Content-type: text/html\n\n");
printf("<html><body>¡Esto funciona!</body></html>");
}
Este fichero imprime crea una página
web en la que pone:
¡Esto funciona!
Fijaros que en un CGI lo primero que hay
que poner es la cabecera, en este caso : Content-type: text/html\n\n
El '\n' es un retorno de linea. Siempre debe de haber 2.
Ahora nos conectamos con un programa de FTP
(recomiendo el FTP Cute) al directorio que se nos ha asignado en
users.
Copiamos el fichero 'prueba.c' en formato ASCII al directorio de
users que se nos haya asignado.
Una vez copiado y sin cerrar el FTP, abrimos
el Telnet. El Telnet lo puedes encontrar en tu disco duro en C:\WINDOWS
si usas Windows 95. Una vez ejecutado, nos conectamos a users.
Después de pasar por la petición de clave, ponemos
'dir' y pulsamos return.
Si lo hemos hecho todo bien, deberíamos de ver nuestro fichero
'prueba.c' en el directorio.
Ahora tecleamos 'gcc -o prueba.cgi prueba.c -s' para compilar el
fichero.
'gcc' invoca al compilador de ficheros C
'-o prueba.cgi' le dice el nombre del fichero a crear. Si nos olvidamos
de este parámetro, obtendremos un fichero llamado 'a.out'.
Si este es el caso, podemos teclear 'mv a.out prueba.cgi' para cambiarle
el nombre.
'prueba.c' es el nombre del fichero que vamos a compilar.
'-s' indica al compilador que reduzca todo lo posible el fichero
de salida.
Después de la compilación y
si tecleamos dir, deberíamos ver 2 ficheros: 'prueba.c' y
'prueba.cgi'. Salimos del Telnet.
1.2.1.2 Copiando el
CGI a tu página
Debemos de copiar el fichero 'prueba.cgi'
al directorio de nuestra página web. Si todavía tenemos
abierta la sesión FTP sólo hay que pulsar el botón
actualizar sesión.
Ahora copiamos el fichero 'prueba.cgi' a nuestro disco duro. Podemos
cerrar después la sesión FTP.
Abrimos otra sesión FTP, esta vez
hacia el directorio de nuestra página web y copiamos el fichero
'prueba.cgi' allí.
Ya tenemos el CGI en nuestra página
web. Si ahora vamos a un navegador y tecleamos la dirección
donde se encuentra el CGI lo ejecutaremos. Ejemplo:
http://www.jet.es/gregorio/prueba.cgi
Sin embargo recibiremos un molesto error.
Tranquilos, no pasa nada. Ahora lo solucionamos.
1.2.1.3 Darle permiso
de ejecución al CGI para ejecutarlo
Los sistemas UNIX tiene activada una opción
por defecto que anula la posibilidad de ejecución de cualquier
cosa a no ser que le dado a nuestro fichero un permiso especial.
Por eso antes recibíamos el molesto mensaje de error.
Para darle permiso, se puede usar el programa
de FTP. En el caso del FTP Cute, una vez vemos el fichero al que
queremos darle el permiso de ejecución, clickeamos en el
con el botón derecho del ratón y seleccionamos 'File
Attributes' del menú emergente.
Ahora hay que darle permiso de lectura o
lectura/escritura a nuestro CGI 'prueba.cgi'
Deberíamos recibir un mensaje advirtiéndonos que hemos
cambiado los atributos de un fichero.
Ahora si ejecutamos el CGI desde nuestro
navegador, deberíamos ver el esperado mensaje "¡Esto
funciona!".
1.2.2 Si usas PERL...
1.2.2.1 Creando tu
CGI
Como el Perl no es un lenguaje compilado
como el C, nos saltaremos la ardua tarea de compilar nuestro fuente.
Simplemente, crearemos un fichero de texto llamado prueba.txt. DEBERIAMOS
usar el procesador de textos más simple que tengamos a fin
de que no nos salve carácteres extra en el fichero como hacen
el Wordperfect o el Works. Se supone que vamos a usar el Notepad
de Windows 95 (también sirve el EDIT del MS-DOS siempre que
no usemos carácteres españoles como los acentos o
la eñe).
Contenido del fichero prueba.txt:
#!/usr/bin/perl
print "content-type: text/html\n\n";
print "<HTML>\n";
print "<HEAD>\n";
print "<TITLE>Aprendiendo a crear CGIs</TITLE>\n";
print "</HEAD>\n";
print "<BODY>\n";
print "Enhorabuena. Acabo de crear un CGI ¡y funciona!\n";
print "</BODY></HTML>\n";
Fijaros que en un CGI lo primero que hay
que poner es la cabecera, en este caso : Content-type: text/html\n\n
El '\n' es un retorno de linea. Siempre debe de haber 2.
1.2.2.2 Copiando el
CGI a tu página
Debemos de copiar el fichero 'prueba.txt'
al directorio de nuestra página web. Abrimos una sesión
FTP hacia el directorio de nuestra página web y copiamos
el fichero 'prueba.txt' allí.
Ya tenemos el CGI en nuestra página
web. Si ahora vamos a un navegador y tecleamos la dirección
donde se encuentra el CGI lo ejecutaremos. Ejemplo:
http://web.com/gregorio/prueba.txt
Sin embargo, veremos el fuente del fichero
como si fuese un texto normal. Tranquilos, no pasa nada. Ahora lo
solucionamos.
1.2.2.3 Solucionando
los problemas
La respuesta es sencilla: el navegador no
sabe que eso es un CGI. Pues no tenemos más que cambiar la
extensión de txt por cgi. La razón de no haberlo hecho
antes, es que nuestro programa de FTP DEBE transferir los archivos
con formato ASCII, es decir, simples ficheros de texto, si intentamos
copiar directamente el fichero con el nombre prueba.cgi, casi seguro
que no nos va a funcionar porque lo intenará transferir en
formato BINARIO.
En los sistemas UNIX, ningún programa
funciona hasta que le demos permiso de ejecución. Para darle
permiso, se puede usar el programa de FTP. En el caso del FTP Cute,
una vez vemos el fichero al que queremos darle el permiso de ejecución,
pinchamos en el con el botón derecho del ratón y seleccionamos
'File Attributes' del menú emergente.
Ahora hay que darle permiso de lectura o
lectura/escritura a nuestro CGI 'prueba.cgi'
Deberíamos recibir un mensaje advirtiéndonos que hemos
cambiado los atributos del fichero.
Si ejecutamos ahora el CGI desde nuestro
navegador, deberíamos ver el esperado mensaje de enhorabuena.
|
