Até pouco tempo a única biblioteca de gráficos que eu conhecia utilizava Flash e era bem complicada de mexer, a Fusion Charts, mas a alguns meses descobri uma biblioteca bem mais interessante a pChart que gera gráficos muito bonitos e de forma bem fácil. Então vamos parar de enrolação e vamos colocar a mão na massa.

Primeiro é claro vamos baixar o pChart. No zip vem vários arquivos, muitos de exemplos e etc. Só nos interessa as pastas class, que contém as classes PHP propriamente ditas, fontes com fontes diferenciadas para os rótulos dos gráficos, e palettes com cores predefinidas.

Gráfico em barra

include("pChart/class/pData.class.php");
include("pChart/class/pImage.class.php");

$data = new pData();
$data->addPoints( array( 10 , 20 , 30 , 40 , 30 , 20 , 10 , -10 , -20 , -30 ) , "Valores A" );
$data->addPoints( array( "Janeiro" , "Fevereiro" , "Março" , "Abril" , "Maio" , "Junho" , "Julho" , "Agosto" , "Setembro" , "Outubro" ) , "Meses" ); 

$data->setAbscissa("Meses");
$data->setAxisName(0,"Hits"); 

$myPicture = new pImage( 700 , 230 , $data );
$myPicture->drawRectangle( 0 , 0 , 699 , 229 , array( "R"=>0 , "G"=>0 , "B"=>0 ) ); 

$myPicture->setFontProperties( array( "FontName"=>"pChart/fonts/pf_arma_five.ttf" , "FontSize"=>6 ) ); 

$myPicture->setGraphArea(60,40,650,200); 

$scaleSettings = array( "GridR"=>200 , "GridG"=>200 , "GridB"=>200 , "CycleBackground"=>TRUE );
$myPicture->drawScale($scaleSettings); 

$myPicture->drawLegend( 580 , 12 , array( "Style"=>LEGEND_NOBORDER , "Mode"=>LEGEND_HORIZONTAL ) ); 

$myPicture->drawBarChart(); 

$myPicture->autoOutput('barra.png');

Nas linhas 1 e 2 incluímos os arquivos da classes pData e pImage que iremos utilizar.

Na linha 4 instanciamos um objeto pData que é o objeto que representa os dados de nosso gráfico é por ele que adicionaremos os valores no gráfico.

Na linha 5 adicionamos os valores das barras através do método addPoints , os valores são adicionados no 1º parâmetro em forma de array e o 2º parâmetro é o rotulo desta série de dados, o pChart aceita gráficos com vários séries ou seja várias barras por intervalo do eixo X.

Na linha 6 adicionamos mais valores, mas estes serão os rótulos que estarão no eixo X(iremos configurar isso na linha 9) então ele deve ter o mesmo número de valores no array dos valores das barras.

Na linha 8 configuramos a serie “Meses” como rótulos do eixo X. Na linha 9 definimos o nome do eixo X.

Neste momento já definimos os dados do nosso gráfico agora devemos construir nossa imagem para isso criamos uma instância da classe pImage e recebe como parâmetro as dimensões da imagem, no caso a imagem terá 700px de largura e 230px de largura, e passamos também o nosso objeto que representa os dados do gráfico $data.

Na linha 12 utilizamos o método drawRectangle para desenhar um retangulo com borda preta ao redor da imagem para delimitar a borda.

Na linha 14 definimos a fonte através do método setFontProperties repare que para FontName se esta apontando para um arquivo da pasta fonts, se deseja utilizar outra fonte para os rótulos do gráfico basta colocar um novo ttf e especificar o caminho neste método, e também podemos definir o tamanho da fonte através do FontSize.

Na linha 16 utilizamos o método setGraphArea defimos onde nosso gráfico será desenhado na imagem, lembrando a imagem que iremos gerar terá 700×230 mas é dentro dela que iremos desenha o gráfico de barras e devemos informar os pontos x,y inicial e x,y final como se estivéssemos desenhado um retângulo.

Na linha 18 definimos as propriedades da escala, que serão utilizadas para desenha-la na linha 20 com o método drawScale. A escala é a área que serão desenhadas as barras, os valores GridR, GridG e GridB são os valores de cores das linha que serão desenhadas no fundo e CycleBackground é para mostrar as linhas de escala.

Na linha 21 desenhamos a legenda do gráfico.

Na linha 23 utilizamos o método drawBarChart para desenhar o gráfico propriamente dito, baseado nas configurações feitas anteriormente.

Na linha 25 geramos a imagem do gráfico para isso utilizamos autoOutput ela irá gerenciar automaticamente se a imagem deve ser enviada para o navegador ou ser salva. Mas podemos obrigar o gráfico ser salvo utilizando o método render.

Veja o gráfico gerado:

