toiine/couchbasebundle

Symfony2 bundle to manipulate Couchbase Documents.

CouchbaseBundle

Symfony2 bundle to manipulate Couchbase Documents., _(*1)

, _(*2)

Installation

Installing the bundle via packagist is the quickest and simplest method of installing the bundle. Here are the steps:, _(*3)

Step 1: Composer require

$ php composer.phar require "toiine/couchbasebundle":"dev-master"

Step 2: Enable the bundle in the kernel

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Toiine\CouchbaseBundle\ToiineCouchbaseBundle(),
        // ...
    );
}

Configuration

There is a sample configuration file in Resources/config/couchbase.yml.dist, _(*4)

connections:
  conn1:
    # default is "localhost"
    # host:
    # default is 8091
    # port:
    username: admin
    password: admin
    bucket: default
  conn2:
    host: couchbase.tld
    port: 8092
    username: couchbase
    password: cOuchb4s3
    bucket: bucket2

Services

A compiler pass will generate services according to the configuration file, _(*5)

php app/console container:debug | grep couchbase

You can use toiine_couchbase.<connectionName> services to manipulate you documents., _(*6)

NB: documentation on other services will come soon., _(*7)

Usage

<?php

namespace Acme\HelloBundle\Controller;

use Symfony\Component\HttpFoundation\Response;

class DocController
{
    public function getDocumentAction($key)
    {
        $couchbase = $this->get('toiine_couchbase.conn1');

        // Get a doc from couchbase
        $doc = $couchbase->get($key);

        // Push a doc to couchbase
        $couchbase->set($key, $doc);

        // Delete a doc from couchbase
        $couchbase->delete($key);

        ...
    }
}

TODO

• add a profiling panel in the web debug toolbar : see the calls and the time they took
• integrate Jms Serializer : manipulate Entities through Couchbase the same way as Doctrine EntityManager