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.
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.
Download using composer:
{
"require": {
"smalot/magento-client": "*"
}
}Now tell composer to download the bundle by running the command:
$ php composer.phar update smalot/magento-clientComposer will install the bundle to your project's vendor/smalot directory and create/update an autoload file.
This library is provided under MIT license (since v0.5.0 release). See the complete license :
LICENSE
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.
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 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);<?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();