Gráfico em pizza

include("pChart/class/pData.class.php");
include("pChart/class/pPie.class.php");
include("pChart/class/pDraw.class.php");
include("pChart/class/pImage.class.php");

$data = new pData();   

$data->addPoints(array(10,20,30),"Placar");
$data->addPoints(array("A","B","C"),"Label");
$data->setAbscissa("Label"); 

$myPicture = new pImage(500,300,$data);
$myPicture->drawRectangle( 0 , 0 , 499 , 299 , array( "R"=>0 , "G"=>0 , "B"=>0 ) );
$myPicture->setFontProperties( array( "FontName"=>"pChart/fonts/verdana.ttf" , "FontSize"=>18 ) ); 

$PieChart = new pPie($myPicture,$data);
$PieChart->draw3DPie( 150 , 160 , array( "DrawLabels"=>TRUE , "Border"=>TRUE ) );
$PieChart->drawPieLegend( 450 , 50 , array( "Style"=>LEGEND_NOBORDER , "Mode"=>LEGEND_VERTICAL ) );
$myPicture->autoOutput();

Para criar um gráfico em pizza utilizamos basicamente os mesmos códigos para criar o objeto de dados pData e a imagem pImage.

Mas necessitamos criar um objeto pPie que é nosso gráfico em pizza, ele recebe como parâmetro do construtor o nosso objeto de imagem e de dados(linha 16).

Na linha 17 desenhamos nosso gráfico em pizza com o método draw3DPie que recebe os 2 primeiros parâmetros são a posição do centro do gráfico na imagem. O 3º parâmetro é um array com as opções do gráfico, no caso especificamos que será mostrado os labels no gráfico e que ele terá bordar.

Na linha 18 desenhamos a legenda do gráfico em pizza. Os dois primeiros parâmetros são a posição na imagem e o array contém as opções, no caso, sem bordar e a legenda na horizontal.

Veja como o gráfico ficou:

Gráfico em linha

include("pChart/class/pData.class.php");
include("pChart/class/pDraw.class.php");
include("pChart/class/pImage.class.php");

$data = new pData();
$data->addPoints( array( 10 , 20 , 30 , 40 , 30 , 20 ) , "Server A" );
$data->addPoints( array( "Janeiro" , "Fevereiro" , "Março" , "Abril" , "Maio" , "Junho" ) , "Meses" ); 

$data->setAbscissa("Meses");
$data->setAxisName(0,"Hits"); 

$myPicture = new pImage(700,230,$data); 

$myPicture->drawRectangle( 0 , 0 , 699 , 229 , array( "R"=>0 , "G"=>0 , "B"=>0 ) ); 

$myPicture->setFontProperties( array( "FontName"=>"pChart/fonts/pf_arma_five.ttf" , "FontSize"=>6 ) ); 

$myPicture->setGraphArea(60,40,650,200); 

$scaleSettings = array( "GridR"=>200 , "GridG"=>200 , "GridB"=>200 , "CycleBackground"=>TRUE );
$myPicture->drawScale($scaleSettings); 

$myPicture->drawLegend( 580 , 12 , array( "Style"=>LEGEND_NOBORDER , "Mode"=>LEGEND_HORIZONTAL ) ); 

$myPicture->drawLineChart(); 

$myPicture->autoOutput();

O gráfico em linha é praticamente igual ao gráfico em barra basta alterar a linha 25 para desenhar com o método drawLineChart.

Veja um exemplo do gráfico gerado abaixo:

Bom esse é o básico da biblioteca pChart ela é muito completa permitindo vários outros tipos de gráficos como Barcode, Bubble chart, Plot chart, Polar and radars, Progress bars, Surface chart.

Confira a documentação e os exemplos que vem junto com a biblioteca você vai se surpreender!

Era isso até mais e obrigado pelos peixes!

Para remediar isso podemos colocar os arquivos de download fora da pasta de arquivos publicos do apache, sendo assim não acessíveis via URL diretamente, mas nos possibilitando criar um script de download que verifique se o usuário esta logado ou se tem permissão de baixar, se estiver leia o arquivo do sistema de arquivo e envie para download para o usuário.

Para nosso exemplo iremos utilizar a seguinte estrutura de diretórios:

• public_html
  • index.php
  • login.php
  • logout.php
  • download.php
• downloads
  • putty.exe

Como você deve saber, na maioria das hospedagens os arquivos visíveis do nosso site são colocados na pata public_html ou www . Sendo assim os arquivos da pasta downloads não esta publicada na web mas nossos scripts podem acessá-los via sistema de arquivos do servidor.

Antes de vermos o arquivo download.php que é o que realmente importa, vamos ver os arquivos de login, logut e index, que são bem simples e servem somente para este exemplo, se você quiser um exemplo de sistema de login pode ver em outro post.

