Trabalhando com PHP e MySQL: Uma Introdução (página 2)

mysql> SELECT * FROM guestbook;

+-------+-------+-------------+--------------------+---------------------+

| id | nome | localizacao | mensagem | data |

+-------+-------+-------------+--------------------+---------------------+

| 00001 | Eitch | Makai | (Mensagem cortada) | 2002-09-19 17:42:53 |

| 00002 | Hugo | Japão | (Mensagem cortada) | 2002-09-19 17:43:13 |

+-------+-------+-------------+--------------------+---------------------+

2 rows in set (0.00 sec)

mysql> UPDATE guestbook SET localizacao='Brasil' WHERE id='00002';

Query OK, 1 row affected (0.01 sec)

Rows matched: 1 Changed: 1 Warnings: 0

mysql> SELECT * FROM guestbook;

+-------+-------+-------------+--------------------+---------------------+

| id | nome | localizacao | mensagem | data |

+-------+-------+-------------+--------------------+---------------------+

| 00001 | Eitch | Makai | (Mensagem cortada) | 2002-09-19 17:42:53 |

| 00002 | Hugo | Brasil | (Mensagem cortada) | 2002-09-19 17:43:13 |

+-------+-------+-------------+--------------------+---------------------+

2 rows in set (0.00 sec)

mysql>

Ok então, viu só como eu atualizei os dados? As instruções SQL são bem fáceis, principalmente para quem sabe inglês, pois você consegue 'ler' coerentemente o que está tentando dizer ao banco de dados para fazer. No caso da atualização, pedimos ao banco de dados para atualizar a tabela 'guestbook', mudando o campo localizacao para 'Brasil' nas linhas que tiverem o 'id' igual à 00002. Isso só vai atualizar a linha 2. Se não tivesse a instrução 'WHERE', todos os campos localizacao de todas as linhas seriam mudados para 'Brasil'.

E por último, percebemos que a segunda linha ficou uma porcaria, e que realmente eu não era para estar localizado no Brasil, a mensagem que deixei é ruim, e o meu nome é feio. Então para aliviar todos estes danos, vamos excluir essa linha do banco de dados. Fazemos isso assim:

mysql> DELETE FROM guestbook WHERE id='00002';

Query OK, 1 row affected (0.00 sec)

Pronto! Nos livramos da segunda linha, ficamos apenas com a primeira mesmo. Usamos o comando "SELECT" para visualizar os dados da nossa tabela. Com este comando podemos requisitar apenas determinados campos, na ordem que quisermos. Veja o exemplo a seguir:

mysql> select id,nome,localizacao FROM guestbook;

+-------+-------+-------------+

| id | nome | localizacao |

+-------+-------+-------------+

| 00001 | Eitch | Makai |

+-------+-------+-------------+

1 row in set (0.00 sec)

mysql>

Agora vou adicionar uma série de linhas com vários dados diferentes, para que possamos testar mais consultas. Depois de criado mais ou menos 10 linhas diferentes, vamos testar algumas coisas legais do comando SELECT:

A função MySQL COUNT(*) conta quantas linhas tem na nossa tabela. No nosso exemplo aqui foram 11 linhas. Logo em seguida a consulta pediu os campos id,nome e localizacao da tabela guestbook, ordenando por ordem alfabética no campo nome. Agora vamos salvar todo o conteúdo de nosso banco de dados em um arquivo texto com todos os comandos. Chamamos este arquivo de arquivo dump, e criamos ele da seguinte maneira no prompt de comando:

$ mysqldump -u root -p guestbook > guestbook.sql

O arquivo guestbook.sql será criado, e se você editá-lo com um edito de texto comum, verá que ele contém vários comandos SQL para criar as tabelas do banco de dados e colocar os dados nestas tabelas. Se por acaso você precisar importar estes dados para o seu banco de dados, você usa o

seguinte comando:

$ mysql -u root -p guestbook < guestbook.sql

E já que criamos um backup de todas as nossas tabelas e todos os nossos dados, podemos deletar todos os dados da tabela guestbook com o seguinte comando:

mysql> DELETE FROM guestbook;

Query OK, 0 rows affected (0.00 sec)

mysql>

Como não temos o "WHERE", isso vai deletar todos os dados da nossa tabela guestbook :-) Mas se quisermos restaurar os dados é só utilizar o arquivo .sql que criamos acima. Outros comandos que você poderá usar no cliente MySQL:

