what is doctrine?

What is Doctrine? www.doctrine-project.org www.sensiolabs.com

Nashville LAMP

What is Doctrine?

http://www.sympalphp.org


http://www.sensiolabs.com



Nashville LAMP

Doctrine is a ORMwritten in PHP






Nashville LAMP

What is an ORM?






Nashville LAMP

ORM stands forObject Relational Mapper






Nashville LAMP

Manipulate RDBMSas a set of PHP objects






Nashville LAMP

Easy to get started






Nashville LAMP

Doctrine Sandbox





$ svn co http://svn.doctrine-project.org/branches/1.1 lamp_doctrine$ cd lamp_doctrine/tools/sandbox$ php doctrine.php


Nashville LAMP

Doctrine Sandbox

Command Line

http://svn.doctrine-project.org/branches/1.1

http://svn.doctrine-project.org/branches/1.1





Phonenumber: columns: phonenumber: type: string(55) notnull: true user_id: type: integer notnull: true relations: User: foreignAlias: Phonenumbers onDelete: CASCADE


Nashville LAMP

Test SchemaUser: columns: first_name: type: string(255) notnull: true last_name: type: string(255) notnull: true username: type: string(255) unique: true notnull: true password: type: string(255) notnull: true email_address: type: string(255) notnull: true email: true unique: true

lamp_doctrine/tools/sandbox/schema/schema.yml





User: jwage: first_name: Jonathan last_name: Wage username: jwage password: changeme email_address: [email protected] Phonenumbers: cell: phonenumber: 6155139185 office: phonenumber: 4159925468


Nashville LAMP

Test Datalamp_doctrine/tools/sandbox/data/fixtures/data.yml

mailto:[email protected]







Nashville LAMP

Build All Reload

$ php doctrine.php build-all-reload






Nashville LAMP

Running Tests• First DQL Query• Working with objects• Writing DQL Queries

– SELECT queries– UPDATE queries– DELETE queries

• Custom Accessors/Mutators• Using Migrations






Nashville LAMP

First DQL Query$ php doctrine.php dql "FROM User u, u.Phonenumbers p"





$user = new User();$user->first_name = 'Fabien';$user->last_name = 'Potencier';$user->username = 'fabpot';$user->password = 'changeme';$user->email_address = '[email protected]';$user->save();


Nashville LAMP

Working with Objects

Insert new User

$ php index.php

lamp_doctrine/tools/sandbox/index.php







$userTable = Doctrine::getTable('User');

$user = $userTable->findOneByUsername('jwage');$user->password = 'newpassword';$user->save();


Nashville LAMP


Edit existing User


$ php index.php






$user = $userTable->findOneByUsername('fabpot');

$user->Phonenumbers[]->phonenumber = '1233451234';$user->Phonenumbers[]->phonenumber = '9875674543';

$user->save();


Nashville LAMP


Adding Phonenumbers


$ php index.php






$user = $userTable->findOneByUsername('fabpot');$user->Phonenumbers[0]->delete();


Nashville LAMP


Deleting Objects


$ php index.php






$user = $userTable->findOneByUsername('fabpot');$user->Phonenumbers->delete();


Nashville LAMP


Deleting Collections


$ php index.php





$q = Doctrine::getTable('User') ->createQuery('u');

$users = $q->execute();

print_r($users->toArray());


Nashville LAMP

Writing DQL Queries

SELECT Queries


$ php index.php





Array( [0] => Array ( [id] => 1 [first_name] => Jonathan [last_name] => Wage [username] => jwage [password] => changeme [email_address] => [email protected] )

[1] => Array ( [id] => 2 [first_name] => Fabien [last_name] => Potencier [username] => fabpot [password] => changeme [email_address] => [email protected] )

) What is Doctrine? www.doctrine-project.org www.sensiolabs.com

Nashville LAMP

Writing DQL Queries









$q = Doctrine::getTable('User') ->createQuery('u') ->leftJoin('u.Phonenumbers p') ->andWhere('u.username = ?', 'jwage');

$users = $q->execute();

print_r($users->toArray(true));


Nashville LAMP

Writing DQL Queries

SELECT Queries


$ php index.php





Array( [0] => Array ( [id] => 1 [first_name] => Jonathan [last_name] => Wage [username] => jwage [password] => changeme [email_address] => [email protected] [Phonenumbers] => Array ( [0] => Array ( [id] => 1 [phonenumber] => 6155139185 [user_id] => 1 [User] => )

[1] => Array ( [id] => 2 [phonenumber] => 4159925468 [user_id] => 1 [User] => )

)

)

)


Nashville LAMP

Writing DQL Queries







$q = Doctrine::getTable('User') ->createQuery('u') ->update() ->set('email_address', '?', '[email protected]') ->andWhere('username = ?', 'jwage');

$affectedRows = $q->execute();

