From afb62569d36c310e6609ed6502807c140c433e47 Mon Sep 17 00:00:00 2001
From: Dominik Liebler <dominik@liebler-web.de>
Date: Sun, 21 Aug 2011 16:03:10 +0200
Subject: [PATCH] added abstract factory and factory pattern

---
 AbstractFactory/AbstractFactory.php | 40 +++++++++++++++++++++++
 AbstractFactory/Media.php           | 15 +++++++++
 AbstractFactory/Picture.php         | 27 ++++++++++++++++
 AbstractFactory/Text.php            | 24 ++++++++++++++
 FactoryMethod/FactoryMethod.php     | 49 +++++++++++++++++++++++++++++
 5 files changed, 155 insertions(+)
 create mode 100644 AbstractFactory/AbstractFactory.php
 create mode 100644 AbstractFactory/Media.php
 create mode 100644 AbstractFactory/Picture.php
 create mode 100644 AbstractFactory/Text.php
 create mode 100644 FactoryMethod/FactoryMethod.php

diff --git a/AbstractFactory/AbstractFactory.php b/AbstractFactory/AbstractFactory.php
new file mode 100644
index 0000000..9473cf4
--- /dev/null
+++ b/AbstractFactory/AbstractFactory.php
@@ -0,0 +1,40 @@
+<?php
+
+namespace DesignPatterns;
+
+/**
+ * Abstract Factory pattern
+ *
+ * Purpose:
+ * to create series of related or dependant objects without specifying their concrete classes,
+ * usually created classes would all implement the same interface
+ *
+ * Examples:
+ * - A Factory to create media in a CMS: classes would be text, audio, video, picture
+ * - SQL Factory (types are all strings with SQL, but they vary in detail (tables, fields, etc.))
+ * - Zend Framework: Zend_Form::createElement() creates form elements, but you could also call new TextElement() or so
+ *
+ */
+abstract class AbstractFactory
+{
+    /**
+     * @static
+     * @param string $content
+     * @return AbstractFactory\Text
+     */
+    public static function createText($content)
+    {
+        return new AbstractFactory\Text($content);
+    }
+
+    /**
+     * @static
+     * @param string $path
+     * @param string $name
+     * @return AbstractFactory\Picture
+     */
+    public static function createPicture($path, $name = '')
+    {
+        return new AbstractFactory\Picture($path, $name);
+    }
+}
diff --git a/AbstractFactory/Media.php b/AbstractFactory/Media.php
new file mode 100644
index 0000000..7d6fa6d
--- /dev/null
+++ b/AbstractFactory/Media.php
@@ -0,0 +1,15 @@
+<?php
+/**
+ * Created by JetBrains PhpStorm.
+ * User: dominik
+ * Date: 21.08.11
+ * Time: 15:47
+ * To change this template use File | Settings | File Templates.
+ */
+
+namespace DesignPatterns\AbstractFactory;
+
+interface Media
+{
+
+}
diff --git a/AbstractFactory/Picture.php b/AbstractFactory/Picture.php
new file mode 100644
index 0000000..b719349
--- /dev/null
+++ b/AbstractFactory/Picture.php
@@ -0,0 +1,27 @@
+<?php
+/**
+ * Created by JetBrains PhpStorm.
+ * User: dominik
+ * Date: 21.08.11
+ * Time: 15:42
+ * To change this template use File | Settings | File Templates.
+ */
+
+namespace DesignPatterns\AbstractFactory;
+
+class Picture implements Media
+{
+    protected $_path;
+    protected $_name;
+
+    /**
+     *
+     * @param string $path
+     * @param string $name
+     */
+    public function __construct($path, $name = '')
+    {
+        $this->_name = (string) $name;
+        $this->_path = (string) $path;
+    }
+}
diff --git a/AbstractFactory/Text.php b/AbstractFactory/Text.php
new file mode 100644
index 0000000..ce18580
--- /dev/null
+++ b/AbstractFactory/Text.php
@@ -0,0 +1,24 @@
+<?php
+/**
+ * Created by JetBrains PhpStorm.
+ * User: dominik
+ * Date: 21.08.11
+ * Time: 15:42
+ * To change this template use File | Settings | File Templates.
+ */
+
+namespace DesignPatterns\AbstractFactory;
+
+class Text implements Media
+{
+    /**
+     * 
+     * @var string
+     */
+    protected $_text;
+
+    public function __construct($text)
+    {
+        $this->_text = $text;
+    }
+}
diff --git a/FactoryMethod/FactoryMethod.php b/FactoryMethod/FactoryMethod.php
new file mode 100644
index 0000000..8640078
--- /dev/null
+++ b/FactoryMethod/FactoryMethod.php
@@ -0,0 +1,49 @@
+<?php
+
+namespace DesignPatterns;
+
+/**
+ * Factory Method pattern
+ *
+ * Purpose:
+ * similar to the AbstractFactory, this pattern is used to create series of related or dependant objects.
+ * The difference between this and the abstract factory pattern is that the factory method pattern uses just one static
+ * method to create all types of objects it can create. It is usually named "factory" or "build".
+ *
+ * Examples:
+ * - Zend Framework: Zend_Cache_Backend or _Frontend use a factory method create cache backends or frontends
+ * 
+ */
+class FactoryMethod
+{
+    /**
+     * the parametrized function to get create an instance
+     *
+     * @static
+     * @return Format
+     */
+    public static function factory($type)
+    {
+        $className = 'Format' . ucfirst($type);
+        if ( ! class_exists($className)) {
+            throw new Exception('Missing format class.');
+        }
+
+        return new $className();
+    }
+}
+
+interface Formatter
+{
+
+}
+
+class FormatString implements Formatter
+{
+
+}
+
+class FormatNumber implements Formatter
+{
+    
+}