cs

Author: Dominik Liebler

Adapter/EBookInterface.php

@@ -7,7 +7,17 @@
  */
 interface EBookInterface
 {
-    function pressNext();
+    /**
+     * go to next page
+     *
+     * @return mixed
+     */
+    public function pressNext();
 
-    function pressStart();
-}
+    /**
+     * start the book
+     *
+     * @return mixed
+     */
+    public function pressStart();
+}

Builder/BikeBuilder.php

@@ -5,35 +5,51 @@
 /**
  * BikeBuilder builds bike
  */
-class BikeBuilder implements Builder
+class BikeBuilder implements BuilderInterface
 {
-
+    /**
+     * @var Parts\Bike
+     */
     protected $bike;
 
+    /**
+     * {@inheritdoc}
+     */
     public function addDoors()
     {
-        
+
     }
 
+    /**
+     * {@inheritdoc}
+     */
     public function addEngine()
     {
         $this->bike->setPart('engine', new Parts\Engine());
     }
 
+    /**
+     * {@inheritdoc}
+     */
     public function addWheel()
     {
         $this->bike->setPart('forwardWheel', new Parts\Wheel());
         $this->bike->setPart('rearWheel', new Parts\Wheel());
     }
 
+    /**
+     * {@inheritdoc}
+     */
     public function createVehicle()
     {
         $this->bike = new Parts\Bike();
     }
 
+    /**
+     * {@inheritdoc}
+     */
     public function getVehicle()
     {
         return $this->bike;
     }
-
-}
+}

Builder/Builder.php renamed to Builder/BuilderInterface.php

@@ -14,7 +14,7 @@
  * Note: Builders have often a fluent interface, see the mock builder of
  * PHPUnit for example.
  */
-interface Builder
+interface BuilderInterface
 {
     /**
      * @return mixed

Builder/CarBuilder.php

@@ -5,7 +5,7 @@
 /**
  * CarBuilder builds car
  */
-class CarBuilder implements Builder
+class CarBuilder implements BuilderInterface
 {
     /**
      * @var Parts\Car

Builder/Director.php

@@ -14,8 +14,12 @@ class Director
 
     /**
      * The director don't know 'bout concrete part
+     *
+     * @param BuilderInterface $builder
+     *
+     * @return Parts\Vehicle
      */
-    public function build(Builder $builder)
+    public function build(BuilderInterface $builder)
     {
         $builder->createVehicle();
         $builder->addDoors();
@@ -24,5 +28,4 @@ public function build(Builder $builder)
 
         return $builder->getVehicle();
     }
-
-}
+}

ChainOfResponsibilities/ChainOfResponsibilities.php

@@ -0,0 +1,13 @@
+# chain of responsibilities
+
+## Purpose:
+
+To build a chain of objects to handle a call. if one object cannot handle a call, it delegates the call to the next
+in the chain and so forth
+
+## Examples:
+
+*  logging framework
+*  spam filter
+  Caching: first object is an instance of e.g. a Memcached Interface, if that "misses" it delegates the call to the database interface
+*  Yii Framework: CFilterChain is a chain of controller action filters. the executing point is passed from one filter to the next along the chain, and only if all filters say "yes", the action can be invoked at last.

ChainOfResponsibilities/README.md

@@ -33,7 +33,7 @@ public function getBuilder()
      * 
      * @dataProvider getBuilder
      */
-    public function testBuild(\DesignPatterns\Builder\Builder $builder)
+    public function testBuild(\DesignPatterns\Builder\BuilderInterface $builder)
     {
         $newVehicle = $this->director->build($builder);
         $this->assertInstanceOf('DesignPatterns\Builder\Parts\Vehicle', $newVehicle);