Documentation
Azure SDK
Simple, lightweight, dependency-free and efficient Azure SDK for PHP.
Installation
composer require flow-php/azure-sdk
[!NOTE]
Since the Azure SDK is not providing any http client or factories, you need to install them manually. The following example uses thephp-http/discoverypackage to find the factories in your project existing dependencies. Use below links to find the implementations for client and the factories:
[!TIP] To fully benefit from SDK features, you need to install the following packages:
composer require flow-php/monolog-http-bridgethat will normalize request/response objects from logs context
[!WARNING] This implementation is not fully covering Azure SDK, only Storage related services are implemented. Feel free to contribute to the project and add more services.
Usage
The absolute minimum configuration to start using the SDK is to provide the account name and the account key.
<?php
use function Flow\Azure\SDK\DSL\azure_blob_service;
use function Flow\Azure\SDK\DSL\azure_blob_service_config;
use function Flow\Azure\SDK\DSL\azure_shared_key_authorization_factory;
$sdk = azure_blob_service(
azure_blob_service_config($account, $container),
azure_shared_key_authorization_factory($account, $accountKey),
);
Advanced
Since our goal is to not depend on any specific http client implementation, the library will use php-http/discovery to find the factories for the http client and the request/response objects. To gain full control over this library it need to be initialized like this:
<?php
use function Flow\Azure\SDK\DSL\azure_blob_service;
use function Flow\Azure\SDK\DSL\azure_blob_service_config;
use function Flow\Azure\SDK\DSL\azure_http_factory;
use function Flow\Azure\SDK\DSL\azure_shared_key_authorization_factory;
use function Flow\Azure\SDK\DSL\azure_url_factory;
use Http\Discovery\Psr17Factory;
use Http\Discovery\Psr18Client;
use Psr\Log\NullLogger;
$sdk = azure_blob_service(
azure_blob_service_config($account, $container),
azure_shared_key_authorization_factory($account, $accountKey),
new Psr18Client(),
azure_http_factory(request_factory: new Psr17Factory(), stream_factory: new Psr17Factory()),
azure_url_factory(),
new NullLogger(),
);
Examples
Contributors
Join us on GitHub