mysql> SHOW TABLES;

+---------------------+

| Tables_in_guestbook |

+---------------------+

| guestbook |

| teste |

+---------------------+

1 row in set (0.00 sec)

mysql> DROP TABLE teste;

Query OK, 0 rows affected (0.00 sec)

mysql>

Aqui respectivamente eu mostrei as tabelas que estava no banco de dados guestbook (criei uma outra tabela chamada teste só para ilustrar) e depois excluí (DROP) a tabela teste do banco de dados.

Deu para perceber como se trabalhar com MySQL? É bem fácil, mas recomendo que você olhe um pouco da documentação do programa, para obter mais dicas. Ao longo do nosso exemplo de livro de visitas, novas dicas irão surgir. Todas as instruções aprendidas neste tópico serão usadas no nosso exemplo, já que o PHP vai mandar para o servidor exatamente estas strings que colocamos no prompt do MySQL. Vamos com calma que você vai entender.

Antes de mais nada vamos testar o funcionamento do PHP. O PHP vem com uma função bem simples para mostrar que está funcionando. Suponhamos que o seu servidor já esteja configurado para rodar PHP em todos os arquivos com extensão .php, então vamos criar dentro do diretório de páginas do seu servidor web um arquivo chamado phpinfo.php, com o seguinte conteúdo:

<?
// PHP Info: Mostra informações sobre o PHP instalado na máquina
phpinfo();
?>