index.php

<?php
  session_start();
?><html>
  <head>
      <meta charset="UTF-8">
      <title>Teste protegendo download autenticado</title>
  </head>

  <body>
    <?php if ( $_SESSION['logado'] == "true" ){ ?>
	<p>Você está logado</p>
	<a href="logout.php">logout</a>
    <?php }else{ ?>
	Você <strong>não</strong> está logado!!!
	<a href="login.php">login</a>
    <?php } ?>

  <a href="download.php?download=putty.exe">Download putty.exe</a>
  </body>
</html>

login.php

<?php
  session_start();

  $_SESSION['logado'] = 'true';

  header('location: index.php');
?>

logout.php

<?php
  session_start();

  unset($_SESSION['logado']);

  header('location: index.php');
?>

Os arquivos acima são bem simples, acredito que não necessite de maiores explicações. Então vamos ao que interessa:

download.php

<?php
session_start();

if( $_SESSION['logado'] == 'true' ){

	$download = $_GET['download'];
	if( is_file( '/home/boteco/downloads/'.$download ) ){
		$filename = '/home/boteco/downloads/'.$download;

		$finfo = finfo_open(FILEINFO_MIME_TYPE);
		$type = finfo_file($finfo, $filename);
		header('Content-type: '.$type);
		header('Content-Disposition: attachment; filename="'.$download.'"');

		readfile($filename);
	}else{
		echo "arquivo nao encontrado";
	}

}else{
	echo "Você não estaa logado. Faça o login para efetuar o download.";
}

?>

Na linha 2 chamamos a função session_start() para podermos ler e gravar informação na sessão.

Na linha 4 testamos se o usuário que acessou esta logado na sessão, se o usuário pode fazer o download.

Na linha 6 pegamos o nome do arquivo que recebemos via parâmetro GET da URL, como vimos no arquivo index.php na linha 18 para fazer o download chamamos download.php?download=putty.exe então queremos baixar o arquivo putty.exe.

Na linha 7 verificamos se o arquivo que recebemos por parâmetro existe e é um arquivo, você deve ter notado que utilizamos o caminho absoluto da pasta de download e concatenamos com o nome do arquivo recebido.

Na linha 8 armazenamos o nome absoluto do arquivo em uma variável para facilitar a manipulação.

Na linha 10 criamos um recurso fileinfo, para ser utilizado para ler o mime-type do arquivo.

Linha 11 lemos o MIME-TYPE do arquivo e armazenamos em uma variável, necessitamos pegar o MIME-TYPE do arquivo pois o nosso script de download possui o MIME-TYPE text/x-php e o comportamento do navegador para este MIME-
TYPE é mostrá-lo e não baixá-lo, se deixarmos o MIME em text/x-php e jogarmos o contudo do arquivo para o navegador, veremos o código binário do programa, ou seja, um monte de caracteres estranhos.

Na linha 12 modificamos o MIME do nosso script para o MIME lido do arquivo.

Na linha 13 forçamos o arquivo ser baixado com o nome recebido por parâmetro, lembrando, se não forçarmos ele irá utilizar o nome do script o que não seria algo legal .

Na linha 15 utilizamos a função redfile que lê um arquivo e exibe ele na tela, como já modificamos o header do arquivo para um outro MIME e para forçar o download o arquivo será lido do sistema de arquivo e enviado para o usuário.

OBS: Só lembrando, a função finfo_open só está disponível no PHP >= 5.3.0, se você utilizar uma versão anterior pode utilizar mime_content_type mas lembre-se de verificar se ela está disponível na sua hospedagem, na minha por exemplo não está e não estou com vontade de me incomodar com eles, fiquei somente com o teste local.

Bom era isso pessoal.

O TcheLinux é um grupo de voluntários que desde 2006 trabalha na divulgação do Software Livre no estado do Rio Grande do Sul, através de palestras e workshops gratuitos para estudantes e demais interessados.

O evento será realizado na Escola SENAC de Uruguaiana nos dias 16 e 17 de Setembro de 2011 (sexta e Sábado).

As inscrições estão abertas: http://tchelinux.uruguaianatech.info/

Confira as listas das palestras aqui: http://tchelinux.org/site/doku.php?id=evento_uruguaiana_2011

A entrada no evento é gratuita, aos interessados em certificado é solicitado a doação de 2Kg de alimentos.

Não perca esta oportunidade.

Para começar precisamos de uma tabela no banco de dados que irá armazenar nossos usuários que deve ter pelo menos os campos de usuário e senha,que será armazenada no formato sha256 e necessitará ser do tipo CHAR(64). A tabela abaixo deve servir!

CREATE TABLE usuarios (
 id int(11) NOT NULL auto_increment,
 nome varchar(255) NOT NULL,
 login varchar(255) NOT NULL,
 senha char(64) NOT NULL,
 PRIMARY KEY  (`id`)
)

