Está en la página 1de 14

Introduccin al libro de visitas con PHP y MySQL

Primeras notas y referencias previas de inters antes de mostrar el funcionamiento del ejercicio. Ante las numerosas peticiones de nuestros lectores de comentar un cdigo para hacer un libro de visitas a lo largo de la vida de este sitio, nos hemos decidido a realizar este manual sobre la creacin de un libro de visitas, programado en PHP y con base de datos MySQL.

Es un libro de visitas muy similar al que utilizamos en DesarrolloWeb, en la URL: desarrolloweb.com/librovisitas/, simplificado un poco y con unos campos de formulario un poco ms generales, para que pueda servir en el mayor nmero de sitios web de la temtica ms variada. El resultado final de este ejercicio se puede ver funcionando en una pgina aparte. Es totalmente funcional y se puede probar para hacerse una idea exacta del objetivo del manual. Este ejercicio se puede seguir con unos conocimientos mnimos de PHP, de modo que est al alcance de cualquier persona que se haya iniciado en este interesante lenguaje de programacin de pginas de servidor. No obstante, antes de comenzar, merece la pena mostrar algunas referencias a manuales que nos pueden ayudar a entender los scripts tratados. Manual de PHP: http://www.desarrolloweb.com/manuales/12/ Con los temas ms bsicos sobre la tecnologa, que todos los lectores deberan conocer. Taller de MySQL: http://www.desarrolloweb.com/manuales/34/ Con ayudas para trabajar con el gestor de base de datos utilizado en este ejemplo. La informacin se complementa con la seccin PHP a Fondo, donde podemos encontrar enlaces a todos los recursos PHP disponibles en DesarrolloWeb.com.

Cmo funciona nuestro script para la creacin de un libro de visitas con PHP y MySQL.
Veamos el diagrama de funcionamiento de la aplicacin de libro de visitas en PHP para hacernos una idea inicial, que completaremos ms adelante con el cdigo de cada script. Vamos a basar todo el trabajo en una misma pgina, que ser la encargada de mostrar todas las firmas de los visitantes y recoger los datos venidos por el formulario de participacin para introducirlos en la base de datos. Esto puede complicar un poco el cdigo del ejercicio final pero veremos el script por partes para que resulte sencillo. Ahora tan slo tenemos que entender su estructura general.

Diagrama del funcionamiento del libro de visitas en PHP

Explicacin

La pgina del libro de visitas puede o no recibir datos por un formulario y dependiendo de ello, debera hacer unas u otras acciones. Por tanto, lo primero que vamos a hacer es averiguar si recibimos o no datos por el formulario.

1) Si no recibe datos del formulario

Muestro las ltimas 10 firmas del libro de visitas. Esto lo conseguiremos con un acceso a la base de datos y un bucle que recorre los resultados de la bsqueda.

En el caso de que no se reciba datos, despus de mostrar las ltimas firmas, debemos saber si existen o no ms firmas en la base de datos para visualizar.

1.1) Si existen ms firmas, muestro el mensaje para verlas. 1.2) Si no existen ms firmas, no hago nada.

Por ltimo, coloco el formulario de firma para que los visitantes puedan participar.

2) Si recibo datos por el formulario

Esto quiere decir que el visitante ha rellenado el formulario de firma del libro y lo ha enviado. Entonces debo registrar esta firma, aunque es muy importante que se realice una pequea comprobacin y arreglo de los datos del formulario para evitar que un usuario malicioso intente fastidiar el script insertando ciertos elementos susceptibles de arrojar errores como etiquetas HTML o PHP. Entre las comprobaciones tambin nos aseguraremos, por ejemplo, de que el usuario ha escrito algn dato en el formulario, pero veremos todas estas comprobaciones ms tarde.

2.1) Si los datos eran correctos

Si todas las comprobaciones fueron positivas, introduciremos los datos en el formulario y daremos las gracias al visitante por firmar el libro

2.2) Si los datos no eran correctos

Advertiremos al visitante que debe rellenar los campos correctamente.

La base de datos en un sistema MySQL necesaria para la realizacin de un libro de visitas.


Para el trabajo con el libro de visitas, como ya se ha apuntado, se requerir el uso de una base de datos. Bueno, en realidad lo que necesitaremos es contar con una tabla adicional para la base de datos que ya contenga tu sitio web.

