Doctrine2 PHPCR ODM
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead, 2061 commits behind doctrine:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


PHPCR ODM for Doctrine2

Current Status

  • most key features implemented
  • alpha stage


  • complete mapping for relations (parent, references), then remove the node mapping
  • ensure that no Jackalope specific classes are used (especially relevant for the tests)
  • have the register-system-node-types command provide api conform node type definition as well to support other implementations
  • add support for SQL/QOM
  • write documentation
  • expand test suite

Getting Started

  1. Install jackrabbit according to
    You need a patched jackrabbit and run the command to register types, as explained in the linked documtation.

  2. Define one of those mapping drivers

    // Annotation driver
    $reader = new \Doctrine\Common\Annotations\AnnotationReader();
    $driver = new \Doctrine\ODM\PHPCR\Mapping\Driver\AnnotationDriver($reader, array('/path/to/your/document/classes'));
    // Xml driver
    $driver = new \Doctrine\ODM\PHPCR\Mapping\Driver\XmlDriver(array('/path/to/your/mapping/files'));
    // Yaml driver
    $driver = new \Doctrine\ODM\PHPCR\Mapping\Driver\YamlDriver(array('/path/to/your/mapping/files'));
  3. Initialize a PHPCR session
    Eventually, this module will support all PHPCR backends, but at the moment it is only tested with jackalope jackrabbit.

    $repository = \Jackalope\RepositoryFactoryJackrabbit::getRepository(
                        array('jackalope.jackrabbit_uri' => 'http://localhost:8080/server'));
    $credentials = new \PHPCR\SimpleCredentials('user', 'pass');
    $session = $repository->login($credentials, 'your_workspace');
  4. Initialize the DocumentManager

    $config = new \Doctrine\ODM\PHPCR\Configuration();
    $dm = new \Doctrine\ODM\PHPCR\DocumentManager($session, $config);
  5. Example usage

    // fetching a document by JCR path (id in PHPCR ODM lingo)
    $user = $dm->getRepository('Namespace\For\Document\User')->find('/bob');
    //or let the odm find the document class for you
    $user = $dm->find('/bob');
    // create a new document
    $newUser = new \Namespace\For\Document\User();
    $newUser->username = 'Timmy';
    $newUser->email = '';
    $newUser->path = '/timmy';
    // store all changes, insertions, etc.
    //TODO: search example

Document Classes

You write your own document classes that will be mapped to and from the phpcr database by doctrine. The documents are usually simple

namespace Acme\SampleBundle\Document;

use Doctrine\ODM\PHPCR\Mapping\Annotations as PHPCRODM;

 * @PHPCRODM\Document
class MyDocument
     * @PHPCRODM\Id()
    public $path;
     * @PHPCRODM\String()
    public $title;

     * @PHPCRODM\String()
    public $content;

Note that there are basic Document classes for the standard PHPCR node types nt:file, nt:folder and nt:resource See lib/Doctrine/ODM/PHPCR/Document/

Storing documents in the repository: Id Generator Strategy

When defining an id its possible to choose the generator strategy. The id is the path where in the phpcr content repository the document should be stored. By default the assigned id generator is used, which requires manual assignment of the path to a field annotated as being the Id. You can tell doctrine to use a different strategy to find the id.

Currently, there is the "repository" strategy which calls can be used which calls generateId on the repository class to give you full control how you want to build the path.

namespace Acme\SampleBundle\Document;

use Doctrine\ODM\PHPCR\Id\RepositoryIdInterface;
use Doctrine\ODM\PHPCR\DocumentRepository as BaseDocumentRepository;
use Doctrine\ODM\PHPCR\Mapping\Annotations as PHPCRODM;

 * @PHPCRODM\Document(repositoryClass="Acme\SampleBundle\DocumentRepository")
class Document
    /** @PHPCRODM\Id(strategy="repository") */
    public $id;
    /** @PHPCRODM\String(name="title") */
    public $title;

class DocumentRepository extends BaseDocumentRepository implements RepositoryIdInterface
     * Generate a document id
     * @param object $document
     * @return string
    public function generateId($document)
        return 'functional/'.$document->title;

Available annotations

Id: The phpcr path to this node. (see above)
Uuid: The unique id of this node. (only allowed if node is referenceable).
Version: The version of this node, for versioned nodes.
Node: The PHPCR NodeInterface instance for direct access. (This is subject to be removed when we have mapped all functionality you can get from the PHPCR node.
Child(name=x): Map the child with name x to this field.
Children(filter=x): Map the collection of children with matching name to this field. Filter is optional and works like the parameter in PHPCR Node::getNodes() (see the API)
ReferenceOne(targetDocument="myDocument", weak=false): Refers a document of the type myDocument. The default is a weak reference. By optionaly specifying weak=false you get a hard reference.
ReferenceMany(targetDocument="myDocument", weak=false): Same as ReferenceOne except that you can refer many documents with the same document and reference type.
Referrers(filterName="x", referenceType=null): A field of this type stores documents that refer this document. filterName is optional. Its value is passed to the name parameter of Node::getReferences() or Node::getWeakReferences(). You can also specify an optional referenceType, weak or hard, to only get documents that have either a weak or a hard reference to this document. If you specify null then all documents with weak or hard references are fetched, which is also the default behavior.

In the parenthesis after the type, you can specify the name of the PHPCR property to store the value (name defaults to the php variable name you use), and whether this is a multivalue property. For example /**

  • @PHPCRODM\String(name="categories", multivalue=true) */ private $cat;

Lifecycle callbacks

You can use @PHPCRODM\PostLoad and friends to have doctrine call a method without parameters on your entity.

You can also define event listeners on the DocumentManager with $dm->getEventManager()->addEventListener(array(), listenerclass); Your class needs event name methods for the events. They get a parameter of type Doctrine\Common\EventArgs. See also

  • preRemove - occurs before a document is removed from the storage
  • postRemove - occurs after the document has been successfully removed
  • prePersist - occurs before a new document is created in storage
  • postPersist - occurs after a document has been created in storage. generated ids will be available in this state.
  • preUpdate - occurs before an existing document is updated in storage, during the flush operation
  • postUpdate - occurs after an existing document has successfully been updated in storage
  • postLoad - occurs after the document has been loaded from storage