在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:akeneo/api-php-client-ee开源软件地址:https://github.com/akeneo/api-php-client-ee开源编程语言:PHP 100.0%开源软件介绍:
|
PIM EE version(s) | API PHP Client EE version | CI status |
---|---|---|
v2.0 | v1.0 | |
v2.1 - v2.2 | v2.0 | |
v2.3 | v3.0 | |
v3.0 - v3.1 | v4.0 | |
v3.2 - v4.0 | v5.0 | |
v5.0 | v6.0 | - |
v6.0 | v7.0 | - |
- | master | - |
Note that our PHP client is backward compatible. For example, if your PIM is currently a v2.3, you can still use a 1.0 version of the PHP client. The new endpoints available in v2.3 will not be available in the v1.0 of the PHP client.
We use HTTPPlug as the HTTP client abstraction layer. In this example, we will use Guzzle v6 as the HTTP client implementation.
api-php-client-ee
uses Composer.
The first step to use api-php-client-ee
is to download composer:
$ curl -s http://getcomposer.org/installer | php
Then, run the following command to require the library:
$ php composer.phar require akeneo/api-php-client-ee php-http/guzzle6-adapter:^2.0 http-interop/http-factory-guzzle:^1.0
If you want to use another HTTP client implementation, you can check here the full list of HTTP client implementations.
Full documentation is available on the API website.
You first need to initialise the client with your credentials client id/secret and with your user/password.
If you don't have any client id, let's take a look at this page to create it.
<?php
require_once __DIR__ . '/vendor/autoload.php';
$clientBuilder = new \Akeneo\PimEnterprise\ApiClient\AkeneoPimEnterpriseClientBuilder('http://localhost/');
$client = $clientBuilder->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
You can authenticate to the client with your token/refresh token as well.
$client = $clientBuilder->buildAuthenticatedByToken('client_id', 'secret', 'token', 'refresh_token');
Getting the token and refresh token is as simple as:
$client->getToken();
$client->getRefreshToken();
$product = $client->getProductApi()->get('top');
echo $product['identifier']; // display "top"
$searchBuilder = new \Akeneo\Pim\ApiClient\Search\SearchBuilder();
$searchBuilder->addFilter('enabled', '=', true);
$searchFilters = $searchBuilder->getFilters();
$firstPage = $client->getProductApi()->listPerPage(50, true, ['search' => $searchFilters]);
echo $firstPage->getCount();
foreach ($firstPage->getItems() as $product) {
// do your stuff here
echo $product['identifier'];
}
$nextPage = $firstPage->getNextPage();
$firstPage = $nextPage->getPreviousPage();
$searchBuilder = new \Akeneo\Pim\ApiClient\Search\SearchBuilder();
$searchBuilder->addFilter('enabled', '=', true);
$searchFilters = $searchBuilder->getFilters();
$products = $client->getProductApi()->all(50, ['search' => $searchFilters]);
foreach ($products as $product) {
// do your stuff here
echo $product['identifier'];
}
$client->getProductApi()->create('top', ['enabled' => true]);
$client->getProductApi()->upsert('top', ['family' => 'tshirt']);
$client->getProductApi()->upsertList([
[
'identifier' => 'top',
'family' => 'tshirt',
],
[
'identifier' => 'cap',
'categories' => ['hat'],
],
]);
Do note that you have to delete the composer.lock
because Doctrine dependencies are loaded.
These dependencies are different in function of the PHP version running composer install
.
cp docker-compose.yml.dist docker-compose.yml
rm -rf composer.lock vendor/
docker-compose run client_72 composer install
docker-compose run client_72 bin/phpunit -c phpunit.xml.dist
docker-compose run client_72 bin/phpspec run
docker-compose run client_72 bin/php-cs-fixer fix --diff --dry-run --config=.php_cs.php -vvv
The support of this client is made in best effort by our Akeneo team.
If you find a bug or want to submit an improvement, don't hesitate to raise an issue on Github. Also, you can ask questions and discuss about the PHP client with the community in the Slack User Group.
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
请发表评论