what is doctrine?

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

Nashville LAMP

What is Doctrine?

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

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: jonathan.wage@sensio.com Phonenumbers: cell: phonenumber: 6155139185 office: phonenumber: 4159925468

Nashville LAMP

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

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 = 'fabien.potencier@sensio.com';$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] => jonathan.wage@sensio.com )

[1] => Array ( [id] => 2 [first_name] => Fabien [last_name] => Potencier [username] => fabpot [password] => changeme [email_address] => fabien.potencier@sensio.com )

) 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] => jonathan.wage@sensio.com [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', '?', 'jonwage@gmail.com') ->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

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

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

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

First releasein September 09`

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

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 jonathan.wage@sensio.com

Nashville LAMP

Jonathan H. Wagejonathan.wage@sensio.com+1 415 992 5468

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

Questions?

what is doctrine?

string255 user

new user

nashville lamp orm

nashville lampworking

nashville lamp easy

nashville lampuser

nashville lampbuild

phpedit existing user

Technology

leadership institute branch legal training section what is...

the doctrine of christ what is the doctrine of christ ? 1

doctrine & covenants 65-67 fill the earth!. do you know what...

new zealand defence doctrine publication new zeala … ·...

the cosmic doctrine - awakening intuition · 2015-01-28 ·...

campaigning - national defense university · by assistant...

the doctrine of the apostles. 7ls doctrine of the apostles....

what is sound doctrine

first sale doctrine after costco v....

what is the monroe doctrine? write a short response in your...

the doctrine of promissory estoppel -...

what jesus said about “false doctrine”

what is the exclusionary rule explain stop and frisk what...

what is the monroe doctrine? write a short response in your...

what the bible says, god says: b. b. warfield’s doctrine...

the doctrine of verbal plenary...

why study doctrine i. what is doctrine? a. the word...

what is the public trust doctrine? and why it does...

the essential facilities doctrine: what does it mean to be

doctrine y rinitthe t f o doctrine of the trinity st506...