Doctrine is a PHP library that provides persistence services and related functionality. It includes an object relational mapper (ORM) for mapping database records to PHP objects, and a database abstraction layer (DBAL). Other libraries include an object document mapper (ODM) for NoSQL databases, common annotations, caching, data fixtures, and migrations. The presentation provides an overview of each library and how to use Doctrine for common tasks like mapping classes, saving and retrieving objects, and schema migrations. Help and contribution opportunities are available on Google Groups, IRC channels, and the project's GitHub page.

1. PHPMGTalks #3 – 13 de Abril de 2013

2. Eu!
● Daniel Lima
– @yourwebmaker
– fb.com/dlpinheiro
– Arquiteto de aplicações na
– Produtor musical & DJ
– Biker
– Skater
– Drunk
– ...

3. Agenda
● O que é o Doctrine na verdade?
– O projeto
– Libs:
● ORM
● ODM: MongoDB, CouchDB
● DBAL: Migrations
● Common: Annotations, Cache, Data Fixtures, Inflector
● Doctrine e outros projetos

4. Vamos começar!

5. O Projeto
● O que é o Doctrine na verdade?
– “The Doctrine Project is the home of a selected set
of PHP libraries primarily focused on providing
persistence services and related functionality. Its
prize projects are a Object Relational Mapper and
the Database Abstraction Layer it is built on top
of.” - http://www.doctrine-project.org/

6. Ou seja...

7. Não é somente um ORM!

8. Colaboradores
● Guilherme Blanco …. Éééééé do Brasilll!!!!
● Jonathan H. Wage
● Benjamin Eberlei
● Bulat Shakirzyanov
● Fabien Potencier
● Roman S. Borschel
● ….... Você!

9. Agora, vamos conhecer
algumas libraries do
Doctrine!

10. ORM: Mapeador de Objeto Relacional
● É a lib mais conhecida pela comunidade
● Facilita o desenvolvimento voltado ao Domínio
(problema) da aplicação
● Aproxima o modelo entidade-relacionamento
ao modelo Orientado a Objetos
● Não é necessário escrever SQL
● Não é esse MONSTRO todo que pensam...
● RTFM!!!

11. ORM: Mapeador de Objeto Relacional
Passo a passo comum:
– Crie suas tabelas
– Crie suas classes
– Mapeie suas classes
– Instancie suas classes
– Salve seus objetos
– Traga seus objetos salvos

12. Crie suas tabelas no banco de dados

13. Crie suas classes

14. Crie suas classes

15. Mapeie suas classes
● Classe “Usuario” mapeada
– https://gist.github.com/yourwebmaker/5369280#fil
e-usuario-php
● Classe “Grupo” mapeada
– https://gist.github.com/yourwebmaker/5369280#fil
e-grupo-php

16. Instancie suas classes

17. Instancie suas classes
Salve seus objetos

18. Traga seus objetos salvos

19. ODM: Mapeador para No-SQL
● Mesmo “Conceito” do ORM, mas trabalha
somente com bancos No-Sql
● Oferece funcionalidades extras que os Clients
No-Sql não oferecem:
– Event Manager
– EntityRepositories
– Herança
● MongoDB, CouchDB, OrientDB...
● O projeto DoctrineKeyValueStore pretende
padronizar o uso de bancos No-Sql.

20. DBAL: Data Base Abstraction & Access
Layer
● Camada de abstração de banco de dados
sobre a PDO
● Oferece funcionalidades extras à PDO
● ORM faz uso da DBAL

21. DBAL: Alguns Recursos extras à PDO
● Cache

22. DBAL: Alguns Recursos extras à PDO
● Eventos

23. DBAL: Alguns Recursos extras à PDO
● Tipos
– CREATE DOMAIN MyMoney AS DECIMAL(18,3);
– Definindo um tipo:
https://gist.github.com/yourwebmaker/7a61f175c7
59cf00096d#file-moneytype-php
– Adicionando um tipo:

24. DBAL: Alguns Recursos extras à PDO
● Schema-Manager

25. DBAL: Alguns Recursos extras à PDO
● Schema-Representation

26. DBAL: Alguns Recursos extras à PDO
● Schema-Representation

