• Olá Visitante, se gosta do forum e pretende contribuir com um donativo para auxiliar nos encargos financeiros inerentes ao alojamento desta plataforma, pode encontrar mais informações sobre os várias formas disponíveis para o fazer no seguinte tópico: leia mais... O seu contributo é importante! Obrigado.

Livro de visitas com PHP e MySQL

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
Construção de um livro de visitas utilizando a tecnologia de programação de páginas dinâmicas de servidor PHP e a base de dados MySQL.



Capítulos do manual1.- Introdução ao livro de visitas com PHP e MySQL
Primeiras notas e referências prévias de interesse antes de mostrar o funcionamento do exercício.


2.- Esquema de funcionamento do livro de visitas PHP
Como funciona nosso script para a criação de um livro de visitas com PHP e MySQL.


3.- A base de dados MySQL do livro de visitas
A base de dados em um sistema MySQL necessária para a realização de um livro de visitas.


4.- Mostrando as assinaturas do livro de visitas
Código para mostrar as assinaturas que nosso livro de visitas tenha registrado.


5.- O formulário para assinar o livro de visitas
Código HTML do formulário que utilizamos para a criação de um livro de visitas com PHP e MySQL.


6.- Comprovar se os dados recebidos são corretos
Antes de inserir os dados recebidos pelo formulário na aplicação Livro de Visitas, devemos comprovar que a informação é correta, ou seja, que os dados recebidos são válidos.


7.- Inserimos os dados na base de dados
Uma vez comprovado que os dados são corretos, os insiro na tabela do livro de visitas.

 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
Introdução ao livro de visitas com PHP e MySQL




Primeiras notas e referências prévias de interesse antes de mostrar o funcionamento do exercício.
Por Miguel Angel Alvarez - Tradução de JML





Ante os numerosos pedidos de nossos leitores de comentar um código para fazer um livro de visitas ao longo da vida deste site, decidimos realizar este manual sobre a criação de um livro de visitas, programado em PHP e com banco de dados MySQL.

É um livro de visitas simples e com uns campos de formulário um pouco mais gerais, para que possa servir ao maior número de websites das temáticas mais variadas.

O exercício que faremos pode ser seguido com conhecimentos mínimos de PHP, de modo que está ao alcance de qualquer pessoa que tenha iniciado nesta interessante linguagem de programação de páginas de servidor. Não obstante, antes de começar, vale a pena mostrar algumas referências a manuais que podem nos ajudar a entender os scripts tratados.


A informação se complementa também com outros dois manuais: Workshop de PHP e Manual de PHP 5
 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
Esquema de funcionamento do livro de visitas PHP



Como funciona nosso script para a criação de um livro de visitas com PHP e MySQL.
Por Miguel Angel Alvarez - Tradução de JML




Vejamos o diagrama de funcionamento da aplicação do livro de visitas em PHP para termos uma idéia inicial, que completaremos mais adiante com o código de cada script.

Vamos basear todo o trabalho em uma mesma página, que será a encarregada de mostrar todas as assinaturas dos visitantes e buscar os dados vindos pelo formulário de participação para introduzi-los na base de dados. Isto pode complicar um pouco o código do exercício final, mas veremos o script por partes para que seja simples. Agora somente temos que entender sua estrutura geral.

diagrama.gif



Explicação

A página do livro de visitas pode ou não receber por um formulário e dependendo disso, deveria fazer umas ou outras ações. Portanto, o primeiro que vamos fazer é averiguar se recebemos ou não os dados pelo formulário.

1) Se não recebe dados do formulário

Mostro as últimas 10 assinaturas do livro de visitas. Conseguiremos isto com um acesso à base de dados e um loop que percorre os resultados da busca.

No caso de que não receba os dados, depois de mostrar as últimas assinaturas, devemos saber se existem ou não mais assinaturas na base de dados para visualizar.
1.1) Se existem mais assinaturas, mostro a mensagem para vê-las.
1.2) Se não existem mais assinaturas, não faço nada.
Por último, coloco o formulário de assinatura para que os visitantes possam participar.

2) Se recebo dados pelo formulário

Isto quer dizer que o visitante preencheu o formulário de assinatura do livro e o enviou. Então devo registrar esta assinatura, embora seja também muito importante realizar uma pequena comprovação e/ou conserto dos dados do formulário para evitar que um usuário malicioso tente estragar o script inserindo certos elementos suscetíveis de provocar erros como etiquetas HTML ou PHP. Entre as comprovações também nos certificamos, por exemplo, de que o usuário escreveu algum dado no formulário, mas veremos todas estas comprovações mais tarde.
2.1) Se os dados eram corretos

