User Guide

Install Composer

Install composer via curl -s http://getcomposer.org/installer | php (on windows, download http://getcomposer.org/installer and execute it with PHP)

Laminas Skeleton Application

Create a new Skeleton application with Composer:

$ composer create-project laminas/laminas-mvc-skeleton doctrine-odm-tutorial

Grab a coffee and wait for composer to finish installing your new Laminas Application. Now you can start up your application with the php built-in web server:

$ cd doctrine-odm-tutorial$ php -S 0.0.0.0:8080 -t public/ public/index.php

For detailed instructions on installing the Laminas MVC Skeleton Application follow this link.

Install Doctrine Mongo ODM Module

Install DoctrineMongoODMModule :

$ composer require doctrine/doctrine-mongo-odm-module

Open config/application.config.php in your editor and add following keys to your modules (in this order):

'DoctrineModule','DoctrineMongoODMModule',

Copy vendor/doctrine/doctrine-mongo-odm-module/config/module.doctrine-mongo-odm.local.php.dist into your application’s config/autoload directory, rename it to module.doctrine-mongo-odm.local.php and make the appropriate changes.

Create the directories my/project/directory/data/DoctrineMongoODMModule/Proxy and my/project/directory/data/DoctrineMongoODMModule/Hydrator and make sure your application has write access to them.

Configure your Application module

Open module/Application/config/module.config.php and add the namespace to the top of the file:

<?phpnamespace Application;

Add this to the configuration array:

return [    // ...    // to register classes in the "/Document" folder of any module,    // you can copy&paste this block to a module config without modifying it.    'doctrine' => [        'driver' => [            __NAMESPACE__ . '_driver' => [                'class' => \Doctrine\ODM\MongoDB\Mapping\Driver\AttributeDriver::class,                'paths' => [                    __DIR__ . '/../src/' . __NAMESPACE__ . '/Document',                ],            ],            'odm_default' => [                'drivers' => [                    __NAMESPACE__ . '\Document' => __NAMESPACE__ . '_driver',                ],            ],        ],    ],];

Create a managed document class

Create your first Doctrine ODM managed document class in module/Application/src/Application/Document/Message.php. Here, we are using the Mongo ODM attribute syntax, which requires PHP 8.0 or newer.

use Doctrine\ODM\MongoDB\Mapping\Annotations as ODM;#[ODM\Document]class Message{    #[ODM\Id]    protected $id;    #[ODM\Field(type: "string")]    protected $text;    public function getId()    {        return $this->id;    }    public function setId($id)    {        $this->id = $id;    }    public function getText()    {        return $this->text;    }    public function setText($text)    {        $this->text = $text;    }}

Test the newly created document

To test your Doctrine ODM configuration, replace the indexAction in module/Application/src/Application/Controller/IndexController.php and add the document manager to the constructor:

use Application\Document\Message;use Laminas\Mvc\Controller\AbstractActionController;class IndexController extends AbstractActionController{    public function __construct(private DocumentManager $dm)    {}    public function indexAction()    {        $message = new Message();        $message->setText("Hello Doctrine!");        $this->dm->persist($message);        $this->dm->flush();        var_dump($message);        return new ViewModel();    }}

Next, you need to set up a factory for your controller in module/Application/src/Controller/IndexControllerFactory.php, to boostrap it with the instance of Doctrine's document manager:

use Psr\Container\ContainerInterface;class IndexControllerFactory{    public function __invoke(ContainerInterface $container)    {        return new IndexController($container->get('doctrine.documentmanager.odm_default'));    }}

Lastly, wire everything together by configuring your newly created factory for your controller in module/Application/config/module.config.php:

// ...'controllers' => [    'factories' => [        Controller\IndexController::class => Controller\IndexControllerFactory::class,    ],],// ...

When accessing the index controller, the dumped variable should contain a new generated id:

object(Application\Document\Message)[252]      protected 'id' => string '546a6bf935568055040041a9' (length=24)      protected 'text' => string 'Hello Doctrine!' (length=15)