Initial Commit

Author: cargix1

.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+composer.lock

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 ShopifyExtras.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,51 @@
+# Shopify API Wrapper 
+By [ShopifyExtras.com](http://www.shopifyextras.com) - 24/7 Shopify Support - Bugs Resolved Same Day
+
+### Installing via Composer
+The recommended way to install the wrapper is through
+[Composer](http://getcomposer.org).
+
+```bash
+# Install Composer
+curl -sS https://getcomposer.org/installer | php
+```
+
+Next, run the Composer command to install the latest stable version of the wrapper:
+
+```bash
+composer require shopifyextras/shopify-api-wrapper
+```
+After installing, you need to require Composer's autoloader:
+
+```php
+require 'vendor/autoload.php';
+```
+
+### Getting Started
+
+First you will need to initialise the client like this:
+
+```
+$client = Shopify::settings(array(
+   "shopUrl" => $shopUrl,
+   "X-Shopify-Access-Token" => $accessToken
+));
+```
+
+Then you can begin making requests:
+```
+// Get a list of all products. 
+$client->getProducts();
+
+// Get a list of all orders. 
+$client->getOrders();
+
+// Get a specific product.
+$client->getProduct(array("id", $product_id));
+```
+
+### Bugs & Issues
+If you spot any bugs, please report it using the issue tracker. If you would like to contribute to the project please feel free to make your amends and submit a pull request. 
+
+### Professional Services
+Unfortunately we are unable to provide free technical support for the wrapper. If you require this kind of help then please contact us by emailing [[email protected]](mailto:[email protected]). 

composer.json

@@ -0,0 +1,32 @@
+{
+    "name": "ShopifyExtras/Shopify-PHP-API-Wrapper",
+    "description": "Shopify PHP (Guzzle) API Wrapper",
+    "type": "library",
+    "license": "MIT",
+    "homepage": "http://www.shopifyextras.com",
+    "authors": [
+        {
+            "name": "Andrew Cargill",
+            "email": "[email protected]"
+        }
+    ],
+    "require-dev": {
+        "phpunit/phpunit": "~4.2"
+    },
+    "require": {
+        "php": ">=5.4",
+        "guzzlehttp/guzzle": "~5.0.3",
+        "guzzlehttp/guzzle-services": "~0.4"
+    },
+    "autoload": {
+        "psr-4": {
+            "Shopify\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Shopify\\Tests\\": "tests/"
+        }
+    },
+    "minimum-stability": "stable"
+}

src/Client.php

@@ -0,0 +1,252 @@
+<?php namespace Shopify;
+
+use Monolog\Logger;
+use Monolog\Handler\StreamHandler;
+
+use GuzzleHttp\Client as BaseClient;
+use GuzzleHttp\Command\Guzzle\GuzzleClient;
+
+class Client
+{
+	
+	/**
+     * Guzzle service description
+     *
+     * @var \Shopify\Description
+     */
+    private static $description;
+    
+	
+	/**
+     * Guzzle base client
+     *
+     * @var \GuzzleHttp\Client
+     */
+    private $baseClient;
+    
+    
+    /**
+     * Adapter for Guzzle base client
+     *
+     * @var \GuzzleHttp\Adapter\AdapterInterface
+     */
+    private $baseClientAdapter;
+    
+    
+    /**
+     * Api client services
+     *
+     * @var \GuzzleHttp\Command\Guzzle\GuzzleClient
+     */
+    private $serviceClient;
+    
+    
+    /**
+     * Shopify client config settings
+     *
+     * @var array
+     */
+    private $settings;
+    
+    
+    /**
+     * Request header items
+     *
+     * @var array
+     */
+    private $globalParams = [
+            "shopUrl" => [
+                "type" => "string",
+                "location" => "uri",
+                "required" => true,
+            ],
+            "account_token" => [
+                "type" => "string",
+                "location" => "header",
+                "required" => false,
+                "sentAs" => "X-Shopify-Access-Token",
+            ],
+            "Content-Type" => [
+	            "type" => "string",
+	            "location" => "header",
+	            "required" => false,
+	            "sentAs" => "application/json"
+            ],
+            "X-Shopify-Access-Token" => [
+                "type" => "string",
+                "location" => "header",
+                "description" => "The Auth Token."
+			]
+        ];
+
+    /**
+     * Create a new GuzzleClient Service, ability to use the client
+     * without setting properties on instantiation.
+     *
+     * @param  array  $attributes
+     * @return void
+    */
+    public function __construct(array $settings = array())
+    {
+        $this->settings = $settings;
+    }
+
+
+	/**
+     * Merge additional settings with existing and save. Overrides
+     * existing settings as well.
+     *
+     * @param  array  $settings
+     * @return static
+     */
+    public function settings(array $settings)
+    {
+        $this->settings = array_merge($this->settings, $settings);
+        if ($this->serviceClient) $this->buildClient();
+        return $this;
+    }
+    
+
+	/**
+     * Load resource configuration file and return array.
+     *
+     * @param  string  $name
+     * @return array
+     */
+    private function loadResource($name)
+    {
+        return require __DIR__.'/resources/'.$name.'.php';
+    }
+    
+
+    /**
+     * Build new service client from descriptions.
+     *
+     * @return void
+     */
+    private function buildClient()
+    {
+        $client = $this->getBaseClient();
+       
+        if (!static::$description) {
+            $this->reloadDescription();
+        }
+
+        $this->serviceClient = new GuzzleClient(
+                $client,
+                static::$description,
+                ['emitter' => $this->baseClient->getEmitter()]
+            );
+    }
+    
+    /**
+     * Retrieve Guzzle base client.
+     *
+     * @return \GuzzleHttp\Client
+     */
+    private function getBaseClient()
+    {
+        return $this->baseClient ?: $this->baseClient = $this->loadBaseClient();
+    }
+    
+
+    /**
+     * Set adapter and create Guzzle base client.
+     *
+     * @return \GuzzleHttp\Client
+     */
+    private function loadBaseClient(array $settings = [])
+    {
+        if ($this->baseClientAdapter)
+            $settings['adapter'] = $this->baseClientAdapter;
+
+        return $this->baseClient = new BaseClient($settings);
+    }
+    
+
+    /**
+     * Description works tricky as a static
+     * property, reload as a needed.
+     *
+     * @return void
+     */
+    private function reloadDescription()
+    {
+        static::$description = new Description($this->loadConfig());
+    }
+    
+    
+    /**
+     * Load configuration file and parse resources.
+     *
+     * @return array
+     */
+    private function loadConfig()
+    {
+        $description = $this->loadResource('service-config');
+       
+        // initial description building, use api info and build base url
+        $description = $description + [
+                'baseUrl' => 'https://'.$this->settings['shopUrl'],
+                'operations' => [],
+                'models' => []
+            ];
+                        
+        // process each of the service description resources defined
+        foreach ($description['services'] as $serviceName) {
+	        
+            $service = $this->loadResource($serviceName);
+            $description = $this->loadServiceDescription($service, $description);
+        
+        }
+
+        // dead weight now, clean it up
+        unset($description['services']);
+        return $description;
+    }
+    
+    
+    /**
+     * Load service description from resource, add global
+     * parameters to operations. Operations and models
+     * added to full description.
+     *
+     * @param  array $service
+     * @param  array $description
+     * @return array
+     */
+    private function loadServiceDescription(array $service, array $description)
+    {
+        foreach ($service as $section => $set) {
+            if ($section == 'operations') {
+                // add global parameters to the operation parameters
+                foreach ($set as &$op)
+                    $op['parameters'] = isset($op['parameters'])
+                                    ? $op['parameters'] + $this->globalParams
+                                    : $this->globalParams;
+            }
+            $description[$section] = $description[$section] + $set;
+        }
+        return $description;
+    }
+    
+    
+    public function __call($method, $parameters)
+    {
+		if (!$this->serviceClient) $this->buildClient();
+
+		// gather parameters to pass to service definitions
+        $settings = $this->settings;
+
+        // merge client settings/parameters and method parameters
+        $parameters[0] = isset($parameters[0])
+                             ? $parameters[0] + $settings
+                             : $settings;
+          
+        $response = call_user_func_array([$this->serviceClient, $method], $parameters);
+
+		return $response;
+		 
+    }
+    
+}

src/Description.php

@@ -0,0 +1,16 @@
+<?php namespace Shopify;
+	
+use GuzzleHttp\Command\Guzzle\Description as GuzzleDescription;
+
+class Description extends GuzzleDescription
+{
+     /**
+     *
+     * @param  string  $url
+     * @return void
+     */
+     public function setBaseUrl($url)
+     {
+          $this->baseUrl = $url;
+     }
+}

src/Exception/UnauthorizedException.php

@@ -0,0 +1,3 @@
+<?php namespace Shopify\Exception;
+	
+class UnauthorizedException extends \OutOfBoundsException {}