start a restructure

Creational/AbstractFactory/AbstractFactory.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory;
+
+/**
+ * class AbstractFactory
+ *
+ * Sometimes also known as "Kit" in a GUI libraries.
+ *
+ * This design pattern implements the Dependency Inversion Principle since
+ * it is the concrete subclass which creates concrete components.
+ *
+ * In this case, the abstract factory is a contract for creating some components
+ * for the web. There are two components : Text and Picture. There is two ways
+ * of rendering : HTML or JSON.
+ *
+ * Therefore 4 concretes classes, but the client just need to know this contract
+ * to build a correct http response (for a html page or for an ajax request)
+ */
+abstract class AbstractFactory
+{
+    /**
+     * Creates a text component
+     * 
+     * @param string $content
+     *
+     * @return Text
+     */
+    abstract public function createText($content);
+
+    /**
+     * Creates a picture component
+     * 
+     * @param string $path
+     * @param string $name
+     *
+     * @return Picture
+     */
+    abstract public function createPicture($path, $name = '');
+}

Creational/AbstractFactory/Html/Picture.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory\Html;
+
+use DesignPatterns\AbstractFactory\Picture as BasePicture;
+
+/**
+ * Class Picture
+ *
+ * Picture is a concrete image for HTML rendering
+ */
+class Picture extends BasePicture
+{
+    /**
+     * some crude rendering from HTML output
+     *
+     * @return string
+     */
+    public function render()
+    {
+        return sprintf('<img src="%s" title="$s"/>', $this->path, $this->name);
+    }
+}

Creational/AbstractFactory/Html/Text.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory\Html;
+
+use DesignPatterns\AbstractFactory\Text as BaseText;
+
+/**
+ * Class Text
+ *
+ * Text is a concrete text for HTML rendering
+ */
+class Text extends BaseText
+{
+    /**
+     * some crude rendering from HTML output
+     *
+     * @return string
+     */
+    public function render()
+    {
+        return '<div>' . htmlspecialchars($this->text) . '</div>';
+    }
+}

Creational/AbstractFactory/HtmlFactory.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory;
+
+/**
+ * Class HtmlFactory
+ *
+ * HtmlFactory is a concrete factory for HTML component
+ */
+class HtmlFactory extends AbstractFactory
+{
+    /**
+     * Creates a picture component
+     *
+     * @param string $path
+     * @param string $name
+     *
+     * @return Html\Picture|Picture
+     */
+    public function createPicture($path, $name = '')
+    {
+        return new Html\Picture($path, $name);
+    }
+
+    /**
+     * Creates a text component
+     *
+     * @param string $content
+     *
+     * @return Html\Text|Text
+     */
+    public function createText($content)
+    {
+        return new Html\Text($content);
+    }
+}

Creational/AbstractFactory/Json/Picture.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory\Json;
+
+use DesignPatterns\AbstractFactory\Picture as BasePicture;
+
+/**
+ * Class Picture
+ *
+ * Picture is a concrete image for JSON rendering
+ */
+class Picture extends BasePicture
+{
+    /**
+     * some crude rendering from JSON output
+     *
+     * @return string
+     */
+    public function render()
+    {
+        return json_encode(array('title' => $this->name, 'path' => $this->path));
+    }
+}

Creational/AbstractFactory/Json/Text.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory\Json;
+
+use DesignPatterns\AbstractFactory\Text as BaseText;
+
+/**
+ * Class Text
+ *
+ * Text is a text component with a JSON rendering
+ */
+class Text extends BaseText
+{
+    /**
+     * some crude rendering from JSON output
+     *
+     * @return string
+     */
+    public function render()
+    {
+        return json_encode(array('content' => $this->text));
+    }
+}

Creational/AbstractFactory/JsonFactory.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory;
+
+/**
+ * Class JsonFactory
+ *
+ * JsonFactory is a factory for creating a family of JSON component
+ * (example for ajax)
+ */
+class JsonFactory extends AbstractFactory
+{
+
+    /**
+     * Creates a picture component
+     *
+     * @param string $path
+     * @param string $name
+     *
+     * @return Json\Picture|Picture
+     */
+    public function createPicture($path, $name = '')
+    {
+        return new Json\Picture($path, $name);
+    }
+
+    /**
+     * Creates a text component
+     *
+     * @param string $content
+     *
+     * @return Json\Text|Text
+     */
+    public function createText($content)
+    {
+        return new Json\Text($content);
+    }
+}

Creational/AbstractFactory/MediaInterface.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory;
+
+/**
+ * Interface MediaInterface
+ *
+ * This contract is not part of the pattern, in general case, each component
+ * are not related
+ */
+interface MediaInterface
+{
+
+    /**
+     * some crude rendering from JSON or html output (depended on concrete class)
+     *
+     * @return string
+     */
+    public function render();
+}

Creational/AbstractFactory/Picture.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory;
+
+/**
+ * Class Picture
+ */
+abstract class Picture implements MediaInterface
+{
+
+    /**
+     * @var string
+     */
+    protected $path;
+
+    /**
+     * @var string
+     */
+    protected $name;
+
+    /**
+     * @param string $path
+     * @param string $name
+     */
+    public function __construct($path, $name = '')
+    {
+        $this->name = (string) $name;
+        $this->path = (string) $path;
+    }
+}

Creational/AbstractFactory/README.md

@@ -0,0 +1,6 @@
+# Abstract Factory
+
+## Purpose
+
+To create series of related or dependent objects without specifying their concrete classes.
+Usually the created classes all implement the same interface. The client of the abstract factory does not care about how these objects are created, he just knows how they go together.

Creational/AbstractFactory/Test/AbstractFactoryTest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace DesignPatterns\Tests\AbstractFactory;
+
+use DesignPatterns\AbstractFactory\AbstractFactory;
+use DesignPatterns\AbstractFactory\HtmlFactory;
+use DesignPatterns\AbstractFactory\JsonFactory;
+
+/**
+ * AbstractFactoryTest tests concrete factories
+ */
+class AbstractFactoryTest extends \PHPUnit_Framework_TestCase
+{
+    public function getFactories()
+    {
+        return array(
+            array(new JsonFactory()),
+            array(new HtmlFactory())
+        );
+    }
+
+    /**
+     * This is the client of factories. Note that the client does not
+     * care which factory is given to him, he can create any component he 
+     * wants and render how he wants.
+     * 
+     * @dataProvider getFactories
+     */
+    public function testComponentCreation(AbstractFactory $factory)
+    {
+        $article = array(
+            $factory->createText('Lorem Ipsum'),
+            $factory->createPicture('/image.jpg', 'caption'),
+            $factory->createText('footnotes')
+        );
+
+        $this->assertContainsOnly('DesignPatterns\AbstractFactory\MediaInterface', $article);
+
+        /* this is the time to look at the Builder pattern. This pattern
+         * helps you to create complex object like that article above with
+         * a given Abstract Factory
+         */
+    }
+}

Creational/AbstractFactory/Text.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace DesignPatterns\AbstractFactory;
+
+/**
+ * Class Text
+ */
+abstract class Text implements MediaInterface
+{
+    /**
+     * @var string
+     */
+    protected $text;
+
+    /**
+     * @param string $text
+     */
+    public function __construct($text)
+    {
+        $this->text = (string) $text;
+    }
+}