Referencia: El trabajo con base de datos est relatado en el manual de Programacin en PHP. En el mismo manual tambin disponemos de algunas indicaciones prcticas que explican como dar colocar una base de datos en el servidor remoto.

Por ltimo, sealaremos que en el manual prctico del Sistema de Envo de Postales, tenemos ms explicaciones sobre como crear una base de datos de manera prctica.

La tabla librovisitas_php

En este ejercicio deberemos crear una tabla con la informacin de las firmas. La llamaremos librovisitas_php y contendr los siguientes campos:

Nombre del campo Id_librovisitas_php nombre

Tipo int(11)

varchar(150)

email varchar(100) valoracion comentario tinyint(4) text

El campo id_librovisitas_php ser un campo autonumrico, que ser la clave primaria de la tabla. Los campos nombre y email sern de tipo cadena de texto, con 150 y 100 caracteres de tamao mximo respectivamente. El campo valoracin guardar un nmero, en este caso de tamao pequeo (tinyint) porque slo vamos a guardar nmeros del 1 al 5. Por ltimo el comentario, que es una cadena de texto con longitud indeterminada.

La tabla la podremos crear en nuestro servidor de bases de datos con la siguiente sentencia Crearte Table:

CREATE TABLE librovisitas_php ( id_librovisitas_php int(11) unsigned NOT NULL auto_increment, nombre varchar(150) NOT NULL, email varchar(100) NOT NULL, valoracion tinyint(4), comentario text, PRIMARY KEY (id_librovisitas_php) );

Cdigo para mostrar las firmas que nuestro libro de visitas haya registrado .

Recordando la explicacin general de este ejercicio, nos acordaremos de que la pgina del libro de visitas tena dos grandes bloques, que se decidan comprobando si se recibe o no algo por el formulario. Para ello podemos utilizar un enunciado if como este:

if (!$HTTP_POST_VARS)

En caso de no recibir datos por el formulario este if se evaluara con resultado positivo. Prestar atencin a la negacin para entender la correcta evaluacin del if.

En este captulo vamos a relatar la parte del if en la que no se reciben datos por un formulario, es decir, la evaluacin positiva del if.

Extraer las ltimas firmas

En este caso, lo primero a realizar es la extraccin de las ltimas firmas de la base de datos. Para ello debemos construir una sentencia SQL que seleccione de la base de datos dichas firmas.

//si no recibo nada por el formulario de firma del libro, muestro las firmas del libro //construyo la sentencia SQL $ssql = "SELECT * FROM librovisitas_php";

//se mostrarn las ltimas firmas, aunque habr un enlace en la parte de abajo que se podr pulsar para ver ms firmas if (isset($_GET["vermas"])) $ssql .= " where id_librovisitas_php<=" . $vermas;

//ordeno la sentencia y limito el numero de resultados $ssql .= " ORDER BY id_librovisitas_php desc limit 11";

//tomo el juego de resultados $resultid = mysql_query($ssql,$conn);

Esta sentencia se construye en varias partes. Primero se crea la primera parte del select y luego otras partes ms complicadas de ver.

Ser necesario un inciso para entender la parte en la que se evala si existe o no la variable vermas, recibida por URL ($_GET["vermas"]). Esto viene porque en la parte de debajo de las firmas, en caso de que existan ms firmas de las que se hayan mostrado, se colocara un enlace para ver ms firmas, que contendra una referencia a este propio libro de visitas con la variable vermas igual al identificador de la prxima firma que haya que visualizar. Algo como librovisitas/index.php?vermas=960

Si habamos recibido la variable vermas, seleccionamos tan solo las firmas que tengan el identificador menor o igual que el ndice recibido en vermas.

Las firmas se deben ver en orden descendente, para que se muestren primero las ltimas firmas insertadas. Es lo que se indica en la parte que pone ORDER BY. Adems se deben seleccionar tan solo 10 firmas por pgina, aunque en la prctica seleccionaremos 11, aunque la ltima no se mostrar, slo se extrae para saber el ndice que tiene y utilizarlo para construir el enlace vermas, en caso de que existan otras firmas por visualizar.

En la ltima lnea se ejecuta la sentencia SQL para extraer los datos.

Bucle While

