{"id":16771060,"url":"https://github.com/ionbazan/aliyun-http-signer","last_synced_at":"2025-04-10T19:43:50.607Z","repository":{"id":49045622,"uuid":"259583220","full_name":"IonBazan/aliyun-http-signer","owner":"IonBazan","description":"PSR-7-compatible Alibaba Cloud API Gateway request signing implementation. Integrates with Guzzle ⛽️   and HttPlug 🐘.","archived":false,"fork":false,"pushed_at":"2023-05-05T15:44:52.000Z","size":26,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-14T06:26:37.995Z","etag":null,"topics":["alibaba-cloud","alibabacloud","aliyun","api-gateway","guzzle","hmac","httplug","php","psr-7","sign","signature"],"latest_commit_sha":null,"homepage":"https://packagist.org/packages/ion-bazan/aliyun-http-signer","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IonBazan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"IonBazan"}},"created_at":"2020-04-28T08:55:05.000Z","updated_at":"2023-05-05T18:31:49.000Z","dependencies_parsed_at":"2024-10-31T00:47:45.466Z","dependency_job_id":null,"html_url":"https://github.com/IonBazan/aliyun-http-signer","commit_stats":{"total_commits":10,"total_committers":1,"mean_commits":10.0,"dds":0.0,"last_synced_commit":"508aa026b380498360f06793a730648cbe12979e"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IonBazan%2Faliyun-http-signer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IonBazan%2Faliyun-http-signer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IonBazan%2Faliyun-http-signer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IonBazan%2Faliyun-http-signer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IonBazan","download_url":"https://codeload.github.com/IonBazan/aliyun-http-signer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281424,"owners_count":21077423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alibaba-cloud","alibabacloud","aliyun","api-gateway","guzzle","hmac","httplug","php","psr-7","sign","signature"],"created_at":"2024-10-13T06:26:37.778Z","updated_at":"2025-04-10T19:43:50.589Z","avatar_url":"https://github.com/IonBazan.png","language":"PHP","funding_links":["https://github.com/sponsors/IonBazan"],"categories":[],"sub_categories":[],"readme":"# Alibaba Cloud API Gateway HTTP Request Signer for PHP\n\n[![Latest version](https://img.shields.io/packagist/v/ion-bazan/aliyun-http-signer.svg)](https://packagist.org/packages/ion-bazan/aliyun-http-signer)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/IonBazan/aliyun-http-signer/php.yml?branch=main)](https://github.com/IonBazan/aliyun-http-signer/actions)\n[![PHP version](https://img.shields.io/packagist/php-v/ion-bazan/aliyun-http-signer.svg)](https://packagist.org/packages/ion-bazan/aliyun-http-signer)\n[![Codecov](https://img.shields.io/codecov/c/gh/IonBazan/aliyun-http-signer)](https://codecov.io/gh/IonBazan/aliyun-http-signer)\n[![Mutation testing badge](https://img.shields.io/endpoint?style=flat\u0026url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2FIonBazan%2Faliyun-http-signer%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/IonBazan/aliyun-http-signer/master)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/IonBazan/aliyun-http-signer/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/IonBazan/aliyun-http-signer/?branch=master)\n[![Downloads](https://img.shields.io/packagist/dt/ion-bazan/aliyun-http-signer.svg)](https://packagist.org/packages/ion-bazan/aliyun-http-signer)\n[![License](https://img.shields.io/packagist/l/ion-bazan/aliyun-http-signer.svg)](https://packagist.org/packages/ion-bazan/aliyun-http-signer)\n\nThis library implements [Alibaba Cloud API Gateway request signature](https://www.alibabacloud.com/help/doc-detail/29475.htm) calculation for [PSR-7](https://www.php-fig.org/psr/psr-7/) compatible requests.\nIt integrates with [Guzzle](https://github.com/guzzle/guzzle) and [HttPlug](https://github.com/php-http/httplug) but can be used with any PSR-7-compatible client.\n\n# Installation\nUse [Composer](https://getcomposer.org/) to install the package using:\n\n```bash\ncomposer require ion-bazan/aliyun-http-signer\n```\n\n# Usage\n\n## Symfony integration\n\nThe easiest way to integrate the package with Symfony is using [GuzzleBundleAliyunSignerPlugin](https://github.com/IonBazan/GuzzleBundleAliyunSignerPlugin) with Guzzle Bundle.\n\nTo use it with HttplugBundle or any other Bundle, simply register `RequestSigner`, `Key` and `RequestSignerPlugin` as services and inject the credentials to the `Key` service.\n\n## Sign a PSR-7-compatible API request \n\n```php\n\u003c?php\n\nrequire_once 'vendor/autoload.php';\n\nuse IonBazan\\AliyunSigner\\Key;\nuse IonBazan\\AliyunSigner\\RequestSigner;\nuse Psr\\Http\\Message\\RequestInterface;\n\nfunction signRequest(RequestInterface $request): RequestInterface\n{\n    // Provide credentials\n    $appId = '12345678';\n    $secret = base64_encode('secret');\n    \n    // Create signer\n    $signer = new RequestSigner(new Key($appId, $secret));\n\n    return $signer-\u003esignRequest($request);\n}\n```\n\n## Sign an API request using Guzzle middleware\n\n```php\n\u003c?php\n\nrequire_once 'vendor/autoload.php';\n\nuse GuzzleHttp\\Client;\nuse GuzzleHttp\\HandlerStack;\nuse IonBazan\\AliyunSigner\\Key;\nuse IonBazan\\AliyunSigner\\RequestSigner;\nuse IonBazan\\AliyunSigner\\Guzzle\\RequestSignerMiddleware;\n\n// Provide credentials\n$appId = '12345678';\n$secret = base64_encode('secret');\n\n// Create signer and middleware\n$signer = new RequestSigner(new Key($appId, $secret));\n$middleware = new RequestSignerMiddleware($signer);\n$stack = HandlerStack::create();\n$stack-\u003epush($middleware);\n\n$client = new Client(['handler' =\u003e $stack]);\n$response = $client-\u003eget('https://example.com/api/v1/test');\n```\n\n## Sign an API request using HttPlug plugin\n\n```php\n\u003c?php\n\nrequire_once 'vendor/autoload.php';\n\nuse Http\\Client\\Common\\PluginClient;\nuse Http\\Discovery\\HttpClientDiscovery;\nuse IonBazan\\AliyunSigner\\Key;\nuse IonBazan\\AliyunSigner\\RequestSigner;\nuse IonBazan\\AliyunSigner\\HttPlug\\RequestSignerPlugin;\n\n// Provide credentials\n$appId = '12345678';\n$secret = base64_encode('secret');\n\n// Create signer and plugin\n$signer = new RequestSigner(new Key($appId, $secret));\n$plugin = new RequestSignerPlugin($signer);\n$pluginClient = new PluginClient(\n    HttpClientDiscovery::find(),\n    [$plugin]\n);\n\n$pluginClient-\u003esendRequest($request);\n```\n\n# Bugs \u0026 issues\n\nIf you found a bug or security vulnerability, please [open an issue](https://github.com/IonBazan/aliyun-http-signer/issues/new)\n\n# Contributing\n\nPlease feel free to submit Pull Requests adding new features or fixing bugs.\n\nPlease note that code must follow PSR-1, PSR-2, PSR-4 and PSR-7.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fionbazan%2Faliyun-http-signer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fionbazan%2Faliyun-http-signer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fionbazan%2Faliyun-http-signer/lists"}