Zend Framework 2: Integrate MongoDB By Doctrine ODM

ZF2 - Doctrine - MongoDB

Đang research để làm ứng dụng với MongoDB bằng ZF2. Ban đầu thì cũng không muốn dùng Doctrine cho lắm vì ám ảnh cái ORM MySQL của nó quá là mệt mỏi, khổ sở. Nên đã cố gắng mày mò cả mấy ngày trời để code với PHP extension, nhưng thật sự quá đuối. Có nhiều cái đuối, trong đó cái đuối to nhất chính là chưa có tẹo kinh nghiệm nào về MongoDB hết, nên thật sự là một khó khăn cho bản thân. Cũng qua nhiều nguồn tham khảo thì đều đánh giá ODM của Doctrine với MongoDB khá ổn, tốt, từ đó đi đến quyết định cuối sẽ xài qua Doctrine trước, khi nào có điều kiện và có thời gian hơn thì lại tiếp tục nghiên cứu. Bài viết chỉ mang tính chất ghi chú lại quá trình cài đặt.

Ở bài viết này, mình sử dụng composer phar để cài đặt lại ZF2, doctrine module ODM thay vì như những loạt bài trước. Sau khi mình cài xong bằng composer phar thì khoái luôn, vì muốn cài thêm cái gì cứ append vào và chạy lệnh. Rất nhanh so với cách thông thường.

Sau khi cài đặt xong ZF2, bạn mở tập tin composer.json để chỉnh sửa như đoạn bên dưới (nằm ngay trong thư mục gốc của project ZF2). Đây là một file dùng để cấu hình cài đặt cho composer phar.

{
    "name": "zendframework/skeleton-application",
    "description": "Skeleton Application for ZF2",
    "license": "BSD-3-Clause",
    "keywords": [
        "framework",
        "zf2"
    ],
    "homepage": "http://framework.zend.com/",
    "minimum-stability": "dev",
    "require": {
        "php": ">=5.3.3",
        "zendframework/zendframework": "2.2.*",
        "doctrine/doctrine-mongo-odm-module": "dev-master"
    }
}

Mọi người nên lưu ý dòng thứ 10 và dòng thứ 14 trong đoạn code bên trên. Dòng số 10 nếu như bạn quên sẽ không thể cài đặt được, mình đã bị dính chỗ này.

Tiếp theo, ra ngoài command line chạy lệnh sau (việc cài đặt thông qua composer phar bắt buộc cài đặt thông qua command line)

php composer.phar update

Chương trình sẽ tự động connect server và cài đặt, sau khi cài xong thì bạn sẽ tinh chỉnh 1 tí như sau.
Đầu tiên hết, bạn vào tập tin application.config.php (trong thư mục config của project) để bổ sung 2 module như sau

return array(
    'modules' => array(
        'Application',
        'DoctrineModule',
        'DoctrineMongoODMModule',
    ),
    'module_listener_options' => array(
        'module_paths' => array(
            './module',
            './vendor',
        ),
        'config_glob_paths' => array(
            'config/autoload/{,*.}{global,local}.php',
        ),
    ),
);

Mọi người lưu ý dòng số 4,5 - đó là 2 module mới được thêm vào: DoctrineModule & DoctrineMongoODMModule. Bạn không bật cái này lên sẽ không chạy được ứng dụng ODM của Doctrine.

Tiếp theo, bạn copy file module.doctrine-mongo-odm.local.php.dist trong thư mục (zf2-project/vendor/doctrine/doctrine-mongo-odm-module/config) sang thư mục zf2-project/config/autoload và đổi tên lại thành module.doctrine-mongo-odm.local.php. Sau khi copy, bạn cần tinh chỉnh cấu hình connect server mongo như đoạn code bên dưới.

return array(
  'doctrine' => array(
    'connection' => array(
      'odm_default' => array(
        'server'   => 'localhost', // Mongo server host name OR IP
        'port'   => '27017', // Mongo server port
        'user'   => null,
        'password' => null,
        'dbname'   => 'eav',
        'options'  => array()
      ),
    ),
    'configuration' => array(
      'odm_default' => array(
        'metadata_cache'   => 'array',
        'driver'       => 'odm_default',
        'generate_proxies'   => true,
        'proxy_dir'      => 'data/DoctrineMongoODMModule/Proxy',
        'proxy_namespace'  => 'DoctrineMongoODMModule\Proxy',
        'generate_hydrators' => true,
        'hydrator_dir'     => 'data/DoctrineMongoODMModule/Hydrator',
        'hydrator_namespace' => 'DoctrineMongoODMModule\Hydrator',
        'default_db'     => null,
        'filters'      => array(), // array('filterName' => 'BSON\Filter\Class'),
        'logger' => null // 'DoctrineMongoODMModule\Logging\DebugStack'
      )
    ),
    'driver' => array(
      'odm_default' => array(
        'drivers' => array()
      )
    ),
    'documentmanager' => array(
      'odm_default' => array(
        'connection'  => 'odm_default',
        'configuration' => 'odm_default',
        'eventmanager'  => 'odm_default'
      )
    ),
    'eventmanager'  => array(
      'odm_default' => array(
        'subscribers' => array()
      )
    ),
  ),
);

Cuối cùng, bạn cần vào thư mục zf2-project/data để tạo thêm 2 cây thư mục như bên dưới, và nhớ phải cấu hình cho nó có quyền ghi (trên Windows khỏi quan tâm cái này).

Như vậy là xong việc cấu hình MongoDB ODM với Doctrine module

---

Xem thêm các bài viết khác về ZF2 - tại blog tmquang6805.blogspot.com