Criamos então o Model Usuario

<?php
class Usuario extends AppModel {
 var $name = 'Usuario';
}
?>

Vamos então agora inserir o AuthComponent em /app/app_controller.php para podermos utilizá-lo em qualquer controller e fazer as configurações necessárias.

<?php
class AppController extends Controller{
	var $components = array('Auth');

   function beforeFilter(){
        if( isset( $this->params['admin']) ){
		$this->layout = 'admin';
        }

	//permitir todas as viwes que não sao administrativas
        if (!isset($this->params['admin'])) {
            $this->Auth->allowedActions = array('*');
        } 

	//configuração da autenticação
	Security::setHash('sha256');
	$this->Auth->userModel = 'Usuario';
	$this->Auth->fields = array('password' => 'senha','username' => 'login');
	$this->Auth->authError = 'Área Restrita! Efetue login!'; // Mensagem ao entrar em area restrita
 	$this->Auth->loginError = 'Nome de usuario ou senha não conferem!'; // Mensagem quando não se autenticar
 	$this->Auth->logoutRedirect = array('action' => 'login', 'controller' => 'usuarios','admin'=>1);
 	$this->Auth->loginRedirect = array('action' => 'index', 'controller' => 'home','admin'=>1);
    }
}
?>

Na linha 3 temos inserimos o AuthComponent.

Na linha 5 declaramos o método beforefilter que é um método que é executado antes de qualquer método de nossos controllers permitindo que as configurações de autenticação sejam sempre executadas antes da lógica de nossos controllers.

Nas linhas 6, 7 e 8 testamos se estamos em uma área administrativa, através do Routing.admin configurado no core.php se for mudamos o template para o administrativo.

Por padrão o AuthComponent protege todas os actions dos controllers então precisamos determinar quais estão liberados então nas linhas 11,12 e 13 verificamos se não estamos em uma área administrativa, ou seja não precisamos de autenticação e liberamos o acesso as actions não administrativas. Para liberar actions especifico basta colocar $this->Auth->allow(‘action1′,’action2′,’action3′…);

Na linha 16 configuramos o AuthComponent para utilizar sha256 como algoritmo de hash para criptografar a senha. É importante ressaltar que para criptografar a senha ele utiliza o conteúdo do Security.salt, então a senha armazenada no banco de dados será diferente para cada Security.salt. Uma dica para ver qual é o hash basta submeter o formulário de login com o debug de sql que ele irá mostrá-lo.

Na linha 17 configuramos para utilizar o model Usuario que criamos e consequentemente a tabela usuarios.

Na linha 18 configuramos o Authcomponent para utilizar os campos login e senha da tabela.

Na linha 19 configuramos a mensagem de erro caso entre em uma área restrita.

Na linha 20 configuramos a mensagem de erro caso o login e senha sejam errados.

Na linha 21 configuramos a página para qual devemos redirecionar o usuário após ele realizar o logout.

Na linha 22 configuramos a página para qual iremos redirecionar o usuário após ele realizar o login com sucesso.

Agora podemos criar o nosso usuarios_controller.php

<?php
class UsuariosController extends AppController {
var $name = 'Usuarios';
public function admin_login() {
        $this->layout = 'login';
}
function logout(){
	 $this->redirect($this->Auth->logout());
}
function admin_add() {
	if (!empty($this->data)) {
		$this->Administrador->create();
		$this->data['Usuario']['senha'] = $this->Auth->hashPasswords($this->data['Usuario']['senha']);
		if ($this->Administrador->save($this->data)) {
			$this->Session->setFlash(__('O Usuário foi salvo', true));
			$this->redirect(array('action' => 'index'));
		} else {
			$this->Session->setFlash(__('O Usuário não foi salvo.Tente novamente.', true));
		}
	}
}
}
?>

No usuarios_controller.php não precisamos fazer muita coisa, o AuthComponent já fornece os códigos de login, basta para nós declará-lo, para o logout basta chamar $this->Auth->logout que faz o logout e retorna a URL que é o caminho para onde o usuário deve ir após efetuar logout.

Para adicionar e editar o usuário devemos criptografar a senha, que é feito com o método $this->Auth->hashPasswords($senha); como vista na linha 13, lembrando que o código de retorno deste método muda conforme a configuração do Security.salt.

Agora vamos ao formulário de login que é bastante simples em /app/views/usuarios/login.ctp.

<?php echo $session->flash('auth'); ?>

<h2>Entrar</h2>
<?php
echo $form->create('Usuario' , array('action' => 'login'));
echo $form->input('login');
echo $form->input('senha',array('type'=>'password'));
echo $form->end('LOGAR');
?>

