Added Zend\Stdlib\Hydrator\NamingStrategy\UnderscoreNamingStrategy doc

docs/src/index.rst

@@ -254,6 +254,7 @@ Programmer's Reference Guide of Zend Framework 2
    modules/zend.stdlib.hydrator.filter
    modules/zend.stdlib.hydrator.strategy
    modules/zend.stdlib.hydrator.aggregate
+   modules/zend.stdlib.hydrator.namingstrategy.underscorenamingstrategy
    modules/zend.tag.introduction
    modules/zend.tag.cloud
    modules/zend.test.introduction
@@ -896,6 +897,11 @@ Zend\\Stdlib
         * :doc:`modules/zend.stdlib.hydrator.strategy`
         * :doc:`modules/zend.stdlib.hydrator.aggregate`
 
+Zend\\Stdlib\\Hydrator\\NamingStrategy
+^^^^^^^^^^^^
+
+        * :doc:`modules/zend.stdlib.hydrator.namingstrategy.underscorenamingstrategy`
+
 .. _zend.tag:
 
 Zend\\Tag

docs/src/modules/zend.stdlib.hydrator.namingstrategy.underscorenamingstrategy.rst

@@ -0,0 +1,41 @@
+.. _zend.stdlib.hydrator.namingstrategy.underscorenamingstrategy:
+
+UnderscoreNamingStrategy
+========================
+
+``Zend\Stdlib\Hydrator\NamingStrategy\UnderscoreNamingStrategy`` Converts snake case strings (e.g. foo_bar_baz) to studly case strings (e.g. fooBarBaz) and vice versa. 
+
+Example Usage
+-------------
+
+.. code:: php
+
+    <?php
+    $namingStrategy = new \Zend\Stdlib\Hydrator\NamingStrategy\UnderscoreNamingStrategy();
+    echo $namingStrategy->extract('foo_bar'); // outputs: foo_bar
+    echo $namingStrategy->extract('Foo_Bar'); // outputs: foo_bar
+    echo $namingStrategy->extract('FooBar'); // outputs: foo_bar
+
+    echo $namingStrategy->hydrate('fooBar'); // outputs: fooBar
+    echo $namingStrategy->hydrate('FooBar'); // outputs: fooBar
+    echo $namingStrategy->hydrate('Foo_Bar'); // outputs: fooBar
+    ?>
+
+This strategy can be used in hydrators to dictate how keys should be mapped.
+
+.. code:: php
+
+    <?php
+    class Foo {
+        public $fooBar;
+    }
+
+    $hydrator = new \Zend\Stdlib\Hydrator\ObjectProperty();
+    $hydrator->setNamingStrategy(new \Zend\Stdlib\Hydrator\NamingStrategy\UnderscoreNamingStrategy());
+
+    $foo = new Foo();
+    $hydrator->hydrate(['foo_bar' => 123],$foo);
+
+    print_r($foo); // Foo Object ( [fooBar] => 123 )
+    print_r($hydrator->extract($foo)); // Array ( [foo_bar] => 123 )
+    ?>