From 6f6e86ee4884f9d77bd9510ae3a3c0056261e0b0 Mon Sep 17 00:00:00 2001
From: Trismegiste <florent.g@allopneus.com>
Date: Sat, 11 May 2013 17:33:47 +0200
Subject: [PATCH] adding the missing classes to show the real purpose of the
 pattern

---
 Command/Command.php      | 24 +++++-------------------
 Command/HelloCommand.php | 30 ++++++++++++++++++++++++++++++
 Command/Invoker.php      | 34 ++++++++++++++++++++++++++++++++++
 Command/Receiver.php     | 20 ++++++++++++++++++++
 4 files changed, 89 insertions(+), 19 deletions(-)
 create mode 100644 Command/HelloCommand.php
 create mode 100644 Command/Invoker.php
 create mode 100644 Command/Receiver.php

diff --git a/Command/Command.php b/Command/Command.php
index 60e09ad..17d639e 100644
--- a/Command/Command.php
+++ b/Command/Command.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace DesignPatterns;
+namespace DesignPatterns\Command;
 
 /**
  * Command pattern
@@ -10,7 +10,7 @@ namespace DesignPatterns;
  * We have an Invoker and a Receiver. This pattern use a "Command" to delegate the
  * method call against the Receiver and use the same method "execute".
  * Therefore, the Invoker just know to call "execute" to process the Command of
- * the client. 
+ * the client. The Receiver is decoupled from the Invoker
  * 
  * The second aspect of ths pattern is the undo(), which undoes the method execute()
  * Command can also be agregated to combine more complex commands with minimum
@@ -23,26 +23,12 @@ namespace DesignPatterns;
  *   can be implemented with the Command pattern (e.g. vagrant)
  *
  */
-interface CommandInterface
+interface Command
 {
+
     /**
      * this is the most important method in the Command pattern,
-     * all config options and parameters should go into the constructor
-     *
-     * @return mixed
+     * The Receiver go in the constructor.
      */
     public function execute();
 }
-
-class EchoCommand implements CommandInterface
-{
-    public function __construct($what)
-    {
-        $this->what = (string)$what;
-    }
-
-    public function execute()
-    {
-        echo $this->what;
-    }
-}
\ No newline at end of file
diff --git a/Command/HelloCommand.php b/Command/HelloCommand.php
new file mode 100644
index 0000000..1ba3ecb
--- /dev/null
+++ b/Command/HelloCommand.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace DesignPatterns\Command;
+
+/**
+ * This concrete command calls "print" on the Receiver, but an external
+ * invoker just know he can call "execute" 
+ */
+class HelloCommand implements Command
+{
+
+    protected $output;
+
+    /**
+     * Each concrete command is builded with different receivers.
+     * Can be one, many, none or even other Command in parameters 
+     */
+    public function __construct(Receiver $console)
+    {
+        $this->output = $console;
+    }
+
+    public function execute()
+    {
+        // sometimes, there is no receiver and this is the command which 
+        // does all the work
+        $this->output->write('Hello World');
+    }
+
+}
\ No newline at end of file
diff --git a/Command/Invoker.php b/Command/Invoker.php
new file mode 100644
index 0000000..75d7a23
--- /dev/null
+++ b/Command/Invoker.php
@@ -0,0 +1,34 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Command;
+
+/**
+ * Invoker is using the command given to it.
+ * Example : an Application in SF2
+ */
+class Invoker
+{
+
+    protected $command;
+
+    /**
+     * In the invoker we find this kind of method for subscribing the command.
+     * There can be also a stack, a list, a fixed set...
+     */
+    public function setCommand(Command $cmd)
+    {
+        $this->command = $cmd;
+    }
+
+    public function run()
+    {
+        // here is a key feature of the invoker
+        // the invoker is the same whatever is the command
+        $this->command->execute();
+    }
+
+}
\ No newline at end of file
diff --git a/Command/Receiver.php b/Command/Receiver.php
new file mode 100644
index 0000000..a9b6516
--- /dev/null
+++ b/Command/Receiver.php
@@ -0,0 +1,20 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Command;
+
+/**
+ * Receiver is specific service with its own contract and can be only concrete
+ */
+class Receiver
+{
+
+    public function write($str)
+    {
+        echo $str;
+    }
+
+}
\ No newline at end of file