27. DBAL: Alguns Recursos extras à PDO
● Query Builder

28. CommonAnnotations
● /**
* @var
* @todo
* @Entity(repositoryClass=”XRepository”)
* @ORMEntity
* @AssertNotBlank()
*/
● "Annotations provide data about a program that is
not part of the program itself. They have no direct
effect on the operation of the code they
annotate." Oracle
● São como arquivos de configuração

29. CommonAnnotations

30. CommonCache
● ApcCache (requires ext/apc)
● ArrayCache (in memory, lifetime of the request)
● FilesystemCache (not optimal for high concurrency)
● MemcacheCache (requires ext/memcache)
● MemcachedCache (requires ext/memcached)
● PhpFileCache (not optimal for high concurrency)
● RedisCache.php (requires ext/phpredis)
● WinCacheCache.php (requires ext/wincache)
● XcacheCache.php (requires ext/xcache)
● ZendDataCache.php (requires Zend Server Platform)

31. CommonCache

32. CommonDataFixtures

33. CommonDataFixtures

34. CommonInflector

35. DBALMigrations
● “The Doctrine Migrations offer additional
functionality on top of the database abstraction
layer (DBAL) for versioning your database
schema and easily deploying changes to it. It
is a very easy to use and powerful tool.”
● Instale na munheca... ou... use o PHAR!
● 1000000x.... USE O PHAR!

36. DBALMigrations

37. DBALMigrations
● Configuração
– table_name: doctrine_migration_versions
migrations_directory:
/path/to/migrations/classes/DoctrineMigrations
migrations:
migration1:
version: 20100704000000
class: DoctrineMigrationsNewMigration

38. DBALMigrations
● $ doctrine-migrations:generate
Generated new migration class to
"/path/to/migrations/classes/DoctrineMigrations/Ve
rsion20100416130422.php"

39. DBALMigrations

40. DBALMigrations

41. DBALMigrations
$ ./doctrine migrations:status
== Configuration
>> Name: Doctrine Sandbox Migrations
>> Database Driver: pdo_mysql
>> Database Name: testdb
>> Configuration Source:
/Users/jwage/Sites/doctrine2git/tools/sandbox/migrations.xml
>> Version Table Name: doctrine_migration_versions
>> Migrations Namespace: DoctrineMigrations
>> Migrations Directory:
/Users/jwage/Sites/doctrine2git/tools/sandbox/DoctrineMigrations
>> Current Version: 2010-04-16 13:04:22
(20100416130422)
>> Latest Version: 2010-04-16 13:04:22
(20100416130422)
>> Executed Migrations: 0
>> Available Migrations: 1
>> New Migrations: 1
== Migration Versions
>> 2010-04-16 13:04:01 (20100416130401) not migrated

42. DBALMigrations
$ ./doctrine migrations:migrate --dry-run
Are you sure you wish to continue?
y
Executing dry run of migration up to 20100416130452
from 0
>> migrating 20100416130452
-> CREATE TABLE users (username VARCHAR(255) NOT
NULL, password VARCHAR(255) NOT NULL) ENGINE = InnoDB

43. DBALMigrations
$ ./doctrine migrations:migrate 0
Are you sure you wish to continue?
y
Migrating down to 0 from 20100416130422
-- reverting 20100416130422
-> DROP TABLE addresses
-- reverted
-- reverting 20100416130401
-> DROP TABLE users
-- reverted

44. Doctrine e outros projetos
● Symfony
– Validators
– Router
● Zend Framework 2
● Zend Framework 1
● JSMSerializer
● DMSFilter
● SuaSempresaSuaLib

45. Como obter ajuda?
● Google Groups:
– Doctrine-user
– Doctrine-dev
– Doctrine-BR
● IRC
– irc.freenode.net/doctrine
– irc.freenode.net/doctrine-dev
– irc.freenode.net/doctrine-mongodb-odm
● LEIA O MANUAL DE CABO A RABO!

46. Contribuindo com o Doctrine
● http://www.doctrine-project.org/contribute.html
● https://github.com/doctrine
– Há sempre projetos interessantes lá =)

47. Reflexões...

48. Perguntas?

49. Obrigado!