What's New In Doctrine

What’s new in Doctrine www.doctrine-project.org www.sensiolabs.com

#phpday

What’s newin Doctrine

http://www.sympalphp.org


http://www.sensiolabs.com



#phpday

Doctrine Book






#phpday

First official publishedDoctrine documentation






#phpday

Doctrine 1.1






#phpday

Doctrine 2.0






#phpday

Doctrine 1.1






#phpday

1.x Evolution






#phpday

Stability, bugs, features






#phpday

Zero failing test cases






#phpday

Dozens of new test cases adding more

code coverage






#phpday

Fine tuned API






#phpday

Improved HydrationPerformance






#phpday

Hydrate largerresult sets in less time






#phpday

Re-written documentation






#phpday

Misc. Features






#phpday

New configuration options






#phpday

Better custommutator and accessor

support






#phpday

Enhanced fromArray()and

synchronizeWithArray()






#phpday

HandlesRelationships






#phpday

$userData = array( 'username' => 'jwage', 'password' => 'changeme', 'Groups' => array( array( '_identifier' => 1, ), array( '_identifier' => 2 ), array( 'name' => 'New Group' ) ));

$user = new User();$user->fromArray($userData);






#phpday

Generate phpDocproperty tags





/** * BaseUser * * This class has been auto-generated by the Doctrine ORM Framework * * @property string $username * @property string $password * * @package ##PACKAGE## * @subpackage ##SUBPACKAGE## * @author ##NAME## <##EMAIL##> * @version SVN: $Id: Builder.php 5441 2009-01-30 22:58:43Z jwage $ */abstract class BaseUser extends Doctrine_Record{ public function setTableDefinition() { $this->setTableName('user'); $this->hasColumn('username', 'string', 255, array('type' => 'string', 'length' => '255')); $this->hasColumn('password', 'string', 255, array('type' => 'string', 'length' => '255')); }}


#phpday






#phpday

Used for IDEautocomplete, etc.






#phpday

Migrations






#phpday

General improvementsall around to make

things more intuitive






#phpday

Brand New Diff tool






#phpday

Generate migration classes






#phpday

By comparing twoDoctrine schemas






#phpday

Automate deploymentof database changes





User: columns: username: string(255) password: string(255)


#phpday

From Schema





User: columns: username: string(255) password: string(255) email_address: string(255)


#phpday

To Schema





$from = 'schema/from.yml';$to = 'schema/to.yml';$migrationsDir = 'migrations';$diff = new Doctrine_Migration_Diff($from, $to, $migrationsDir);$changes = $diff->generateChanges();

print_r($changes);


#phpday

Generating Changes

Array( [created_columns] => Array ( [user] => Array ( [email_address] => Array ( [type] => string [length] => 255 )

)

))





$from = 'schema/from.yml';$to = 'schema/to.yml';$migrationsDir = 'migrations';$diff = new Doctrine_Migration_Diff($from, $to, $migrationsDir);$diff->generateMigrationClasses();


#phpday

Generating Classes





// migrations/1239913213_version1.php