Se todas as comprovações foram positivas, introduziremos os dados no formulário e daremos um obrigado ao visitante por assinar o livro.

2.2) Se os dados não eram corretos

Advertiremos ao visitante que deve preencher os campos corretamente.
 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
A base de dados MySQL do livro de visitas



A base de dados em um sistema MySQL necessária para a realização de um livro de visitas.
Por Miguel Angel Alvarez - Tradução de JML





Para o trabalho com o livro de visitas, como já apontamos, se requer o uso de uma base de dados. Bom, na verdade o que necessitaremos é contar com uma tabela adicional para a base de dados que já contenha seu web site.

Referência: O trabalho com base de dados está relatado no manual de Programação em PHP. No mesmo manual também dispomos de algumas indicações práticas que explicam como colocar uma base de dados no servidor remoto.

A tabela livrovisitas_php

Neste exercício deveremos criar uma tabela com a informação das assinaturas. Chamaremos de livrovisitas_php e conterá os seguintes campos:

Nome do campo Tipo
Id_livrovisitas_php int(11)
nome varchar(150)
email varchar(100)
valoracao tinyint(4)
comentario text

O campo id_livrovisitas_php será um campo auto-numérico, que será a chave primária da tabela. Os campos nome e e-mail serão do tipo cadeia de texto, com 150 e 100 caracteres de tamanho máximo respectivamente. O campo valoração salavrá um número, neste caso de tamanho pequeno (tinyint) porque só vamos salvar números do 1 ao 5. Por último, o comentário, que é uma cadeia de texto com longitude indeterminada.

Poderemos criar a tabela em nosso servidor de bases de dados com a seguinte sentença Crearte Table:

CREATE TABLE livrovisitas_php (
id_livrovisitas_php int(11) unsigned NOT NULL auto_increment,
nome varchar(150) NOT NULL,
email varchar(100) NOT NULL,
valoracao tinyint(4),
comentario text,
PRIMARY KEY (id_livrovisitas_php)
);
 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
Mostrando as assinaturas do livro de visitas


Código para mostrar as assinaturas que nosso livro de visitas tenha registrado.
Por Miguel Angel Alvarez - Tradução de JML





Recordando a explicação geral deste exercício, lembraremos que a página do livro de visitas tinha dois grandes blocos, que se decidiam comprovando se se recebe ou não algo pelo formulário. Para isso podemos utilizar um enunciado if como este:

if (!$HTTP_POST_VARS)

No caso de não receber dados pelo formulário este if se avaliaria com resultado positivo. Preste atenção na negociação para entender a correta avaliação do if.

Neste capítulo vamos relatar a parte do if na qual não se recebem dados por um formulário, ou seja, a avaliação positiva do if.

Extrair as últimas assinaturas

Neste caso, o primeiro a realizar é a extração das últimas assinaturas da base de dados. Para isso, devemos construir uma sentença SQL que selecione da base de dados tais assinaturas.

//se não recebo nada pelo formulário de assinatura do livro, mostro as assinaturas do livro
//construo a sentença SQL
$ssql = "SELECT * FROM livrovisitas_php";

//se mostrarão as últimas assinaturas, embora haja um link na parte debaixo que se poderá clicar para ver mais assinaturas.
if (isset($_GET["vermais"]))
$ssql .= " where id_livrovisitas_php<=" . $vermais;

//ordeno a sentença e limito o número de resultados
$ssql .= " ORDER BY id_livrovisitas_php desc limit 11";

//tomo o jogo de resultados
$resultid = mysql_query($ssql,$conn);

Esta sentença se constrói em várias partes. Primeiro, cria-se a primeira parte do select e logo outras partes mais complicadas de ver.

Será necessário um corte para entender a parte na qual se avalia se existe ou não a variável vermais, recebida por URL ($_GET["vermais"]). Isto vem porque na parte debaixo das assinaturas, no caso de existirem mais assinaturas das quais se tenham mostrado, se colocaria um link para ver mais assinaturas, que conteria uma referência a este próprio livro de visitas com a variável vermais igual ao identificador da próxima assinatura que tenha que se visualizar. Algo como livrovisitas/index.php?vermais=960

Se havíamos recebido a variável vermais, selecionamos somente as assinaturas que tenham o identificador menor ou igual que o índice recebido em vermais.

