magento-client
magento-client copied to clipboard
Magento API Client (SOAP v1). Allows wrappers for each call, dependencies injections and code completion.
Magento API Client
This library implements the Magento SOAP v1 (standard) API.
Features:
- allows wrappers
- allows dependencies injections
- allows code completion
- auto-updated via composer packaging (packagist.org)
Note: This library is not related to Magento Company.
Documentation
This API is designed on top of Magento SOAP API V1.
Supported modules are :
- Mage_Catalog
- Mage_CatalogInventory
- Mage_Checkout
- Mage_Customer
- Mage_Directory
- Mage_Sales
- Enterprise_CustomerBalance
- Enterprise_CustomerGiftCard
- Mage_GiftMessage
- Mage_Core
- Store View
Module's names has been standardized to be more clean :
- Catalog
- CatalogInventory
- Cart
- Customer
- Directory
- Order
- CustomerBalance
- GiftCard
- GiftMessage
- Core
- Store
Note : login
and logout
calls are made only if needed.
Installation
Download using composer:
{
"require": {
"smalot/magento-client": "*"
}
}
Now tell composer to download the bundle by running the command:
$ php composer.phar update smalot/magento-client
Composer will install the bundle to your project's vendor/smalot
directory and create
/update
an autoload file.
License
This library is provided under MIT license (since v0.5.0 release). See the complete license :
LICENSE
Implementation
Each module manager
, which heritate from MagentoModuleAbstract
, will generate an action
.
Actions can be either directly executed or added to a queue
.
If it is directly executed, it will generate a single call
, if not, that's a multi call
.
Single Call
Here is a sample code to load tree of categories of the default
website in a single call.
<?php
// Include composer's autoloader mecanism
include 'vendor/autoload.php';
// Init config
$path = 'http://domainname.tld/shop-folder/';
$apiUser = 'username';
$apiKey = 'xxxxxxxxxxxxxxxxxxx';
// Create remote adapter which wrap soapclient
$adapter = new \Smalot\Magento\RemoteAdapter($path, $apiUser, $apiKey);
// Call any module's class
$categoryManager = new \Smalot\Magento\Catalog\Category($adapter);
$tree = $categoryManager->getTree()->execute();
var_dump($tree);
Multi Call
Multi call is only available on Magento Soap v1
.
That's why this library is built on top of Magento Soap v1
.
This function allows to group multiple soap calls into only one http request, which can be a very great optimization practice.
It removes network latency
and reduce magento bootstrap processes.
Tipically, it can be used to synchronize a whole product catalog into very few number of calls.
<?php
// Include composer's autoloader mecanism
include 'vendor/autoload.php';
// Init config
$path = 'http://domainname.tld/shop-folder/';
$apiUser = 'username';
$apiKey = 'xxxxxxxxxxxxxxxxxxx';
// Create remote adapter which wrap soapclient
$adapter = new \Smalot\Magento\RemoteAdapter($path, $apiUser, $apiKey);
// Build the queue for multicall
$queue = new \Smalot\Magento\MultiCallQueue($adapter);
// Call any module's class
$productManager = new \Smalot\Magento\Catalog\Product($adapter);
$productManager->getInfo(10)->addToQueue($queue);
$productManager->getInfo(11)->addToQueue($queue);
$productManager->getInfo(12)->addToQueue($queue);
// Request in one multicall information of 3 products (#10, #11, #12)
$products = $queue->execute();
var_dump($products);
Callback support for multicall
<?php
// Include composer's autoloader mecanism
include 'vendor/autoload.php';
// Init config
$path = 'http://domainname.tld/shop-folder/';
$apiUser = 'username';
$apiKey = 'xxxxxxxxxxxxxxxxxxx';
// Create remote adapter which wrap soapclient
$adapter = new \Smalot\Magento\RemoteAdapter($path, $apiUser, $apiKey);
// Build the queue for multicall
$queue = new \Smalot\Magento\MultiCallQueue($adapter);
// Local catalog adapter
$localAdapter = new LocalAdapter(....);
// Store categories
$categoryManager = new \Smalot\Magento\Catalog\Category($adapter);
$categoryManager->getTree()->addToQueue($queue, array($localAdapter, 'updateCategories'));
// Store products into local catalog
$productManager = new \Smalot\Magento\Catalog\Product($adapter);
$productManager->getInfo(10)->addToQueue($queue, array($localAdapter, 'updateProduct'));
$productManager->getInfo(11)->addToQueue($queue, array($localAdapter, 'updateProduct'));
$productManager->getInfo(12)->addToQueue($queue, array($localAdapter, 'updateProduct'));
// Update local catalog
$products = $queue->execute();