Se realiza a continuacin un bucle para recorrer los resultados. Es un sencillo recorrido por un conjunto de resultados de una consulta a base de datos. Tiene la particularidad de que se cuentan los resultados mostrados para, en caso de que se hayan mostrado ya 10, no seguir mostrando ms.

while (($damefila=mysql_fetch_object($resultid)) && ($num_filas<10))

{ ?> <table align="center" width="100%" cellspacing="2" cellpadding="0" border="0"> <tr> <td valign="top" class=fuente8><b> <? //si el visitante no introdujo nombre muestro como nombre "Annimo" if ($damefila->nombre == "-"){ echo "Annimo"; }elseif ($damefila->email != "-") { echo '<a href="mailto:' . $damefila->email . '">' . $damefila->nombre . '</a>'; }else{ echo $damefila->nombre; } ?></b>:<br> </td></tr> <tr><td bgcolor=cccccc colspan="2"><img src="images/pixeltrans.gif" width=1 height=1 border="0"></td></tr> <td class=fuente8 valign="top"> <?echo strip_tags($damefila->comentario)?> <td valign="top" align="right" nowrap class=fuente8> Valoracion: <?echo $damefila->valoracion?> </td> </tr> </table>

<br> <?

$num_filas++; } //termina el bucle while

Los resultados se muestran en una tabla, por eso puede quedar un poco embarullado este cdigo en medio de tantas etiquetas HTML, pero no reviste ninguna complicacin especial.

Mostrar el enlace de vermas

Al final de la pgina, si haba ms firmas por ver, hay que mostrar el enlace de vermas. Para ello simplemente evaluamos la variable que contiene el puntero al registro actual. Si el bucle anterior finaliz porque dicho puntero haba llegado al final de la lista de valores, entonces es que no hay ms firmas que ver. Si por el contrario, el bucle finaliz y todava quedaba alguna firma en el puntero es que hay que mostrar el enlace de vermas y colocar el ndice de la firma que tocara visualizar a continuacin.

//si quedan ms valoraciones en el conjunto de resultados, muestro el enlace de "Ver ms" if ($damefila) echo "<div align=center><b><a href=\"index.php?vermas=$damefila->id_librovisitas_php\">Ver ms mensajes</a></b></div><br>";

Mostrar el formulario de firma

Por ltimo se debera mostrar el formulario de la firma. Nosotros lo hemos separado en un fichero aparte para que quede todo ms organizado. En el cdigo de nuestro ejercicio en esta seccin, lo nico que encontraremos ser el include con el archivo HTML que contiene el formulario.

include ("formul_mensaje.html");

Cdigo HTML del formulario que utilizamos para la creacin de un libro de visitas con PHP y MySQL.
El cdigo del formulario para que los visitantes puedan incluir su firma en el libro de visitas es el siguiente.

<form name=librovisitas action="index.php" method="post"> <table width="100%" cellspacing="0" cellpadding="0" border="0"> <tr> <td class=titcol> <b>Firma el Libro de Visitas</b></td> </tr> <tr> <td class=fuente8> Djanos tu mensaje en el libro de visitas y danos tu opinin del sitio <br> <br> </td> </tr> <tr> <td> <table width="100%" cellspacing="0" cellpadding="0" border="0"> <tr> <td class=fuente8 align="center"> Nombre <br> <input type="Text" name="nombre" size="20" maxlength="150"> <br> <br> Email

<br> <input type="Text" name="email" size="20" maxlength="100"> <br> <br> Valoracin <br> <select name="valoracion"> <option value=1>Repelente <option value=2>Mal <option value=3 selected>Regular <option value=4>Bien <option value=5>Fantstica </select> </td> <td ALIGN=CENTER class=fuente8 valign="middle"> Comentarios: <br> <textarea name="comentario" cols="30" rows="7"></textarea> </td> </tr> <tr> <td colspan=2 align=center class=fuente8> <br> <input type="submit" value=" Enviar la firma al libro de visitas "> </td> </tr>

</table> </td> </tr> </table> </form>

No reviste ninguna complicacin para entenderlo. Simplemente deberemos conocer un poco la forma de crear formularios HTML.

Antes de insertar los datos recibidos por el formulario en la aplicacin Libro de Visitas, debemos de comprobar que la informacin es correcta, es decir, que los datos recibidos son vlidos.
La otra parte del script del libro de visitas en PHP que nos queda por comentar contiene la codificacin de las acciones a tomar en caso de que s se reciban datos del formulario. Dichas acciones son bsicamente comprobar si los datos son correctos y, si as es, insertar la informacin en la base de datos.

