lightsuner/carbon-bundle

Provide Carbon datetime lib. as annotations param. converter (SensioFrameworkExtraBundle)

2.3 2018-11-30 12:05 UTC

Requires

• nesbot/carbon: *
• sensio/framework-extra-bundle: 3.*
• symfony/form: ~2.3|~3.0

Requires (Dev)

• phpunit/phpunit: ^6.5

MIT

README

Carbon datetime component
Symfony2 convertors

This bundle provides an opportunity to convert Request and Form data into Carbon objects. Use a ParamConverter to convert Request data:

...
use Carbon\Carbon;
...

/**
 * @Route("/blog/archive/{start}/{end}")
 * @ParamConverter("start", options={"format": "Y-m-d"})
 * @ParamConverter("end", options={"format": "Y-m-d"})
 */
public function archiveAction(Carbon $start, Carbon $end)
{
}

No code changes are required for converting Form data. Symfony's built-in DateType and DateTimeType are automatically extended to return Carbon instances.

Installation

Step 1: Download Carbon SF2 Bundle using composer

Add Carbon SF2 Bundle in your composer.json:

For sensio/framework-extra-bundle 2.x follow this link.

For sensio/framework-extra-bundle 3.x

{
    "require": {
        "lightsuner/carbon-bundle": "2.*"
    }
}

Now tell composer to download the bundle by running the command:

$ php composer.phar update lightsuner/carbon-bundle

Composer will install the bundle to your project's vendor/lightsuner directory.

Step 2: Enable the bundle

Enable the bundle in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new LightSuner\CarbonBundle\CarbonBundle(),
    );
}