Added Proxy Design Pattern

Author: Hyunk3l

Structural/Proxy/Api.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace PhpDesignPatterns\Structural\Proxy;
+
+/**
+ * Class Api
+ * @package PhpDesignPatterns\Structural\Proxy
+ */
+class Api
+{
+    /**
+     * Just a fake api call method.
+     *
+     * @param string $url
+     * @param array $data
+     * @param string $method
+     * @return array
+     */
+    public function doApiCall($url, array $data, $method)
+    {
+        // Implement dummy api call.
+        return array(
+            'status'    => 200,
+            'message'   => 'Api call performed successfully.',
+            'data'      => array(
+                'id'    => 1,
+                'name'  => 'foo',
+            ),
+        );
+    }
+}

Structural/Proxy/ApiProxy.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace PhpDesignPatterns\Structural\Proxy;
+
+/**
+ * Class ApiProxy
+ * @package PhpDesignPatterns\Structural\Proxy
+ */
+class ApiProxy extends Api
+{
+    /**
+     * Instance of Api.
+     *
+     * @var Api
+     */
+    private $wrapper;
+
+    /**
+     * Do api call using proxied object.
+     *
+     * @param string $url
+     * @param array $data
+     * @param string $method
+     * @return array
+     */
+    public function doApiCall($url, array $data, $method)
+    {
+        $this->init();
+        return $this->wrapper->doApiCall($url, $data, $method);
+    }
+
+    /**
+     * Initialize the proxied object.
+     */
+    private function init()
+    {
+        if(!$this->wrapper) {
+            $this->wrapper = new Api;
+        }
+    }
+}

Structural/Proxy/README.md

@@ -0,0 +1,7 @@
+# Proxy Design Pattern
+
+## Intent
+
+“Provide a surrogate or placeholder for another object to control access to it.”
+
+Excerpt From: Erich Gamma. “Design Patterns: Elements of Reusable Object-Oriented Software.”

Tests/Structural/Proxy/ApiProxyTest.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace PhpDesignPatterns\Tests\Structural\Proxy;
+
+use PhpDesignPatterns\Structural\Proxy\ApiProxy;
+
+/**
+ * Class ApiProxyTest
+ * @package PhpDesignPatterns\Tests\Structural\Proxy
+ */
+class ApiProxyTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * Test doApiCall.
+     */
+    public function testDoApiCall()
+    {
+        $expects = array(
+            'status'    => 200,
+            'message'   => 'Api call performed successfully.',
+            'data'      => array(
+                'id'    => 1,
+                'name'  => 'foo',
+            ),
+        );
+        $api = new ApiProxy;
+        $this->assertEquals($expects, $api->doApiCall('localhost', array(), 'GET'));
+    }
+}

Tests/Structural/Proxy/ApiTest.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace PhpDesignPatterns\Tests\Structural\Proxy;
+
+use PhpDesignPatterns\Structural\Proxy\Api;
+
+/**
+ * Class ApiTest
+ * @package PhpDesignPatterns\Tests\Structural\Proxy
+ */
+class ApiTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * Testing doApiCall.
+     */
+    public function testDoApiCall()
+    {
+        $expects = array(
+            'status'    => 200,
+            'message'   => 'Api call performed successfully.',
+            'data'      => array(
+                'id'    => 1,
+                'name'  => 'foo',
+            ),
+        );
+        $api = new Api();
+        $this->assertEquals($expects, $api->doApiCall('localhost', array(), 'GET'));
+    }
+}