echo $affectedRows; // 1


Nashville LAMP

Writing DQL Queries

UPDATE Queries


$ php index.php







$q = Doctrine::getTable('User') ->createQuery('u') ->delete() ->andWhere('username = ?', 'jwage');

$affectedRows = $q->execute();

echo $affectedRows; // 1


Nashville LAMP

Writing DQL Queries

DELETE Queries


$ php index.php





// ...$manager = Doctrine_Manager::getInstance();$manager->setAttribute('auto_accessor_override', true);


Nashville LAMP

Custom AccessorsEnable Auto Accessor Override

lamp_doctrine/tools/sandbox/config.php






Nashville LAMP

Custom Accessors

Custom `name` accessor





class User extends BaseUser{ public function getName() { return trim($this->first_name.' '.$this->last_name); }}


Nashville LAMP

Custom Accessorslamp_doctrine/tools/sandbox/models/User.php





$q = Doctrine::getTable('User') ->createQuery('u') ->andWhere('username = ?', 'jwage');

$user = $q->fetchOne();

echo $user->name; // Jonathan Wage


Nashville LAMP

Custom Accessorslamp_doctrine/tools/sandbox/index.php

$ php index.php





class User extends BaseUser{ // ...

public function setPassword($password) { $this->_set('password', md5($password)); }}


Nashville LAMP

Custom Mutator

MD5 encrypt passwords





$q = Doctrine::getTable('User') ->createQuery('u') ->andWhere('username = ?', 'jwage');

$user = $q->fetchOne();

$user->password = 'changeme';$user->save();

echo $user->password; // 4cb9c8a8048fd02294477fcb1a41191a


Nashville LAMP

Custom Mutator

MD5 encrypt passwords





echo $user->name;echo $user->get('name');echo $user['name'];


Nashville LAMP

Accessor/Mutator SyntaxObject property, function, array access






Nashville LAMP

Database Migrations






Nashville LAMP

Deploy schema changes






Nashville LAMP

Maintain production data






Nashville LAMP

Programmatic interfacefor issuing DDL statements






Nashville LAMP

Versions your database






Nashville LAMP

Upgrade your database to new versionsDowngrade to previous versions






Nashville LAMP

Database Migrations

Add new status column to users





User: columns:# ... status: type: enum values: [Pending, Active, Inactive]


Nashville LAMP

Database Migrations






Nashville LAMP

Database Migrations

Generate migration class

$ php doctrine generate-migrations-diff





class Version1 extends Doctrine_Migration_Base{ public function up() { $this->addColumn('user', 'status', 'enum', '', array('values' => array(0 => 'Pending', 1 => 'Active', 2 => 'Inactive'))); }

public function down() { $this->removeColumn('user', 'status'); }}


Nashville LAMP

Database MigrationsGenerate migration class