Vejamos... Note que para linhas comentadas (ignoradas pelo interpretador, servindo apenas de comentários ou explicações), o PHP utiliza duas barras (//). Bem ao estilo C, pois ele também suporte comentários de múltiplas linhas, como o a seguir:

<?
/*
-----------------------------------------------------------------
Este é um comentário com múltiplas linhas, igual aos comentários
da linguagem C. Isto tudo será ignorado no código.
-----------------------------------------------------------------
*/
phpinfo();
?>

Depois de salvo o phpinfo.php, coloque o endereço dele no browser e você vai ver várias informações mostradas pelo PHP. Esta função é muito útil para quem quer saber como o PHP foi compilado, com suporte a que, a versão dele, variáveis de ambiente, entre outros. O próximo passo para entender melhor como funciona o PHP, é saber que ele trabalha junto com HTML. Nos exemplos anteriores você pôde notar que começamos o código PHP com a tag <? e terminamos com a tag ?>. Isso significa que podemos colocar código HTML quando não estivermos dentro desta tag PHP. Veja o exemplo abaixo:

Copie este exemplo para uma página PHP e aponte no browser. Veja que eu misturei código HTML com PHP, e isso é muito comum neste tipo de linguagem para Web. Isso torna o PHP muito flexível

para poder ir colocando código onde quiser, misturando sempre com a saíde em HTML. É sempre bom você separar código de design HTML, mas isso se faz usando Templates, que é um passo mais complicado, que não iremos falar neste tutorial.

Vimos neste exemplo acima pouca coisa, mas vale notar que usamos a função echo do PHP, que imprime a string no output, ou seja, na página HTML. Mas precisamos de algo mais "complexo" para fazer o nosso guestbook funcionar. Como estamos trabalhando com MySQL, usaremos as funções MySQL incorporadas como módulo ao PHP. Pra não ficar muito chato, vamos para um exemplo:

O resultado disso, de acordo com os dados que colocamos no nosso banco de dados, será o seguinte:

Viu como ficou legal? Extraímos os dados da nossa tabela guestbook no banco de dados guestbook, e colocamos numa tabela HTML, para visualização no browser. Bem fácil não? Não? Ah! Também, eu esqueci de explicar direito o que o código faz... Tá bom, vamos lá.

As primeiras linhas do código configuram uma array com as mensagens de erro que vou usar depois. Se você ainda não conhece o que é uma array, uma array é um tipo especial de variável que contém vários valores. No caso criamos a array $msg, que tem duas outras variáveis dentro dela. A 0 representa a mensagem de erro de que não foi possível conectar ao servidor MySQL, e a 1 representa a mensagem de que não foi possível selecionar o banco de dados. Mais para frente, usaremos array mais uma vez. Aliás, se você for programar em PHP, com certeza você ainda vai usar muita array em sua vida.

Depois é que a começa a esquentar. Começamos a usar as funções MySQL do PHP. A função mysql_pconnect() abre a conexão com o banco de dados, e aponta esta conexão para a variável $conexao. Esta variável será usada mais tarde para os outros comandos do MySQL. Note também que nesta conexão, foi preciso você informar o host/ip onde o servidor MySQL está rodando, o usuário para se conectar e a senha deste usuário. Se por alguma razão o PHP não conseguir estabelecer a conexão, ele irá chamar a função die(), que termina o script PHP e gera uma mensagem no browser, que no nosso caso vai ser o conteúdo da array $msg[0].

Já a função mysql_select_db(), você seleciona o banco de dados que usará. O primeiro parâmetro indica o nome do banco de dados que você quer usar, e o segundo a variável de referência que usamos para identificar a conexão com o banco de dados MySQL, que aqui no nosso tutorial nomeamos de $conexao. Caso ele não consiga selecionar o banco de dados, ele chama a função die(), mostrando o conteúdo da array $msg[1].

Agora vem a parte interessante. Lembra da flexibilidade do PHP, em que você pode sair e entrar do código PHP livremente? Então na parte que se segue você viu um exemplo disso. Saímos do "Modo PHP", e colocamos as tags HTML para iniciar uma tabela. Colocamos as colunas ID, Nome e Localização, que são os dados que iremos pegar do banco de dados.

Depois entramos no "Modo PH" novamente, e fazemos uma consulta no banco de dados MySQL e colocamos o resultado em uma variável. Como você pode ver, a função mysql_query() é responsável pela consulta no banco de dados MySQL. Então você irá utilizar esta função para fazer todas as coisas, selecionar, inserir, excluir, etc, como aprendemos anteriormente no prompt do

MySQL. Tudo que você digitou no prompt do MySQL também é válido como primeiro parâmetro da função myqsl_query(). No caso usamos um exemplo que já usamos anteriormente.

A seguir vem o truque. O laço while vai fazer o trabalho de pegar cada linha do resultado da nossa consulta MySQL e transformar em array (não falei que iríamos usar mais uma vez?). A função mysql_fetch_array() transforma esse resultado de consulta em array. Como temos 11 linhas, o laço vai se repetir 11 vezes. Os dados da linha no banco de dados será identificados na array $linha. Então identificamos o dado utilizando $linha['nome_do_campo'], ou seja, $linha['id'], $linha['nome'] e $linha['localizacao']. Colocamos isso em uma linha de tabela.

Depois de passado cada linha, totalizando 11 linhas, o laço while acaba e o código PHP continua, chamando a tag que finaliza a tabela, que é o

Pronto! Extraímos os dados do banco de dados. Fácil né? Com isso deu pra entender melhor como o PHP trabalha com bancos de dados. Agora vamos ao exemplo que realmente interessa...

Vamos agora criar o Livro de Visitas em si. Vamos usar dois arquivos, um para a visualização do livro de visitas, e outro para a inclusão de uma mensagem no livro de visitas. Vou já incluir todo o código pronto do programa, fragemntado em partes para a explicação. Os comentários também são esclarecedores.

Ok, vamos primeiro à Inclusão! Crie um arquivo chamado assinar.php e mãos à obra:

Deu para perceber mais ou menos como funciona o código acima? Repare como eu faço muito o uso do controle de fluxo if. No começo o if testa se o usuário postou algum formulário. Para fazer isso, ele verifica se a variável $REQUEST_METHOD é igual à "POST". Se for "POST", quer dizer que o usuário postou alguma coisa através de um formulário, e se for "GET", quer dizer que a requisição da página foi feita pelo modo normal, sem postar nada.

Depois o código testa com o if novamente para ver se o usuário preencheu todos os campos. Para fazer isso ele testa se existe as variáveis correspondentes aos campos de formulário existente na nossa página. Caso aqueles campos estejam todos preenchidos, o código conecta ao servidor MySQL, seleciona o banco de dados que queremos, e depois constrói uma consulta SQL, incluindo os dados na tabela do banco de dados. A parte de inclusão do servidor MySQL não é nova para nós, que já vimos o procedimento anteriormente.

Agora algo interessante. Depois que tudo tiver feito, precisamos redirecionar o navegador do nosso visitante para outro lugar. Para fazer isso, usamos a função header() do PHP, que como o nove diz, manda um cabeçalho para o navegador do visitante. A função header só pode ser usada no começo dos scripts, sem que nada tenha sido impresso no navegador do cliente. Esta é uma restrição do próprio protocolo HTTP, e não do PHP, pois o cabeçalho sempre tem que vir antes né! :) No nosso caso, enviamos o cabeçalho "Location:", que diz ao navegador para onde ele tem que ir. Então depois que o código inclui os dados no banco de dados MySQL, ele redireciona o navegador para a página ler.php. Pode-se colocar qualquer URL válida no cabeçalho "Location:". Então, continuando o código, se tudo der certo, ele vai para a página de leitura, mas se for o caso dele não ter preenchido os campos, ou se ele não enviou nada por algum campo de formulário, o resto do código é executado.

