A client to communicate with Magento from your Laravel application.
<?php
class Example
{
public function __construct(
protected \JustBetter\MagentoClient\Client\Magento $magento,
) {
}
public function retrieveProduct()
{
$response = $this->magento->get('products/1');
}
public function retrieveOrdersLazily()
{
$retrievedOrders = [];
$searchCriteria = \JustBetter\MagentoClient\Query\SearchCriteria::make()
->where('state', 'processing');
foreach ($this->magento->lazy('orders', $searchCriteria->get()) as $order) {
$retrievedOrders[] = $order['increment_id'];
}
}
public function multipleConnections()
{
$this->magento->connection('connection_one')->get('products/1');
$this->magento->connection('connection_two')->get('products/1');
}
}Are you coming from
grayloon/laravel-magento-api? We have written a migration guide!
Require this package:
composer require justbetter/laravel-magento-clientAdd the following to your .env:
MAGENTO_BASE_URL=
MAGENTO_ACCESS_TOKEN=
Optionally, publish the configuration file of this package.
php artisan vendor:publish --provider="JustBetter\MagentoClient\ServiceProvider" --tag=configThis package supports connecting to multiple Magento instances. In the configuration file you will find an array with the connections where you can configure each connection.
'connection' => 'default',
'connections' => [
'default' => [
/* Base URL of Magento, for example: https://magento.test */
'base_url' => env('MAGENTO_BASE_URL'),
// Other settings
],
'another_connection' => [
'base_url' => env('ANOTHER_MAGENTO_BASE_URL'),
// Other settings
],
],The connection setting sets which connection is used by default.
You can switch connections by using the connection method on the client.
/** @var \JustBetter\MagentoClient\Client\Magento $client */
$client = app(\JustBetter\MagentoClient\Client\Magento::class);
$client->connection('connection_one')->get('products');By default, this packages uses Bearer tokens to authenticate to Magento. Since Magento 2.4.4, this method of authentication requires additional configuration in Magento as described here.
It is recommended to authenticate to Magento using OAuth 1.0 which will also prevent the additional configuration requirements, besides setting up the integration itself.
Start by adding the following variable to your .env-file.
MAGENTO_AUTH_METHOD=oauth
Note that you can also remove MAGENTO_ACCESS_TOKEN at this point, as it will be saved in a file instead.
Next, open Magento and create a new integration. When configuring, supply a Callback URL and Identity link URL. If you have not made any changes to your configuration, these are the URLs:
Callback URL: https://example.com/magento/oauth/callback/{connection}
Identity link URL: https://example.com/magento/oauth/identity/{connection}
connection is the key in your connections array in the configuration file.
When creating the integration, Magento will send multiple tokens and secrets to your application via the callback-endpoint. This information will be saved in the database, as configured in magento.php. You may adjust this to save the key in a JSON file or create your own implementation
Magento will redirect you to the identity-endpoint in order to activate the integration.
For more information about OAuth 1.0 in Magento, please consult the documentation.
Caution
Be sure to add your authentication middleware
Note that the identity-endpoint does not have any authentication or authorization middleware by default - you should add this in the configuration yourself. If you do not have any form of protection, anyone could change the tokens in your secret file.
It is recommended that only administrators of your application are allowed to access the identity endpoint.
You can get an instance of the client by injecting it or by resolving it:
<?php
public function __construct(
protected \JustBetter\MagentoClient\Client\Magento $magento
) {
}
// OR
/** @var \JustBetter\MagentoClient\Client\Magento $client */
$client = app(\JustBetter\MagentoClient\Client\Magento::class);After you got an instance you can use the graphql, get, post, put and patch methods to use the Magento API.
To easily create search criteria you can use the \JustBetter\MagentoClient\Query\SearchCriteria class.
For example:
<?php
$search = \JustBetter\MagentoClient\Query\SearchCriteria::make()
->select('items[sku,name]')
->where('sku', '!=', '123')
->orWhere('price', '>', 10),
->whereIn('sku', ['123', '456'])
->orWhereNull('name')
->orderBy('sku')
->paginate(1, 50)
->get();You can view more examples in Magento's documentation.
You can connect to other connections using the connection method on the client.
/** @var \JustBetter\MagentoClient\Client\Magento $client */
$client = app(\JustBetter\MagentoClient\Client\Magento::class);
$client->connection('connection_one')->get('products');
$client->connection('connection_two')->get('products');You can run authenticated GraphQL queries using the graphql method on the client.
/** @var \JustBetter\MagentoClient\Client\Magento $client */
$client = app(\JustBetter\MagentoClient\Client\Magento::class);
$client->graphql(
'query searchProducts($search: String) {
products(
search: $search
) {
items {
sku
}
}
}',
[
'search' => 'test'
]
);You can view the tests for more examples.
This package uses Laravel's HTTP client so that you can fake the requests.
<?php
Http::fake([
'*/rest/all/V1/products*' => Http::response([
'items' => [['sku' => '::some_sku::']],
'total_count' => 1,
]),
]);To ensure the quality of this package, run the following command:
composer qualityThis will execute three tasks:
- Makes sure all tests are passed
- Checks for any issues using static code analysis
- Checks if the code is correctly formatted
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent