Using a Custom Document Class Mapper with PHPCR-ODM

The default document class mapper of PHPCR-ODM uses the attribute phpcr:class to store and retrieve the document class of a node. When accessing an existing PHPCR repository, you might need different logic to decide on the class.

You can extend the DocumentClassMapper or implement DocumentClassMapperInterface from scratch. The important methods are getClassName that needs to find the class name and writeMetadata that needs to make sure the class of a newly stored document can be determined when loading it again.

An example mapper from the symfony cmf sandbox (magnolia_integration branch):

namespace Sandbox\MagnoliaBundle\Document;

use Doctrine\ODM\PHPCR\DocumentClassMapper;
use Doctrine\ODM\PHPCR\DocumentManager;

use PHPCR\NodeInterface;
use PHPCR\PropertyType;

class MagnoliaDocumentClassMapper extends DocumentClassMapper
    private $templateMap;

     * @param array $templateMap map from mgnl:template values to document class names
    public function __construct($templateMap)
        $this->templateMap = $templateMap;

     * Determine the class name from a given node
     * @param DocumentManager
     * @param NodeInterface $node
     * @param string $className
     * @return string
     * @throws \RuntimeException if no class name could be determined
    public function getClassName(DocumentManager $dm, NodeInterface $node, $className = null)
        $className = parent::getClassName($dm, $node, $className);
        if ('Doctrine\ODM\PHPCR\Document\Generic' == $className) {
            if ($node->hasNode('MetaData')) {
                $metaData = $node->getNode('MetaData');
                if ($metaData->hasProperty('mgnl:template')) {
                    if (isset($this->templateMap[$metaData->getPropertyValue('mgnl:template')])) {
                        return $this->templateMap[$metaData->getPropertyValue('mgnl:template')];

        return $className;

Then adjust your bootstrap code to use the custom mapper.


/* prepare the doctrine configuration */
$config = new \Doctrine\ODM\PHPCR\Configuration();
$map = array(
    'standard-templating-kit:pages/stkSection' => 'Sandbox\MagnoliaBundle\Document\Section',
$mapper = new MagnoliaDocumentClassMapper($map);

$documentManager = \Doctrine\ODM\PHPCR\DocumentManager::create($session, $config);


Symfony2 integration

If you are running on Symfony2, you do not instantiate PHPCR-ODM manually. Instead, you adjust the configuration in your service definition.

Here we overwrite the doctrine.odm_configuration service to call setDocumentClassMapper on it. This will make it use this mapper instead of instantiating the default one. An example from the symfony cmf sandbox (magnolia_integration branch):

  • YAML
    # if you want to overwrite default configuration, otherwise use a
    # custom name and specify in odm configuration block
        class: %doctrine_phpcr.odm.configuration.class%
            - [ setDocumentClassMapper, [@sandbox_magnolia.odm_mapper] ]
        class: "Sandbox\MagnoliaBundle\Document\MagnoliaDocumentClassMapper"
            - 'standard-templating-kit:pages/stkSection': 'Sandbox\MagnoliaBundle\Document\Section'
  • XML
    <service id="doctrine.odm_configuration"
        <call method="setDocumentClassMapper">
            <argument type="service" id="sandbox_magnolia.odm_mapper" />
    <service id="sandbox_magnolia.odm_mapper"
        <argument type="collection">
            <argument type="standard-templating-kit:pages/stkSection">Sandbox\MagnoliaBundle\Document\Section</argument>
  • PHP
    use Symfony\Component\DependencyInjection\Definition;
    use Symfony\Component\DependencyInjection\Reference;
        ->register('doctrine.odm_configuration', '%doctrine_phpcr.odm.configuration.class%')
        ->addMethodCall('setDocumentClassMapper', array(
            new Reference('sandbox_magnolia.odm_mapper'),
    $container ->setDefinition('sandbox_amgnolia.odm_mapper', new Definition(
                'standard-templating-kit:pages/stkSection' => 'Sandbox\MagnoliaBundle\Document\Section',
Fork me on GitHub