Lançado Kohana Framework 2.2

August 9th, 2008 by newton

Os desenvolvedores do Kohana escolheram uma data curiosa para o lançamento da versão 2.2 do framework, 08/08/08, competindo com a abertura dos jogos olímpicos da China (que ganhou medalha de ouro chegando na frente, uma vez que o dia lá começa bem antes do que por aqui).

Com a nova versão a promessa de abandonar ainda mais alguns vestígios do seu “pai”, o Code Igniter, como a remoção da classe Loader. Além disso, novos módulos foram implementados como o de Compressão de Arquivos, Integração com Google Maps e Captcha, dentro outros.

Visite o site oficial do Kohana para mais informações ou para fazer o download da nova versão.

Estendendo Helpers no Kohana Framework

July 31st, 2008 by newton

Os helpers no Kohana Framework não passam de classes estáticas (que não precisam ser instanciadas), e você pode precisar adicionar funcionalidades à um método ou criar suas próprias funcionalidades. Para isso, você vai precisar criar uma extensão do Helper.

O primeiro passo é ir até o diretório da sua aplicação (por padrão ele é chamado application) e criar um diretório chamado helpers, caso ele ainda não exista, claro, e criar um arquivo chamado MY_form.php. É importante ressaltar que o prefixo MY_ pode ser configurado.

No primeiro exemplo, vamos estender o form helper do framework para criar o input date. Neste caso, utilizamos o plugin datePicker para jQuery (biblioteca javascript) onde, para colocar o seletor de data (calendário) ao lado do combo, basta definir uma classe “date-pick” para o elemento HTML. Vamos ao código:

<?php defined('SYSPATH') or die('No direct script access.');
class form extends form_Core
{
	/**
	 * Creates an HTML form input date tag.
	 *
	 * @param string|array input name or an array of HTML attributes
	 * @param string       input value, when using a name
	 * @param string       a string to be attached to the end of the attributes
	 * @return string
	 */
	public static function date($data, $value = '', $extra = '')
	{
		if ( ! is_array($data))
		{
			$data = array('name' => $data);
		}
		// Insere atributo class com valor date-pick
		$data['class'] = (isset($data['class'])) ? $data['class'].' date-pick' : 'date-pick';
		return form::input($data, $value, $extra);
	}
} // End form class

Dessa forma, ao usar o código abaixo, será gerado um input text com a classe “date-pick”, e o jQuery faria todo o serviço:

<?php echo form::date('dt_aniversario'); ?>

Você também não terá problemas caso passe outros atributos:

<?php echo form::date( array('name'=>'dt_aniversario', 'title'=>'Data de Aniversário') ); ?>

Na imagem abaixo segue um exemplo do funcionamento do campo data:

Kohana Framework: Lista de discussão

June 5th, 2008 by newton

Aviso ao pessoal que provou o Kohana framework e gostou: Algumas pessoas estão se movimentando novamente e criaram a lista de discussão do framework em português, para discussões, dicas e dúvidas.

Relacionamento entre tabelas com ORM do Kohana Framework

March 27th, 2008 by newton

Achei o post do Adler sobre relacionamento entre tabelas com o Zend Framework bem bacana e didático. Estou me devendo uma olhada no ZF, que já está na versão 1.5.1 (enquanto escrevo este artigo), mas isso deve ficar mais pro final do ano.

Resolvi então fazer uma espécie de série, sobre ORMs dos frameworks. Quem aí trabalhar com CakePHP, Symfony, Doctrine, Lumine ou qualquer outro framework/orm, faça um artigo sobre isso e vamos fazer uma rede de links. Pode ser muito útil pra comunidade, principalmente pra quem procura um framework. Por aqui, vou falar do Kohana framework. Mãos à obra:

No Kohana, para usar o ORM você precisa seguir uma padronização de nomes de tabelas e das chaves estrangeiras, então, nossas tabelas de UF e Cidade ficariam assim:

ufs
id - INT - PRIMARY KEY
nome - Varchar(100)

cidades
id - INT - PRIMARY KEY
nome - Varchar(100)
uf_id - INT - FOREIGN KEY

Sim, as tabelas precisam estar no plural (no padrão americano), e não quero entrar no mérito se isso é bom ou ruim. Continuemos o exemplo mostrando como seriam nossas classes para cada uma das entidades, já montando os arrays para os relacionamentos:

class Uf_Model extends ORM
{
   protected $has_many = array('cidades');
}

class Cidade_Model extends ORM
{
  protected $belongs_to = arary('uf');
}

No Kohana, as classes de modelo devem ter o sufixo “_Model”, e aqui extendemos a classe ORM. Aqui uma outra controvérsia. Quando declaramos o array has_many, colocamos a entidade no plural, mas quando declaramos belongs_to, está no singular. Apesar de fazer sentido, é preciso ficar atento pra não confundir as coisas. Você ainda pode ter os seguintes relacionamentos:

  • has_one
  • belongs_to_many
  • has_and_belongs_to_many

Nos resta agora demonstrar um exemplo prático de como trabalhar com as duas entidades. Confesso que gostei muito mais da implementação do belongs_to, que comento mais pra baixo, mas este modelo também é bastante prático. Vejamos um controller de exemplo:

class Index_Controller extends Controller
{
   public function index()
   {
      // instancia o objeto UF com id 1
      $obj_uf = new Uf_Model(1);

      // Pesquisa pelas cidades desta UF
      $cidades = $obj_uf->find_related_cidades();

      // Percorre as cidades exibindo na tela
      foreach ($cidades as $cidade)
      {
        echo $cidade->nome.'<br />';
      }
   }
}

Poderíamos usar o ORM::factory() para recuperar a uf, que usa o method chaining do PHP:

$obj_uf = ORM::factory('uf')->find(1);

Agora vou demonstrar algo que achei muito prático e que poupa bastante tempo de codificação, que é a recuperação do nome da UF a partir de uma cidade, veja este outro exemplo de controller:

class Index_Controller extends Controller
{
   public function index()
   {
      // instancia o objeto Cidade com ID 1
      $obj_cidade = new Cidade_Model(1);

      // Exibindo nome da Cidade e UF na tela
      echo 'Cidade: '. $cidade->nome .'<br />';
      // O objeto uf já é inserido automagicamente no objeto cidade
      echo 'UF: '. $cidade->uf->nome;
   }
}

Isso mesmo que você leu. Não preciso fazer absolutamente nada pra recuperar a UF, o framework faz isso automaticamente através do método mágico __get(). Como eu disse antes, muito prático.

Conclusão

Em um comparativo com o tutorial do Zend Framework, creio que o Kohana cumpriu o seu papel de tornar o desenvolvimento mais ágil, porém, perde em organização e poder das funcionalidades de mapeamento dos objetos.

E vocês, o que acharam dessa implementação?

Fechar
Envie por e-mail