Doctrine MongoDB Object Document Mapper

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Doctrine
MongoDB Object Document Mapper (ODM)

Doctrine MongoDB ODM www.doctrine-project.org www.sen...

What is Doctrine?

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

What is Doctrine?
• Open source PHP project started in 2006

• Relational database abstraction layer.
• ...

What is MongoDB?
• Key-Value document based storage
system.

• Bridge between traditional relational
...

Terminology

RDBMS MongoDB
Database ...

Using MongoDB in PHP

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

Connecting

$mongo = new Mongo('mongodb://localhost');

Doctrine MongoDB ODM www.doctrine-project.org www.s...

Selecting Databases

$mongo = new Mongo('mongodb://localhost');
$db = $mongo->selectDB('dbname');

Doctr...

Selecting Collections

$mongo = new Mongo('mongodb://localhost');
$db = $mongo->selectDB('dbname');
...

Inserting Documents
Insert a new user document and echo the newly generated id

$user = array(
...

Updating Documents
Update username and password and save the whole document

$user = $coll->find...

Atomic Updates
• Faster than saving the entire document.

• Safer than updating the entire document.

• Upd...

Atomic Updates
Update username and password where username is jwage

$coll->update(array(
...

Atomic Updates
Many other atomic operators exist for manipulating a documents data

• $inc - increment...

Removing Documents

$coll->remove(array('username' => 'jwage'));

Doctrine MongoDB ODM www.doctrine-project.o...

Doctrine + MongoDB

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

DocumentManager
• Abstraction on top of the PHP Mongo
class

• Manages the persistent state of PHP
...

Document States
• A NEW document instance has no persistent identity, and is not yet
associated with a Documen...

DocumentManager
Create your DocumentManager instance for managing object persistence

$config = new Do...

Deﬁning Document
A document is just a regular ole’ PHP class

class...

Mapping the Document

/** @Document */
class User
...

Ready to Go
Doctrine now knows about this document and is able
to manage its persistent state

...

Inserting, Updating and
Deleting Documents

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

Inserting Documents
$user = new User();
$user->setUsername('jwage');
...

Updating Documents
$user = $dm->findOne('User', array('username' => 'jwage'));

$user->setUsername('jonwage');
$u...

Removing Documents

$user = $dm->findOne('User', array('username' => 'jwage'));

$dm->remove($user);
$dm->flush()...

Query API
Fluent OO Query API

Doctrine MongoDB ODM www.doctrine-project.org www.sensio...

Querying MongoDB
Directly

// Get user array directly from mongo
$user = $mongo->db->users->findOn...

Querying Through
Doctrine

// Get user class instance through Doctrine
$user = $dm->findOne('Use...

Querying Through
Doctrine Query API

// Get user class instance through Doctrine Query API
$user = $dm-...

Querying Through
Doctrine Query API

// Find posts within a range of dates
$posts...

Updating Documents

// Update a document
$dm->createQuery('User')
->update()...

Removing Documents

// Remove a document
$dm->createQuery('User')
...

Embedded Documents

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

class User
{
/** @Id */
public $id;

/**...

/** @EmbeddedDocument */
class Address
{
...

$user = new User();
$user->name = 'Jonathan H. Wage';

$address = new Address();
$a...

$users = array(
array(
'name' => 'Jonathan H. Wage',
'addresses...

Updating Embedded
Documents
Uses dot notation and atomic operators for updating

Doctrine Mong...

$user = $dm->findOne('User', array('name' => 'Jonathan H. Wage'));
$user->addresses[0]->zipcode = '37205';
...

Add New Address

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

$user = $dm->findOne('User', array('name' => 'Jonathan H. Wage'));

$address = new Address();
$address->addr...

unset($user->addresses[0]->zipcode);
$dm->flush();

$coll->update(
...

References
MongoDB does not have joins or foreign keys but you
can still store references to other docume...

Organization
/** @Document */
class Organization
{
...

User
/** @Document */
class User
{
/** @Id...

$organization = new Organization();
$organization->setName('Sensio Labs');

$user = new ...

The Result

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

Array
(
[_id] => 4c86acd78ead0e8759000000
[name] => Sensi...

Working with
References

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

$user = $dm->find('User', array('name' => 'Jonathan H. Wage'));

// instance of uninitialized OrganizationProxy...

$organization = $dm->find('Organization', array('name' => 'Sensio Labs'));
$users = $organization->getUsers(); // uni...

Change Tracking

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

UnitOfWork
• Tracks changes in objects between ﬂushes

• Maintains copy of old values to compare
new valu...

Other Features

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

Document Query
Language
Language for querying documents in a similar way to
...

BNF Grammar

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

QueryLanguage ::= FindQuery | InsertQuery | UpdateQuery | RemoveQuery

FindQuery ::= FindClause [WhereClaus...

Creating Query

$users = $dm->query('find all FROM User');

Doctrine MongoDB ODM www.doctrine-proje...

Selecting Fields

$users = $dm->query('find username FROM User');

Doctrine MongoDB ODM www.doctrine-p...

Paging Results

$users = $dm->query('find all FROM User limit 30 skip 30');

Doctrine MongoDB ODM www.doctri...

Selecting Slice of
Embedded Documents

$post = $dm->query('find title, comments limit 20 skip 10 FROM
BlogPos...

Other Examples
// Find all posts greater than or equal to a date
$posts = $dm->query('find all FROM BlogPost WHERE created...

Lifecycle Events

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

“A lifecycle event is a regular event with the additional
feature of providing a mechanism to register direct
callb...

• preRemove - The preRemove event occurs for a given document before the
respective DocumentManager remove operati...

Event Examples

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

/**
* @Document
* @HasLifecycleCallbacks
*/
...

Migrating Data

Doctrine MongoDB ODM www.doctrine-project.org www.sensiolabs.org

Initial Document
/**
* @Document
*/
...

New Document
/**
* @Document
*/
...

Migrate Documents
With Old Field Name
/**
* @Document
...

Questions?
Jonathan H. Wage
• http://www.twitter.com/jwage

...

Share Slideshare

LinkedIn
Facebook
Twitter

Embed

Size (px)

Show related Slideshows at end

WordPress Shortcode

Link

Share
Email

Mongo db manual by Deysi Gmarra 1535 views
Hands on Big Data Analysis with Mon... by Laura Ventura 1346 views
MongoDB DOC v1.5 by Tharun Srinivasa 484 views
Beginner's guide to Mongodb and NoS... by Maulin Shah 209 views
Mongo db crud guide by Deysi Gmarra 1151 views
MONGODB by Michael Wu 3873 views

View on Slideshare

1 of 73 Ad

View on Slideshare

1 of 73 Ad