Michael Paul

Como instalar e utilizar o Doctrine, uma excelente biblioteca de ORM para PHP que possui também uma camada para DBAL, abaixo uma visão geral básica.

Utilizar o mapeamento objecto-relacional é algo muito útil no desenvolvimento, pode agilizar bastante seu trabalho. Se ainda não conhece aqui esta um pequeno exemplo de como inserir um novo registro no banco de dados:

<?php
 
$user = new User();
$user->firstname = 'John';
$user->lastname = 'Doe';
$user->save();
// se a coluna id for a chave primaria
print 'Novo usuário criado, id: ' . $user->id;

Outro exemplo mostrando duas formas simples para buscar um registro:

<?php
 
$userTable = Doctrine::getTable('User');
// busca pela chave primaria
$user = $userTable->find(155);
print $user->firstname . ' ' . $user->lastname . '<br />';
// busca por uma coluna
$user = $userTable->findOneBy('lastname', 'Doe');
print $user->firstname . ' ' . $user->lastname;

Como pode ver nenhum SQL foi necessário nos exemplos, você pode realizar qualquer operação de CRUD sem escrever nenhuma query, além dos métodos que realizam essas operações existe a Doctrine Query Language que lhe permite escrever query’s totalmente orientadas a objeto. Como o Doctrine possui uma DBAL os exemplos acima e os que criar usando a DQL podem ser utilizados em qualquer um dos bancos suportados, atualmente são FrontBase, InterBase / Firebird, Microsoft SQL Server, MySQL, Oracle 7/8/9/10, PostgreSQL, QuerySim e SQLite 2.

Instalação e configuração

A versão mais recente do Doctrine pode ser baixada a partir da home do projeto ou aqui, vou utilizar MySQL e um esquema demonstrativo chamado sakila.

Crie um diretório como “intro-doctrine” em sua pasta web e extraia a versão baixada do Doctrine. A configuração básica do Doctrine ficara em um arquivo “bootstrap.php” que será assim:

<?php
// Verifique o caminho de acordo a versão baixada
require 'Doctrine-1.2.2/lib/Doctrine.php';
 
spl_autoload_register(array('Doctrine', 'autoload'));
spl_autoload_register(array('Doctrine_Core', 'modelsAutoload'));
 
$manager = Doctrine_Manager::getInstance();
 
try { 
  // Insira aqui os dados de sua conexão 
  $conn = Doctrine_Manager::connection('mysql://usuario:senha@localhost/sakila');
 
  $manager->setAttribute(Doctrine_Core::ATTR_MODEL_LOADING, Doctrine_Core::MODEL_LOADING_CONSERVATIVE); 
  $manager->setAttribute(Doctrine_Core::ATTR_EXPORT, Doctrine_Core::EXPORT_ALL);
 
  $profiler = new Doctrine_Connection_Profiler();
  $manager->setListener($profiler);
 
} catch (Doctrine_Manager_Exception $e) {
  print $e->getMessage();
}
 
Doctrine_Core::loadModels('models');

Nesse arquivo foi definido o Data Source Name usado pelo PDO, o caminho para carregar os modelos em “models” e sua forma de carregamento.

Gerar modelos

Os modelos gerados são baseado no padrão ActiveRecord criado por Martin Fowler e já bem utilizado em outras bibliotecas e frameworks.

O Doctrine pode gerar seus modelos a partir de um arquivo YAML criado manualmente ou então diretamente do banco, prefiro gerar meus modelos direto do banco pois assim posso modelar meu banco a partir de uma ferramenta como o MySQL Workbench ou mesmo fazer alguma alteração em um banco existente com o MySQL Query Browser e então gerar ou atualizar os modelos. Crie um arquivo chamado “build-models.php” na sua pasta “intro-doctrine” que será responsável pela geração dos modelos, o arquivo será o seguinte:

<?php
 
require 'bootstrap.php';
 
set_time_limit(90);
 
$modelsPath = 'models';
$title = 'Modelos gerados com sucesso!';
$msg = '';
 
try {
    Doctrine::generateModelsFromDb(realpath($modelsPath));
} catch (Doctrine_Import_Builder_Exception $e) {
    $title = 'Falha ao gerar modelos!';
    $msg = $e->getMessage();
}
 
print $title . "\n" . $msg;

Agora você pode gerar seus modelos, vamos criar uma pasta “models” e executar o script:

$ mkdir models
$ php build-models.php
Modelos gerados com sucesso em "models"
$ ls models
ActorInfo.php  Category.php  CustomerList.php  FilmCategory.php  FilmText.php   Language.php                Rental.php               StaffList.php
Actor.php      City.php      Customer.php      FilmList.php      generated      NicerButSlowerFilmList.php  SalesByFilmCategory.php  Staff.php
Address.php    Country.php   FilmActor.php     Film.php          Inventory.php  Payment.php                 SalesByStore.php         Store.php

Como pode ver, dentro da models foi criado um arquivo para cada uma de suas tabelas e uma pasta chamada “generated”, os arquivos que estão na “models” podem ser modificados normalmente enquanto os arquivos dentro da pasta “generated” não deveram ser modificados pois qualquer modificação será perdida quando gerar novamente seus modelos.

Utilizando o Doctrine

Veremos agora um pequeno exemplo de como buscar todos os registros de uma tabela e imprimir os resultados, crie um arquivo “intro.php” que ficara assim:

<?php
 
require 'bootstrap.php';
 
try {
    $actorTable = Doctrine::getTable('Actor');
    $actors = $actorTable->findAll();
 
    foreach($actors as $a)
        print $a->first_name . ' ' . $a->last_name . '<br />';
} catch (Doctrine_Exception $e) {
    print $e->getMessage();
}

Sempre que for utilizar a biblioteca precisara de seu “bootstrap.php”, ao executar o script acima você devera ver uma listagem com todos os nomes de “atores” cadastrados na tabela “Actor”.

Esta foi uma pequena introdução, no site do projeto você pode encontrar uma boa documentação incluindo um guia de uso e a referencia da API.

This entry was posted on Monday, November 9th, 2009 at 1:30 pm and is filed under Programação. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.