AS assinaturas devem ser vistas em ordem decrescente, para que se mostrem primeiro as últimas assinaturas inseridas. É o que se indica na parte que põem ORDER BY. Ademais se devem selecionar somente 10 assinaturas por página, embora na prática selecionaremos 11, apesar da última não se mostrar, só se extrai para saber o índice que tem e utiliza-lo para construir o link vermais, no caso de que existam outras assinaturas por visualizar.

Na última linha se executa a sentença SQL para extrair os dados.

Loop While

Realiza-se a seguir um loop para percorrer os resultados. É um simples percorrido por um conjunto de resultados de uma consulta a base de dados. Tem a particularidade de que se contam os resultados mostrados para, no caso de que se tenha mostrado já 10, não seguir mostrando mais.

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>
<? //se o visitante não introduziu nome mostro como nome "Anônimo"
if ($damefila->nome == "-"){
"Anônimo";
}elseif ($damefila->email != "-") {
echo '<a href="mailto:' . $damefila->email . '">' . $damefila->nome . '</a>';
}else{
echo $damefila->nome;
}
?></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>
Valoracao: <?echo $damefila->valoracao?>
</td>
</tr>
</table>

<br>
<?
$num_filas++;
} //termina o loop while

Os resultados se mostram em uma tabela, por isso pode ficar um pouco confuso este código no meio de tantas etiquetas HTML, mas não foi revisto nenhuma complicação especial.

Mostrar o link de vermais

Ao final da página, se havia mais assinaturas por ver, há que mostrar o link de vermais. Para isso, simplesmente avaliamos a variável que contém o ponteiro ao registro atual. Se o loop anterior finalizou porque tal ponteiro havia chegado ao da lista de valores, então é que não há mais assinaturas para ver. Se ao contrário, o loop finalizou e ainda faltava alguma assinatura no ponteiro é que há que mostrar o link de vermais e colocar o índice da assinatura que seria visualizada a seguir.

//se faltam mais valorações no conjunto de resultados, mostro o link de "Ver mais"
if ($damefila)
echo "<div align=center><b><a href=\"index.php?vermais=$damefila->id_lirovisitas_php\">Ver mais mensagem</a></b></div><br>";

Mostrar o formulário de assinatura

Por último, deveria ser mostrado o formulário da assinatura. Nós o separamos em um diretório a parte para que fique tudo mais organizado. No código de nosso exercício nesta seção, o único que encontraremos será o include com o arquivo HTML que contém o formulário.

include ("formul_mensagem.html");
 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
O formulário para assinar o livro de visitas



Código HTML do formulário que utilizamos para a criação de um livro de visitas com PHP e MySQL.
Por Miguel Angel Alvarez - Tradução de JML





O código do formulário para que os visitantes possam incluir sua assinatura no livro de visitas é o seguinte.

<form name=livrovisitas action="index.php" method="post">
<table width="100%" cellspacing="0" cellpadding="0" border="0">
<tr>
<td class=titcol> <b>Assine o Livro de Visitas</b></td>
</tr>
<tr>
<td class=fuente8> Deixe sua mensagem no livro de visitas e dê sua opinião do site
<br>
<br>
</td>
</tr>
<tr>
<td>
<table width="100%" cellspacing="0" cellpadding="0" border="0">
<tr>
<td class=fuente8 align="center">
Nome
<br>
<input type="Text" name="nome" size="20" maxlength="150">
<br>
<br>
Email
<br>
<input type="Text" name="email" size="20" maxlength="100">
<br>
<br>
Valoracao
<br>
<select name="valoracao">
<option value=1>Péssima
<option value=2>Ruim
<option value=3 selected>Regular
<option value=4>Boa
<option value=5>Fantástica
</select>
</td>
<td ALIGN=CENTER class=fonte8 valign="middle">
Comentarios:
<br>
<textarea name="comentario" cols="30" rows="7"></textarea>
</td>
</tr>
<tr>
<td colspan=2 align=center class=fonte8>
<br>
<input type="submit" value=" Enviar a assinatura ao livro de visitas ">
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>

Não há nenhuma complicação para entender isto. Simplesmente deveremos conhecer um pouco a forma de criar formulários HTML.
 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
Comprovar se os dados recebidos são corretos



Antes de inserir os dados recebidos pelo formulário na aplicação Livro de Visitas, devemos comprovar que a informação é correta, ou seja, que os dados recebidos são válidos.
Por Miguel Angel Alvarez - Tradução de JML