class Version1 extends Doctrine_Migration_Base{ public function postUp() { Doctrine::loadModels(realpath(dirname(__FILE__).'/../models'));

Doctrine::getTable('User') ->createQuery('u') ->update() ->set('status', '?', 'Active') ->execute(); }

// ...}


Nashville LAMP

Database MigrationsCustomize migration class






Nashville LAMP

Database MigrationsExecuting migration

$ php doctrine migratemigrate - migrated successfully to version #1






Nashville LAMP

Database MigrationsUpdate models from YAML

$ php doctrine generate-models-yaml






Nashville LAMP

Database MigrationsInspect migration was

successful or not

New status column existsDefault `Active` value






Nashville LAMP

Future of Doctrine?






Nashville LAMP

New Versions






Nashville LAMP

Doctrine 1.2






Nashville LAMP

Continued evolutionof the 1.x codebase






Nashville LAMP

Doctrine 2.0






Nashville LAMP

Almost complete re-rewrite






Nashville LAMP

Major version






Nashville LAMP

Requires PHP 5.3






Nashville LAMP

Performance increases from 5.3






Nashville LAMP

Test suite runs20% faster






Nashville LAMP

And uses 30%less memory






Nashville LAMP

Hydration performanceimprovements






Nashville LAMP

Doctrine 1.14.3435637950897 for 5000 records



Hydration Performance






Nashville LAMP

Removed Major Limitation

class User extends Doctrine_Record{ public function setTableDefinition() { $this->hasColumn('id', 'integer', null, array( 'primary' => true, 'auto_increment' => true ));

$this->hasColumn('username', 'string', 255); }}

No need to extend a base class

/** * @DoctrineEntity * @DoctrineTable(name="user") */class User{ /** * @DoctrineId * @DoctrineColumn(type="integer") * @DoctrineGeneratedValue(strategy="auto") */ public $id;

/** * @DoctrineColumn(type="varchar", length=255) */ public $username;}






Nashville LAMP

No more crazy cyclic references





User Object( [id] => [username] => jwage)


Nashville LAMP

print_r() your objects

$user = new User();$user->username = 'jwage';print_r($user);






Nashville LAMP

Positive effects of removing the base

class all around






Nashville LAMP

GeneralImprovements






Nashville LAMP

Code de-coupled






Nashville LAMP

3 Main Packages






Nashville LAMP

Common






Nashville LAMP

DBAL






Nashville LAMP

ORM






Nashville LAMP

Use Doctrine DBALseparate from the ORM






Nashville LAMP

Easier to extend and override things






Nashville LAMP

Better support formultiple databases






Nashville LAMP

Sequences, schemasand catalogs





$config = new \Doctrine\ORM\Configuration();$eventManager = new \Doctrine\Common\EventManager();$connectionOptions = array( 'driver' => 'pdo_sqlite', 'path' => 'database.sqlite');$em = \Doctrine\ORM\EntityManager::create($connectionOptions, $config, $eventManager);


Nashville LAMP

Simplified connectioninformation






Nashville LAMP

No more DSN nightmares






Nashville LAMP

Connection informationspecified as arrays






Nashville LAMP

Removed oldattribute system






Nashville LAMP

Replaced with simplerstring based system






Nashville LAMP

Real Native SQL support






Nashville LAMP

Driver BasedMeta Data






Nashville LAMP

/** * @DoctrineEntity * @DoctrineTable(name="user") */class User{ /** * @DoctrineId * @DoctrineColumn(type="integer") * @DoctrineGeneratedValue(strategy="auto") */ public $id;

/** * @DoctrineColumn(type="varchar", length=255) */ public $username;}

PHP Annotations






Nashville LAMP

PHP Codeclass User{ public $id, $username;}

$metadata = new ClassMetadata('User');

$metadata->mapField(array( 'fieldName' => 'id', 'type' => 'integer', 'id' => true));

$metadata->setIdGeneratorType('auto');

$metadata->mapField(array( 'fieldName' => 'username', 'type' => 'varchar', 'length' => 255));






Nashville LAMP

YAML

User: properties: id: id: true type: integer idGenerator: auto username: type: varchar length: 255

class User{ public $id, $username;}






Nashville LAMP

Write your own driver






Nashville LAMP

Cache






Nashville LAMP

Query CacheCache final SQL that is parsed from DQL






Nashville LAMP

Metadata CacheCache the parsing of meta data






Nashville LAMP

Result CacheCache the results of your queries






Nashville LAMP

InheritanceMapping






Nashville LAMP

Single TableOne table per hierarchy






Nashville LAMP

Class TableOne table per class






Nashville LAMP

Concrete TableOne table per concrete class






Nashville LAMP

Testing






Nashville LAMP

Switched to phpUnit






Nashville LAMP

Better mock testing






Nashville LAMP

Easy to run tests against multiple DBMS






Nashville LAMP

Code de-coupled soit is easier to test






Nashville LAMP

New Features






Nashville LAMP

New DQL Parser






Nashville LAMP

Hand written






Nashville LAMP

Recursive-descentparser






Nashville LAMP

Constructs AST






Nashville LAMP

PHP Class namesdirectly represent

DQL language






Nashville LAMP

Every DQL featurehas a class to handle

parsing






Nashville LAMP

Easy to maintainEasy to add new features

Easy to use






Nashville LAMP

Performance?






Nashville LAMP

Final SQL can beeasily and effectively cached






Nashville LAMP

Not practical to parseevery time






Nashville LAMP

CustomColumn Types






Nashville LAMP

Add your own data types






Nashville LAMP

Types are OOP classes






Nashville LAMP

Easy to extendor add new types






Nashville LAMP

Extend DQL






Nashville LAMP

DQL parser canbe extended






Nashville LAMP

Add your ownDQL functions






Nashville LAMP

When?






Nashville LAMP

First releasein September 09`






Nashville LAMP

ALPHA






Nashville LAMP

BETA






Nashville LAMP

RC






Nashville LAMP

Stable - 2010’ ?






Nashville LAMP

What is next?






Nashville LAMP

Publishing of firstDoctrine book






Nashville LAMP

Write more documentation






Nashville LAMP

Publish more books






Nashville LAMP

Doctrine communityextension repository

Symfony has Plugins

and

Doctrine has Extensions






Nashville LAMP

Default DBALand ORM in PEAR2?

De-facto standard?






Nashville LAMP

It is up to you! :)





You can contact Jonathan about Doctrine and Open-Source or for training, consulting, application development, or business related

questions at [email protected]


Nashville LAMP

Jonathan H. [email protected]+1 415 992 5468

sensiolabs.com | doctrine-project.org | sympalphp.org | jwage.com

Questions?









what is doctrine?

Technology

string255 user

new user

nashville lamp orm

nashville lampworking

nashville lamp easy

nashville lampuser

nashville lampbuild

phpedit existing user