Esse é um pequeno exemplo o AuthComponent espero que ajude! Basta agora colocar o resto dos métodos do CRUD e seguir fazendo seu sistema administrativo.

[EDIT 2011-05-30]
Se você quiser liberar páginas especificas(controller e action) coloque o código baixo no app_controller especificando qual controller e action você quer liberar:

$this->Auth->allow(array('controller'=>'action'));

[/EDIT]

Paz e prosperidade!

1. Instalar o MySQL

sudo aptitude install mysql-server mysql-client

Durante a instalação a senha do usuário root do MySQL será pedida.

2. Instalar o Apache 2

sudo aptitude install apache2

Depois instalado verifique se esta funcionando acesse http://localhost se aparecer um “It works!” está funcionando.

3. Instalar o PHP 5

sudo aptitude install php5 libapache2-mod-php5

Não se esqueça de instalar também o modulo PHP do MySQL.

 apt-get install php5-mysql

Bom já temos o básico agora. É só reiniciar o Apache que deve estar tudo funcionando.

/etc/init.d/apache2 restart

4. Habilitando o mod_rewrite

O mod_rewrite é utilizado por vários CMS, Framework e etc. Então é sempre uma boa idéia habilitá-lo. Para você que não sabe o que é o mod_rewrite veja o post sobre URLs amigáveis

a2enmod rewrite

E altere o seguinte trecho de código no arquivo /etc/apache2/sites-enabled/000-default:

        <Directory /var/www/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None
                Order allow,deny
                allow from all
        </Directory>

por:

        <Directory /var/www/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>

Agora reinicie o Apache e tome uma cerveja! T++

[UPDATE]
Pessoal para quem precisar usar o PostgreSQL (LAPP?):

 apt-get install php5-pgsql

[/UPDATE]

Para começar baixe a classe em WideImage, ela irá estar na pasta lib, eu costumo renomear esta pasta para wideimage e copiá-la para o diretório que irei utilizá-la.

Redimensionando Imagem

Vamos então ao exemplo de redimensionamento e mostrar a nova imagem no navegador:

require( "wideimage/WideImage.php");

$image = WideImage::load("img/imagem1.png");

$nova_img = $image->resize(400, 300);

$nova_img->output('jpg', 90);

Imagem Original | Exemplo resize

Na linha 1 carregamos o arquivo da classe.

Na linha 3 lemos a imagem, aqui esta uma das coisas legais desta classe que ela aceita não somente ler um imagem armazenada no servidor como também aceita uma a partir de uma URL como http://wwww.botecodigital.info/imagem/logo.png, ou também vindo de um formulário com o método $img = WideImage::loadFromUpload(‘mynameimg’); . A Classe WideImage suporta os seguintes formatos: GIF, PNG, JPG, GD, GD2, WBMP, XBM, XPM.

Na linha 5 redimensionamos a imagem para caber em 400×300, e geramos uma nova imagem armazenada na variável $nova_imagem.

O método resize pode aceitar um terceiro parâmetro, o padrão é ‘inside’ que faz com que a imagem fique com no máximo(no nosso exemplo) 500 de largura e 400 de altura, mantendo a proporção. Com o valor ‘outside’ ela será maior que 500×400, mantendo a proporção. Com o valor ‘fill’ irá redimensionar para o tamanho fornecido sem se importar em manter a proporção.

Na linha 7 pegamos a nova imagem redimensionada e exibimos no navegador no formato jpg, com a qualidade de 90.

Também podemos salvar a imagem em disco com o método $img->saveToFile(‘imagem.jpg’, 90);, lembrando que devemos ter permissão de escrita no diretório em que queremos salvar.

Marca D’agua(watermark)

A classe WideImage também permite inserir uma imagem dentro de outra, fazendo o efeito de marca D’Água. Vejamos o exemplo:

require( "wideimage/WideImage.php");

$image = WideImage::load("img/imagem1.png");
$marca = WideImage::load("img/marca-boteco.png");

$nova_img = $image->merge($marca,'right','bottom');

$nova_img->output('jpg', 90);

Imagem Original| Exemplo Merge

Na linha 1 como vimos carregamos a classe, na linha 3 carregamos a imagem e na linha 4 carregamos a imagem da marca.

Na linha 6 chamamos o método merge da imagem principal e passamos por parâmetro a imagem de marca. Os dois seguinte parâmetro seguinte informam a posição(x e y respectivamente) em que a marca irá ser inserida, eles aceitam tanto valores em pixels como as posições left, right, top e bottom. Também é possível fazer uma combinação dos valores left, right, top e bottom com pixels, como por exemplo ‘right-50′ que posicionaria a marca 50px do canto direito da imagem, ou ‘bottom-20′ que posicionaria a marca 20px da parte inferior da imagem.

