Merge pull request #23 from cocur/bundle

Add Symfony2 service

Author: Florian Eckerstorfer

README.md

@@ -18,6 +18,7 @@ Features
 - No external dependencies (except PHPUnit for testing).
 - PSR-4 compatible
 - Compatible with PHP >= 5.3.3 and [HHVM](http://hhvm.com)
+- Integration as service for the Symfony2 framework
 
 
 Installation
@@ -53,6 +54,32 @@ echo $slugify->slugify('Hello World!', '_'); // hello_world
 The library also contains `Cocur\Slugify\SlugifyInterface`. Use this interface whenever you reference a type in your code.
 
 
+Integrations
+------------
+
+### Symfony2
+
+Slugify contains a Symfony2 bundle and service definition that allow you to use it as a service in your Symfony2 application. The code resides in the `Cocur\Slugify\Bridge\Bundle` namespace and you only need to add the bundle class to your `AppKernel.php`:
+
+```php
+# app/AppKernel.php
+
+class AppKernel extends Kernel
+{
+    public function registerBundles()
+    {
+        $bundles = array(
+            // ...
+            new Cocur\Slugify\Bridge\Bundle\CocurSlugifyBundle(),
+        );
+        // ...
+    }
+
+    // ...
+}
+```
+
+
 Changelog
 ---------
 

composer.json

@@ -19,7 +19,9 @@
         "php": ">=5.3.3"
     },
     "require-dev": {
-        "phpunit/phpunit": "~3.7"
+        "phpunit/phpunit": "~3.7",
+        "symfony/http-kernel": "~2.4",
+        "symfony/dependency-injection": "~2.4"
     },
     "autoload": {
     	"psr-4": {

src/Bridge/Bundle/CocurSlugifyBundle.php

@@ -0,0 +1,40 @@
+<?php
+
+/**
+ * This file is part of cocur/slugify.
+ *
+ * (c) Florian Eckerstorfer <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Cocur\Slugify\Bridge\Bundle;
+
+use Symfony\Component\HttpKernel\Bundle\Bundle;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+
+/**
+ * CourSlugifyBundle
+ *
+ * @package    cocur/slugify
+ * @subpackage bridge
+ * @author     Florian Eckerstorfer <[email protected]>
+ * @copyright  2012-2014 Florian Eckerstorfer
+ * @license    http://www.opensource.org/licenses/MIT The MIT License
+ */
+class CocurSlugifyBundle extends Bundle
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function build(ContainerBuilder $container)
+    {
+        parent::build($container);
+
+        $extension = new CocurSlugifyExtension();
+        $extension->load(array(), $container);
+
+        $container->registerExtension($extension);
+    }
+}

src/Bridge/Bundle/CocurSlugifyExtension.php

@@ -0,0 +1,39 @@
+<?php
+
+/**
+ * This file is part of cocur/slugify.
+ *
+ * (c) Florian Eckerstorfer <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Cocur\Slugify\Bridge\Bundle;
+
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Definition;
+use Symfony\Component\HttpKernel\DependencyInjection\Extension;
+
+/**
+ * CocurSlugifyExtension
+ *
+ * @package    cocur/slugify
+ * @subpackage bridge
+ * @author     Florian Eckerstorfer <[email protected]>
+ * @copyright  2012-2014 Florian Eckerstorfer
+ * @license    http://www.opensource.org/licenses/MIT The MIT License
+ */
+class CocurSlugifyExtension extends Extension
+{
+    /**
+     * {@inheritDoc}
+     *
+     * @param mixed[]          $configs
+     * @param ContainerBuilder $container
+     */
+    public function load(array $configs, ContainerBuilder $container)
+    {
+        $container->setDefinition('cocur_slugify', new Definition('Cocur\Slugify\Slugify'));
+    }
+}

tests/Bridge/Bundle/CocurSlugifyBundleTest.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Cocur\Slugify\Bridge\Bundle;
+
+use Cocur\Slugify\Bridge\Bundle\CocurSlugifyBundle;
+
+/**
+ * CocurSlugifyBundleTest
+ *
+ * @group unit
+ */
+class CocurSlugifyBundleTest extends \PHPUnit_Framework_TestCase
+{
+    public function setUp()
+    {
+        $this->bundle = new CocurSlugifyBundle();
+    }
+
+    /**
+     * @test
+     * @covers Cocur\Slugify\Bridge\Bundle\CocurSlugifyBundle::build()
+     */
+    public function build()
+    {
+        $container = $this->getMock(
+            'Symfony\Component\DependencyInjection\ContainerBuilder',
+            array('registerExtension')
+        );
+        $container->expects($this->once())
+            ->method('registerExtension')
+            ->with($this->isInstanceOf('Cocur\Slugify\Bridge\Bundle\CocurSlugifyExtension'));
+
+        $this->bundle->build($container);
+    }
+}
+

tests/Bridge/Bundle/CocurSlugifyExtensionTest.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Cocur\Slugify\Bridge\Bundle;
+
+use Cocur\Slugify\Bridge\Bundle\CocurSlugifyExtension;
+
+/**
+ * CocurSlugifyExtensionTest
+ *
+ * @group unit
+ */
+class CocurSlugifyExtensionTest extends \PHPUnit_Framework_TestCase
+{
+    public function setUp()
+    {
+        $this->extension = new CocurSlugifyExtension();
+    }
+
+    /**
+     * @test
+     * @covers Cocur\Slugify\Bridge\Bundle\CocurSlugifyExtension::load()
+     */
+    public function load()
+    {
+        $container = $this->getMock(
+            'Symfony\Component\DependencyInjection\ContainerBuilder',
+            array('setDefinition')
+        );
+        $container->expects($this->once())
+            ->method('setDefinition')
+            ->with('cocur_slugify', $this->isInstanceOf('Symfony\Component\DependencyInjection\Definition'));
+
+        $this->extension->load(array(), $container);
+    }
+}
+