Las comprobaciones sirven para asegurarnos que la informacin introducida va a ser siempre vlida, para que las firmas se muestren perfectamente. Determinadas informaciones podran dar lugar a errores al introducir la informacin en la base de datos o a la hora de mostrar las firmas en la pgina.

Eliminar las etiquetas HTML o PHP

Es muy importante borrar toda etiqueta HTML o PHP del texto de los campos introducidos por el visitante. Si un visitante colocase este comentario:

Hola <b>Amigos</b>

Tendra como resultado que, al visualizar sui firma, se mostrase la palabra "Amigos" en negrita. Esto no sera mucho problema, pero si se puede incluir una etiqueta as, tambin nos podran colar enlaces, imgenes o determinados elementos que pudieran descolocar la pgina, cambiar

nuestros estilos habituales o incluir scripts que pudieran molestar a otros visitantes o a los administradores del sitio web.

//eliminamos las etiquetas HTML y PHP de las cadenas de texto $nombre = strip_tags($_POST["nombre"]); $email = strip_tags($_POST["email"]); $comentario = strip_tags($_POST["comentario"]);

Cortamos las cadenas demasiado largas

Para no intentar introducir textos en la base de datos que en realidad no caben, recorto los textos hasta su tamao mximo.

//Cortamos las cadenas demasiado largas $nombre=substr($nombre,0,150); $email=substr($email,0,80);

Comprobamos que el visitante ha rellenado algo

Tambin debemos comprobar que todos los campos introducidos no estn vacos, porque en ese caso querra decir que el usuario est tratando de firmar con ningn dato sobre su nombre o comentarios del web y no deseamos que eso ocurra.

<? if (strlen($nombre)==0 and strlen($email)==0 and strlen($comentario)==0) { ?>

<div align="center"><b>Gracias por el envo</b>.<br><br>Te agradeceramos, no obstante y si no resulta mucho esfuerzo, que rellenases alguno de los campos para dejar constancia de tu visita.</div> <? } ?>

Si no haba rellenado nada mostramos un mensaje advirtindolo. En el caso contrario, es decir, si todo era correcto, inserto en la base de datos la informacin.

Una vez comprobados que los datos son correctos, los inserto en la tabla del libro de visitas.
Si todas las comprobaciones fueron correctas, se introduce en la base de datos del libro de visitas la informacin recibida como firma.

Pero antes se realizar un pequeo ajuste adicional de los datos a introducir.

//si alguno de los campos falta prefiero colocar un guin o "sin comentarios" if (!$nombre)$nombre="-"; if (!$email) $email="-"; if (!$comentario) $comentario="Sin comentarios";

Simplemente se hace esto para comprobar si alguno de los datos faltaba, pues en ese caso preferimos introducir un carcter o texto especial en lugar de introducir un string vaco.

Por cierto, la variable que guarda la valoracin de la pgina no hace falta comprobarla en teora, porque siempre la recibiremos bien, ya que el formulario contiene este valor en un campo SELECT de HTML, donde siempre se selecciona un valor vlido introducido por el usuario, entre los posibles, que los define el programador de dicho campo SELECT.

Luego se debe de codificar una sentencia SQL con un INSERT con los datos del formulario. La sentencia de insercin se realizar concatenando los datos del formulario con la propia sentencia SQL.

Referencia: Puede ser interesante para personas sin experiencia repasar el artculo donde se explican las inserciones en base de datos. Este artculo est englobado en el Manual de PHP de DesarrolloWeb.com.

Asmismo, tambin queremos sealar que para iniciarse en el lenguaje SQL tenemos publicado un Tutorial de SQL.

//Generamos la ssql e insertamos el registro $ssql = "INSERT INTO librovisitas_php (nombre,email,valoracion,comentario) VALUES ('" . $nombre . "','" . $email . "'," . $_POST["valoracion"] . ",'" . $comentario . "')"; mysql_query($ssql,$conn);

Por ltimo se muestra un mensaje dando las gracias al visitante que ha firmado el libro de visitas.

<div align="center"><b>Muchas gracias por tu participacin</b></div>

El cdigo completo del ejercicio se puede descargar aqu.

Se puede ver en marcha aqu.