No método merge também é possível passar um quarto parâmetro que seria o alpha.

Recortando (crop)

Vamos ver um exemplo de recorte de uma imagem:

require( "wideimage/WideImage.php");

$image = WideImage::load("img/imagem1.png");

$nova_img = $image->crop(250,250,400,400);

$nova_img->output('jpg', 90);

Imagem Original | Exemplo Crop

Na linha 5 é chamado o método crop que aceita 4 parâmetros, os dois primeiros são os pontos x e y a partir de onde a imagem será recortada, e o terceiro e o quarto parâmetro são respectivamente a largura e altura da imagem, ou seja, a imagem gerada pelo exemplo acima terá o tamanho de 400×400, que seria a área do ponto 250×250 até o ponto 750×750 da imagem original.

Como no método merge o método crop também aceita como valores left, right, top e bottom.

Bom esse é o básico da classe WideImage ela possue vários outros recurso que vale a pena da uma olhada.

Até mais e obrigado pelos peixes

Como devem saber se não configurar uma conexão no CakePHP 1.3 ele dá erro então a solução é criar uma fonte de dados que não acessa nada, somente fica conectada.

Primeiro vamos definir o DATABASE_CONFIG, então edite o arquivo app/config/database.php

class DATABASE_CONFIG {

    public $default = array('driver' => 'fantasma');

}

Agora vamos criar o driver dbo fantasma em app/models/datasources/dbo_fantasma.php

class DboFantasma extends DataSource {

    public function isConnected() {
        return true;
    }

}

Simples não!

t++

Para isso precisaremos criar um Model para o formulário. Para o exemplo criaremos um formulário simples de contato com nome, e-mail, telefone e mensagem.

/app/models/contato.php

<?php
class Contato extends AppModel {
	public $useTable = false;
	public $validate = array(
		'nome' => array(
				'rule' => 'notempty',
			  	'message' => "O nome deve ser preenchido",
		),
		'email' => array(
				'rule' => array('email'),
				'message' => "O e-mail deve ser preenchido",
		),
	   	'mensagem' => array(
				'rule' => 'notempty',
				'message' => "A mensagem deve ser preenchida",
		)
	);
}
?>

Na Model acima não temos nada que alguém que já lide com o CakePHP não conheça, o que devemos observar é a linha 3 $useTable=false que informa que este Model não está associado a uma tabela do banco de dados.

Vamos agora a criação de nosso formulário(view).

/app/view/home/contato.ctp (por exemplo)

<?php echo $form->create('Contato',array('url'=>'/contato'))?>

	<?php echo $form->input('nome',array('label'=>'Nome:'))?>

	<?php echo $form->input('email',array('label'=>'E-mail:'))?>

	<?php echo $form->input('telefone',array('label'=>'Telefone:'))?>

  	<?php echo $form->textarea('mensagem',array('cols'=>'40','rows'=>'3') )?>

<?php echo $form->end('Enviar'); ?>

Também nenhuma novidade, só devemos ressaltar a linha1 onde estamos utilizando o Model Contato para o formulário.

Vamos agora para o action do controller onde iremos validar os campos.

/app/controller/home.ctp