class Version1 extends Doctrine_Migration_Base{ public function up() { $this->addColumn('user', 'email_address', 'string', '255', array('email' => '1')); }

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


#phpday

Generating Classes





$migration = new Doctrine_Migration('migrations');$migration->migrate();


#phpday

Migrating ChangesMigrate from version 0 to version 1






#phpday

Migrating up executes up() methods

Migrating down executes down() methods






#phpday

$migration = new Doctrine_Migration('migrations');$migration->migrate(0);

Reversing ChangesMigrate from version 1 to version 0






#phpday

New DataHydration

Types






#phpday

Scalar






#phpday

Flat, rectangularresult set






#phpday

Faster to execute






#phpday

Harder to work with






#phpday

Can contain duplicate data






#phpday

Like normal SQLresult set





$q = Doctrine::getTable('User') ->createQuery('u') ->leftJoin('u.Phonenumbers p');

$results = $q->execute(array(), Doctrine::HYDRATE_SCALAR);

print_r($results);


#phpday

Scalar Example





Array( [0] => Array ( [u_id] => 1 [u_username] => jwage [u_password] => changeme [u_email_address] => [email protected] [p_id] => 1 [p_user_id] => 1 [p_phonenumber] => 16155139185 )

[1] => Array ( [u_id] => 1 [u_username] => jwage [u_password] => changeme [u_email_address] => [email protected] [p_id] => 2 [p_user_id] => 1 [p_phonenumber] => 14159925468 )

) What’s new in Doctrine www.doctrine-project.org www.sensiolabs.com

#phpday

Scalar Example

mailto:[email protected]









#phpday

Single Scalar






#phpday

Sub-type of Scalar






#phpday

Returns singlescalar value






#phpday

Useful for retrievingsingle value for

aggregate/calculated results






#phpday

Very fastNo need to hydrate

objects





$q = Doctrine::getTable('User') ->createQuery('u') ->select('COUNT(p.id) as num_phonenumbers') ->leftJoin('u.Phonenumbers p');

$results = $q->execute(array(), Doctrine::HYDRATE_SINGLE_SCALAR);

echo $results; // 2


#phpday

Single Scalar Example






#phpday

Doctrine 2.0






#phpday

PHP 5.3






#phpday

Performance increases from 5.3






#phpday

Test suite runs20% faster






#phpday

And uses 30%less memory






#phpday

Re-Design






#phpday

Simplified thepublic API






#phpday

Heavily influencedby JPA, Java Hibernate






#phpday

Smaller footprint






#phpday

Un-necessaryclutter removed






#phpday

RemovedLimitations






#phpday

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 extendDoctrine 1

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

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

Doctrine 2






#phpday

No more crazy cyclic references





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


#phpday

print_r() your objects

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






#phpday

Positive effects of removing the base

class all around






#phpday

No more shared identitymap across connections






#phpday

GeneralImprovements






#phpday

Code de-coupled






#phpday

3 Main Packages






#phpday

Common






#phpday

DBAL






#phpday

ORM






#phpday

Use Doctrine DBALseparate from the ORM






#phpday

Easier to extend and override things






#phpday

Better support formultiple databases






#phpday

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);


#phpday

Simplified connectioninformation






#phpday

No more DSN nightmares






#phpday

Connection informationspecified as arrays






#phpday

Removed oldattribute system






#phpday

Replaced with simplerstring based system






#phpday

Real Native SQL support






#phpday

Driver BasedMeta Data






#phpday

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

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

PHP Annotations






#phpday

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));






#phpday

YAML

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

class User{ public $id, $username;}






#phpday

Write your own driver






#phpday

Cache






#phpday

Query CacheCache final SQL that is parsed from DQL






#phpday

Metadata CacheCache the parsing of meta data






#phpday

Result CacheCache the results of your queries






#phpday

InheritanceMapping






#phpday

Single TableOne table per hierarchy






#phpday

Class TableOne table per class






#phpday

Concrete TableOne table per concrete class






#phpday

Testing






#phpday

Switched to phpUnit






#phpday

Better mock testing






#phpday

Easy to run tests against multiple DBMS






#phpday

Code de-coupled soit is easier to test






#phpday

New Features






#phpday

New DQL Parser






#phpday

Hand written






#phpday

Recursive-descentparser






#phpday

Constructs AST






#phpday

PHP Class namesdirectly represent

DQL language






#phpday

Every DQL featurehas a class to handle

parsing






#phpday

Easy to maintainEasy to add new features

Easy to use






#phpday

Performance?






#phpday

Final SQL can beeasily and effectively

cached






#phpday

Not practical to parseevery time






#phpday

CustomColumn Types






#phpday

Add your own data types






#phpday

Types are OOP classes






#phpday

Easy to extendor add new types






#phpday

Extend DQL






#phpday

DQL parser canbe extended






#phpday

Add your ownDQL functions






#phpday

When?






#phpday

First releasein September






#phpday

ALPHA






#phpday

BETA






#phpday

RC






#phpday

Stable - 2010’ ?






#phpday

What is next?






#phpday

Publishing of firstDoctrine book






#phpday

Write more documentation






#phpday

Publish more books






#phpday

Doctrine communityextension repository

Symfony has Plugins

and

Doctrine has Extensions






#phpday

Default DBALand ORM in PEAR2?

De-facto standard?






#phpday

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]


#phpday

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

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

Questions?









What's New In Doctrine

Technology

Transcript of What's New In Doctrine