O resto do código é a página HTML em si, com os formulários para preenchimento e este tipo de coisa. Os comentários no código explicam como o fluxo do if pode ser útil para por exemplo, mostrar uma mensagem de erro, se houver um erro claro.

Agora vamos para o ler.php, que vai ser a página onde irá se mostrar as assinaturas do livro de visitas! Vamos ao arquivo:

Apesar de que no código já há vários comentários explicando a funcionabilidade das linhas, vamos dar uma olhada geral no que este arquivo PHP faz. Antes de mais nada, o código verifica se existe a variável $begin, obtida pelo método HTTP GET (requisição normal HTTP, enquanto que o método POST é por formulário). Esta variável será usada mais adiante para saber quais mensagens serão mostradas para o usuário. Se a variável não existir, dá-se o valor de 0 para que ele comece da "primeira" mensagem.

Depois é hora de pegar as mensagens do servidor de banco de dados e colocá-las em variáveis para imprimirmos na página, colocando assim as assinaturas do livro de visitas. Para fazer isso, primeiro conectamos ao servidor de banco de dados, e selecionamos o banco de dados. E antes de consultar todas as mensagens, pegamos também o número total de mensagens, através da função count() do MySQL, como você pode ver no código. Esta função irá retornar quantas linhas tem na tabela em que se fez a consulta, ou seja, a tabela guestbook. Esse número total será usado junto com o $begin para poder ser usada na mostragem das mensagens para o usuário...

...Que será agora! Com um raciocínio simples, e alguns controles de fluxo com o if, podemos criar links diferentes. O que queremos fazer é que se estiver sendo mostrada desde a primeira mensagem, o link de "mensagens anteriores" não será mostrado, e sim apenas o de "próximas mensagens". A mesma coisa é feita com as próximas mensagens, só que dessa vez não aparece o link se estiver mostrando a última mensagem. Como a vida é cruel, não vou explicar detalhadamente como essa parte do código funciona, porque aprender a ler o código e entender é uma parte essencial. É mais difícil eu explicar do que você entender sem ler a explicação :)

O que vem agora é finalmente a mostragem de mensagens. Usaremos aqui dois atributos do MySQL que não conhecemos, que é o DESC e o LIMIT. Então construímos a consulta do MySQL e armazenamos seu resultado na variável $query. Depois vem o interessante, fazemos um laço com a função while() do PHP e a cada linha que se tem na nossa consulta (no nosso caso, cada mensagem), se criaria uma array chamada $linha com os valores de cada linha. No nosso caso, o while() faria com que se imprimisse no navegador uma tabela HTML para cada mensagem do nosso livro de visitas.

Repare também que como não queremos que se mostre todas as linhas da tabela MySQL na nossa consulta, usamos o atributo LIMIT, que como o nome diz, especifica um limite para a quantidade de linhas que será retornada. O formato deste atributo é LIMIT inicio,quantidade. No nosso caso, o inicio é a mensagem inicial, que temos através da variável $begin discutida anteriormente. E como queremos mostrar apenas 20 mensagens, colocamos o número 20, para se mostrar 20 mensagens. É como se disséssemos por exemplo: "Limite a consulta para 20 linhas, começando da linha 0."

Outra coisa que queríamos no nosso livro de visitas, é que as últimas assinaturas seriam mostradas primeiro. Então na consulta que fizemos no MySQL, usamos o atributo DESC, que quer dizer "decrecente". Isso já diz tudo, ele inverte a ordem das linhas e vai na ordem descrecente. E além desse, vou deixar de comentar também o uso da função explode(), que usei na formatação da data do MySQL, assim você poderá pesquisar melhor e entender como ela funciona. Só uma definição rápida e objetiva: ela cria uma array com a separação de uma string delimitada por um certo caracter que você mesmo especifica! Oops, eu disse tudo!