A outra parte do script do livro de visitas em PHP que nos falta comentar contém a codificação das ações a fazer no caso de que se recebem dados do formulário. Tais ações são basicamente comprovar se os dados são corretos e, se assim for, inserir a informação na base de dados.

As comprovações servem para assegurarmos que a informação introduzida vai ser sempre válida, para que as assinaturas se mostrem perfeitamente. Determinadas informações poderiam dar lugar a erros ao introduzir a informação na base de dados ou na hora de mostrar as assinaturas na página.

Eliminar as etiquetas HTML ou PHP

É muito importante apagar toda etiqueta HTML ou PHP do texto dos campos introduzidos pelo visitante. Se um visitante colocasse este comentário:

Olá <b>Amigos</b>

Teria como resultado que, ao visualizar sua assinatura, se mostrasse a palavra "Amigos" em negrito. Isto não seria um problema, mas se se pode incluir uma etiqueta assim, também poderiam colocar links, imagens ou determinados elementos que pudessem deslocar a página, mudar nossos estilos habituais ou incluir scripts que pudessem molestar a outros visitantes ou aos administradores do web site.

//eliminamos as etiquetas HTML e PHP das cadeias de texto
$nome = strip_tags($_POST["nombre"]);
$email = strip_tags($_POST["email"]);
$comentario = strip_tags($_POST["comentario"]);

Cortamos as cadeias muito longas

Para não tentar introduzir textos na base de dados que na verdade não cabem, recorto os textos até seu tamanho máximo.

//Cortamos as cadeias muito longas
$nome=substr($nome,0,150);
$email=substr($email,0,80);

Comprovamos que o visitante preencheu algo

Também devemos comprovar que todos os campos introduzidos não estão vazios, porque nesse caso queria dizer que o usuário está tratando de assinar com nenhum dado sobre seu nome ou comentários do web e não desejamos que isto ocorra.

<?
if (strlen($nome)==0 and strlen($email)==0 and strlen($comentario)==0)
{
?>
<div align="center"><b>Obrigado pelo envio</b>.<br><br>Agradecemos porém, se não for muito esforço, que preenchesse algum dos campos para deixar constância de sua visita.</div>
<?
}
?>

Se não havia preenchido nada mostramos uma mensagem avisando-o. Caso contrário, ou seja, se tudo está correto, insiro na base de dados a informação.
 

helldanger1

GForum VIP
Entrou
Ago 1, 2007
Mensagens
29,631
Gostos Recebidos
1
Inserimos os dados na base de dados


Uma vez comprovado que os dados são corretos, os insiro na tabela do livro de visitas.
Por Miguel Angel Alvarez - Tradução de JML



Se todas as comprovações foram corretas, se introduz na base de dados do livro de visitas a informação recebida como assinatura.

Mas antes se realizará um pequeno ajuste adicional dos dados a introduzir.

//se algum dos campos falta prefiro colocar um travessão ou "sem comentários"
if (!$nome)$nome="-";
if (!$email) $email="-";
if (!$comentario) $comentario="Sin comentarios";

Simplesmente se faz isso para comprovar se algum dos dados faltava, pois nesse caso preferimos introduzir um caractere ou texto especial ao invés de introduzir um string vazio.

Aliás, a variável que salva a valoração da página, teoricamente não precisa ser comprovada, porque sempre a receberemos bem, já que o formulário contém este valor em um campo SELECT de HTML, onde sempre se seleciona um valor válido introduzido pelo usuário, entre os possíveis, que os define o programador de tal campo SELECT.

Logo, devemos codificar uma sentença SQL com um INSERT com os dados do formulário. A sentença de inserção se realizará concatenando os dados do formulário com a própria sentença SQL.

Referência: Pode ser interessante para pessoas sem experiência repassar o artigo onde se explicam as inserções em base de dados. Este artigo está englobado no Manual de PHP de CriarWeb.com.

//Geramos a ssql e inserimos o registro
$ssql = "INSERT INTO livrovisitas_php (nome,email,valoracao,comentario) VALUES ('" . $nome . "','" . $email . "'," . $_POST["valoracao"] . ",'" . $comentario . "')";
mysql_query($ssql,$conn);

Por último mostra-se uma mensagem agradecendo ao visitante que assinou o livro de visitas.

<div align="center"><b>Muito obrigado pela sua participação </b></div>

 
Topo