…
var $uses = array('Contato');
...
function faleconosco() {
	if( $this->data){
		$erros ="";
		$this->Contato->set($this->data);
		if ( $this->Contato->validates() ) {
			//envia o e-mail ou faz qualquer outra coisa com os dados
		}else{
			foreach( $this->Contato->invalidFields() as $e){
				$erros .= $e."<br />";
			}
		$this->Session->setFlash($erros);
	}
}

Bom esta parte vale uma pequena explicação!

Na linha 2 declaramos que iremos utilizar no controller o Model Contato.

Na linha 5 verificamos se foi enviado algum dado pelo formulário, na linha 6 inicializamos uma variável para armazenar os erros encontrados no formulário. Na linha 7 configuramos o Model contato com os dados vindo do formulário.

Na linha 8 utilizamos o método validates() que verifica os dados conforme as regras estipuladas no Model e retorna true não houver erro e false se alguma das regras não foi satisfeita.

Na linha 11 estamos no bloco onde alguma regra não foi satisfeita então devemos listas para o usuário. O método que nos devolve esta lista de erros é o invalidFields() que retorna um array com as mensagem estipuladas no Model. Percorremos este array concatenamos estas mensagens na variável $erros e na linha 14 salvamos na sessão para ser mostrada na view.

Bom era isso pessoal

Uma maneira muito comum de se proteger deste tipo de ataque é diferenciar se quem está enviando as informações é uma pessoa ou um bot. Isso pode ser feito criando um código que seja de fácil leitura para o usuário humano e difícil para máquinas e pedir para o usuário digitar este código junto com as outras informações do formulário.

Este sistema é muito comum hoje em dia e recebe o nome de CAPTCHA(Completely Automated Public Turing Test to Tell Computers and Humans Apart ou Teste Público Totalmente Automatizado para Diferenciar Humanos de Computadores) e vamos agora apreender com fazer um simples.

Começaremos criando uma imagem com um fundo um pouco bagunçado, quanto mais bagunçado melhor, isso dificulta a leitura por bots.

O CAPTCHA vai funcionar da seguinte forma, vamos gerar um código baseado na hora do sistema e armazená-lo em uma sessão, após isso iremos criar uma imagem com o fundo que criamos acima e escrever o nosso código gerado sobre ele.

Vamos então aos código

session_start();

$codigoCaptcha = substr(md5( time() ) ,0,9);

$_SESSION['captcha'] = $codigoCaptcha;

$imagemCaptcha = imagecreatefrompng("fundocaptch.png");

$fonteCaptcha = imageloadfont("anonymous.gdf");

$corCaptcha = imagecolorallocate($imagemCaptcha,255,0,0);

imagestring($imagemCaptcha,$fonteCaptcha,15,5,$codigoCaptcha,$corCaptcha);

header("Content-type: image/png");

imagepng($imagemCaptcha);

imagedestroy($imagemCaptcha);

Na linha 3 geramos nosso código “aleatório” começamos pegando o timestamp através da função time e aplicamos sobre ele a função md5 deste código md5 pegamos os 9 primeiros caracteres(se você quiser pode pegar mais ou menos) através da função substr.

Na linha 5 salvamo nosso código na sessão para que possamos compará-lo mais tarde.

Na linha 7 criamos uma imagem a partir da imagem de fundo que criamos.

Na linha 9 carregamos uma fonte através da função imageloadfont que carrega define a fonte que será utilizada para escrever nosso código de captcha na imagem criada na linha 7.

Na linha 11 utilizamos a função imagecolorallocate para gerar uma cor para o código que iremos inserir na imagem.

Na linha 13 utilizamos a função imagestring para “desenhar” o código gerado na linha 3 na imagem criada na linha 8, utilizando a fonte definida na linha 9.

Na linha 15 mudamos o cabeçalho do arquivo para ele ser um arquivo do tipo imagem no formato png, isso faz com que o navegador mostre a imagem e não o código binarios em forma de texto.

Na linha 17 enviamos a imagem gerada para o navegador. Na linha 19 desalocamos o espaço utilizado pela imagem criada.

Para utilizar o captcha precisamos de um formulário e dentro dele exibiremos a nossa imagem através da tag IMG e também precisaremos de um campo para o usuário inserir o código captcha.

<form action="valida.php" method="post">
    <img src="captcha.php" alt="código captcha" />

    <label for="captcha">Digite o código</label>
<input id="captcha" name="captcha" type="text" />
<input type="submit" value="Enviar" />
</form>

Agora basta compara o valor passado por POST no input captcha com o valor armazenada em sessão.

if( $_SESSION['captcha'] == $_POST['captcha']){
        echo "<h1>Ok - Código Correto</h1>";
    }else{
        echo "<h1>Erro - Código digitado errado</h1>";
    }

Aqui você pode visializar o exemplo

Download do exemplo.

Aqueles que já trabalharam com Java sabem que existe algo chamado JDBC que resolve este problema, fornecendo uma camada de abstração de dados através de interfaces, bastando carregar o driver correto e utilizar sempre os mesmos métodos para acessar qualquer banco de dados.

Para os desavisados o PHP possui, desde a versão 5, algo parecido que se chama PDO – PHP Data Objects, permitindo o acesso a vários bancos de dados chamando sempre as mesmas funções.

Os drivers PDOs devem ser carregados pelo módulo PHP então temos que habilita-los e isso é feito dentro do arquivo php.ini.

extension=pdo.so
extension=pdo_mysql.so
extension=pdo_pgsql.so
extension=pdo_sqlite.so

Normalmente não temos acesso ao arquivo php.ini pois contratamos um serviço de hospedagem, então para ver os drivers que estão habilitados na hospedagem que contratamos devemos executar o código abaixo:

foreach(PDO::getAvailableDrivers() as $driver){
    echo $driver.'<br />';
}

Como o próprio nome do recurso “PHP Data Objects” a conexão e a manipulação dos dados é feita utilizando uma classe do PHP chamada PDO – que deve ser instanciado com as informações de conexão ao banco.

Exemplo:

$conn = new PDO('mysql:host=localhost;port=3306;dbname=teste', 'root', '123456');

Como podemos notar o construtor do objeto PDO aceita três parâmetros, o primeiro é uma string contendo o driver a ser utilizado mysql, o local onde o banco esta rodando localhost, a porta que o banco esta escutando 3306 e o nome do banco de dados teste. O segundo parâmetro é o usuário de acesso ao banco de dados e o terceiro é a senha de acesso.

A partir de agora podemos utilizar o objeto armazenado em $conn para manipular os dados no banco de dados.

Como sabemos quando estamos trabalhando com banco de dados vários erros podem acontecer como o banco de dados estar indisponível entre outra coisas. O PDO pode ser configurado para gerar exceção quando algum erro destes ocorrem sendo capturados com um bloco try{…}catch(){…} sendo lançada a exceção PDOException.

Abaixo um exemplo de inserção utilizando a classe PDO:

try{

    //instancia o objeto PDO, conectando com o banco mysql
    $conn = new PDO('mysql:host=localhost;port=3306;dbname=teste', 'root', '123456');

    //configurando para utilizar exceções
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    //executa as instruções SQL
    $conn->exec("INSERT INTO usuarios (login,senha,nome) VALUES ('rodrigo', '123456', 'rodrigo')");
    $conn->exec("INSERT INTO usuarios (login,senha,nome) VALUES ('thiago', '654321', 'Thiago')");
    $conn->exec("INSERT INTO usuarios (login,senha,nome) VALUES ('maria', '654123', 'Maria')");

    //fecha a conexão
    $conn = null;
}catch (PDOException $i){
        //se houver exceção, exibe
        print "Erro: <code>" . $i->getMessage() . "</code>";
}
?>

Como vemos nas linha 10,11,12 utilizamos o método exec para executar comando SQL no banco de dados.

Agora veremos como consultar utilizando a classe PDO:

try{
        //instancia o objeto PDO, conectando com o banco mysql
    $conn = new PDO('mysql:host=localhost;port=3306;dbname=teste', 'root', '123456');
    //configurando para utilizar exceções
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    //executa a instrução de consulta
    $result = $conn->query("SELECT senha,login FROM usuarios");
    if($result){
                //percorre os resultados via o laço foreach
                foreach($result as $linha){
                        //exibe o resultado
                        print $linha['login'] . " - " . $linha['senha'] . "<br>\n";
                }

        }
    //fecha a conexão
    $conn = null;
}catch (PDOException $i){
        //se houver exceção, exibe
        print "Erro: <code>" . $i->getMessage() . "</code>";
}

Como vimos para executar uma consulta utilizanos a função query que retorna um objeto de resposta PDOStatement que pode ser percorrido utilizando um laço foreach(linha 11).

Também é possível percorrer um objeto PDOStatement utilizando o método fetch dele tratar cada linha da consulta como um objeto.

Exemplo:

try{
        //instancia o objeto PDO, conectando com o banco mysql
    $conn = new PDO('mysql:host=localhost;port=3306;dbname=teste', 'root', '123456');

    //configurando para utilizar exceções
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    //executa a instrução de consulta
    $result = $conn->query("SELECT login, senha FROM usuarios");

    if($result){
                //percorre os resultados via o fetch()
                while ($linha = $result->fetch(PDO::FETCH_OBJ)){
                        //exibe resultado
                        print $linha->login . " - " . $linha->senha . "<br>\n";
                }

        }

    //fecha a conexão
    $conn = null;
}catch (PDOException $i){
        //se houver exceção, exibe
        print "Erro: <code>" . $i->getMessage() . "</code>";
}
?>

Na linha 13 chamamos o método fetch que recebe a constante PDO::FETCH_OBJ que é responsável por definir que o retorno será um objeto. Também podemos passar as constantes PDO::FETCH_ASSOC que retorna um array com os indices sendo os nomes das colunas da consulta e PDO::FETCH_NUM que retorna um array com os indices numéricos.

Outra funcionalidade interessante que ameniza muitos erros é os famosos do prepared statements. Veja o exemplo abaixo:

<?php
try{

    //instancia o objeto PDO, conectando com o banco mysql
    $conn = new PDO('mysql:host=localhost;port=3306;dbname=teste', 'root', '');

    //configurando para utilizar exceções
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

	//prepara a consulta
	$result = $conn->prepare("INSERT INTO usuarios (login,senha,nome) VALUES (?, ?, ?)") ;

	//insere os valores nas ?
    $valores = array('rodrigo', '123456', 'rodrigo');

	//executa o comando SQL
    $result->execute($valores);

    //fecha a conexão
    $conn = null;
}catch (PDOException $i){
        //se houver exceção, exibe
        print "Erro: <code>" . $i->getMessage() . "</code>";
}
?>

Com o uso dos prepared statements não precisamos ficar nos preocupando em concatenar várias variaveis, ou nos preocuparmos com escape de aspas e tudo mais, basta colocar os valores no array que será passado por parâmetro para o método execute.

Espero que tenham gostado. Para mais infomações consulte a documentação da classe PDO