PHPackages lmc/cqrs-http - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. lmc/cqrs-http ActiveLibrary[API Development](/categories/api) lmc/cqrs-http ============= A library containing base implementations to help with Http Queries and Commands 3.1.0(2y ago)139.3k↓47.3%13MITPHPPHP ^8.2 Since May 13Pushed 2y ago11 watchersCompare [ Source](https://github.com/lmc-eu/cqrs-http)[ Packagist](https://packagist.org/packages/lmc/cqrs-http)[ RSS](/packages/lmc-cqrs-http/feed)WikiDiscussions main Synced yesterday READMEChangelog (3)Dependencies (14)Versions (6)Used By (3) LMC CQRS Http extension ======================= [](#lmc-cqrs-http-extension) [![cqrs-types](https://camo.githubusercontent.com/d2e4a1ae4631bc4819c80a7abc5aa314a298c371e9ab906ccf0eecdd16e00aaa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f637172732d74797065732d707572706c652e737667)](https://github.com/lmc-eu/cqrs-types)[![Latest Stable Version](https://camo.githubusercontent.com/bd8c2892f22e97b059166fc4f711df670e68cc8fd8ae38c8c04aa5db949ccd38/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6d632f637172732d687474702e737667)](https://packagist.org/packages/lmc/cqrs-http)[![Tests and linting](https://github.com/lmc-eu/cqrs-http/actions/workflows/tests.yaml/badge.svg)](https://github.com/lmc-eu/cqrs-http/actions/workflows/tests.yaml)[![Coverage Status](https://camo.githubusercontent.com/761a6d6a7dca9c17a087ba4c6df27bf214816e1161b99f0fec91eadfe3c9b4d0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6c6d632d65752f637172732d687474702f62616467652e7376673f6272616e63683d6d61696e)](https://coveralls.io/github/lmc-eu/cqrs-http?branch=main) > A library containing base implementations to help with Http Queries and Commands. This library is an extension for [CQRS/Bundle](https://github.com/lmc-eu/cqrs-bundle) and adds support for [PSR-7](https://www.php-fig.org/psr/psr-7/). Table of contents ----------------- [](#table-of-contents) - [Installation](#installation) - Queries - [Query](#query) - [Abstract HTTP Query](#abstracthttpquery) - [Abstract HTTP GET Query](#abstracthttpgetquery) - [Query Handlers](#query-handlers) - Commands - [Command](#command) - [Abstract HTTP Command](#abstracthttpcommand) - [Abstract HTTP DELETE Command](#abstracthttpdeletecommand) - [Abstract HTTP PATCH Command](#abstracthttppatchcommand) - [Abstract HTTP POST Command](#abstracthttppostcommand) - [Abstract HTTP PUT Command](#abstracthttpputcommand) - [Send Command Handlers](#send-command-handlers) - [Response Decoders](#response-decoders) - [Profiler Formatters](#profiler-formatters) Installation ------------ [](#installation) ``` composer require lmc/cqrs-http ``` **NOTE**: You will also need an implementation for [PSR-7](https://packagist.org/providers/psr/http-message-implementation), [PSR-17](https://packagist.org/providers/psr/http-factory-implementation) and [PSR-18](https://packagist.org/providers/psr/http-client-implementation) for HTTP extensions to work. Query ----- [](#query) Query is a request which fetch a data without changing anything. [See more here](https://github.com/lmc-eu/cqrs-types#query-interface) ### AbstractHttpQuery [](#abstracthttpquery) A base HTTP Query, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a query*). It also implements a `ProfileableInterface` feature. MethodTypeDescription`getRequestType`**final**It declares a request type of a Http query to be a `Psr\Http\Message\RequestInterface``getHttpMethod`abstractIt requires a query to return a http method of a query. (see [PSR Http Message Util](https://github.com/php-fig/http-message-util))`getUri`abstractThis method returns a URI of the Query - it may be just a string or a `Psr\Http\Message\UriInterface` (PSR-7) instance.`modifyRequest`*base*If you overwrite this method, you can manipulate a `RequestInterface` instance.`getProfilerId`*base*It's a predefined creating of profiler id for a http query. It creates a profiler id based on `http method` and `uri`.`getProfilerData`*base*If you overwrite this method, you can specify additional profiler data. Default is `null` (*no data*).`__toString`*base*It's a predefined casting a Query into string, it returns a string representation of `uri`.### AbstractHttpGetQuery [](#abstracthttpgetquery) A base HTTP **GET** Query, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a query*). It extends a base `AbstractHttpQuery` and predefine some abstract methods. It also adds `CacheableInterface` feature, since a GET request is mostly cacheable MethodTypeDescription`getHttpMethod`**final**It declares a http method of this query to be `GET`.`getUri`abstractThis method returns a URI of the Query - it may be just a `string` or a `Psr\Http\Message\UriInterface` (PSR-7) instance.`getCacheTime`*base*It returns a default value for a cache time of 30 minutes.`getCacheKey`*base*It creates a `CacheKey` out of a static class name (*your implementation class name*) and a `uri`, which should create a unique enough cache key for most queries.**TIP**: If you want to use this implementation but don't need a cache, you can simply return a `CacheTime::noCache()` in your implementation of `getCacheTime` method. Query Handlers -------------- [](#query-handlers) It is responsible for handling a specific Query request and passing a result into `OnSuccess` callback. [See more here](https://github.com/lmc-eu/cqrs-types#query-handler-interface). ### Http Query Handler [](#http-query-handler) This handler supports `Psr\Http\Message\RequestInterface` and handles it into `Psr\Http\Message\ResponseInterface`. It also checks a status code of a response and marks it as error if it is an error code: - 400 -> `HttpBadRequestException` - 500 -> `HttpServerErrorException` --- Command ------- [](#command) Command is a request which change a data and may return result data. [See more here](https://github.com/lmc-eu/cqrs-types#command-interface) ### AbstractHttpCommand [](#abstracthttpcommand) A base HTTP Command, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a command*). It also implements a `ProfileableInterface` feature. MethodTypeDescription`getRequestType`**final**It declares a request type of a Http command to be a `Psr\Http\Message\RequestInterface``getHttpMethod`abstractIt requires a command to return a http method of a command. (see [PSR Http Message Util](https://github.com/php-fig/http-message-util))`getUri`abstractThis method returns a URI of the Command - it may be just a `string` or a `Psr\Http\Message\UriInterface` (PSR-7) instance.`modifyRequest`*base*If you overwrite this method, you can manipulate a `RequestInterface` instance.`getProfilerId`*base*It's a predefined creating of profiler id for a http command. It creates a profiler id based on `http method` and `uri`.`getProfilerData`*base*If you overwrite this method, you can specify additional profiler data. Default is `null` (*no data*).`__toString`*base*It's a predefined casting a Command into string, it returns a string representation of `uri`.### AbstractHttpDeleteCommand [](#abstracthttpdeletecommand) A base HTTP **DELETE** Command, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a command*). It extends a base `AbstractHttpCommand` and predefine some abstract methods. MethodTypeDescription`getHttpMethod`**final**It declares a http method of this query to be `DELETE`.### AbstractHttpPatchCommand [](#abstracthttppatchcommand) A base HTTP **PATCH** Command, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a command*). It extends a base `AbstractHttpCommand` and predefine some abstract methods. MethodTypeDescription`getHttpMethod`**final**It declares a http method of this query to be `PATCH`.### AbstractHttpPostCommand [](#abstracthttppostcommand) A base HTTP **POST** Command, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a command*). It extends a base `AbstractHttpCommand` and predefine some abstract methods. MethodTypeDescription`getHttpMethod`**final**It declares a http method of this query to be `POST`.`createBody`abstractIt requires a command to return an instance of `Psr\Http\Message\StreamInterface` which is used as a POST request body.`createRequest`*base*It creates a request with a body.`getProfilerData`*base*It adds a `Body` into additional data for profiler, so it may be shown later in profiler.### AbstractHttpPutCommand [](#abstracthttpputcommand) A base HTTP **PATCH** Command, it abstracts a creating of a `Psr\Http\Message\RequestInterface` (PSR-7) using a `Psr\Http\Message\RequestFactoryInterface` (PSR-17) (*it is directly required to be injected into a command*). It extends a base `AbstractHttpCommand` and predefine some abstract methods. MethodTypeDescription`getHttpMethod`**final**It declares a http method of this query to be `PATCH`.Send Command Handlers --------------------- [](#send-command-handlers) It is responsible for handling a specific Command request and passing a result into `OnSuccess` callback. [See more here](https://github.com/lmc-eu/cqrs-types#send-command-handler-interface). ### Http Send Command Handler [](#http-send-command-handler) This handler supports `Psr\Http\Message\RequestInterface` and handles it into `Psr\Http\Message\ResponseInterface`. It also checks a status code of a response and marks it as error if it is an error code: - 400 -> `HttpBadRequestException` - 500 -> `HttpServerErrorException` --- Response Decoders ----------------- [](#response-decoders) It is meant to decode a response (a result of either `QueryHandlerInterface` or a `SendCommandHandlerInterface`). [See more here](https://github.com/lmc-eu/cqrs-types#response-decoder-interface). ### HttpMessageResponseDecoder [](#httpmessageresponsedecoder) It decodes a `Psr\Http\Message\ResponseInterface` into a `Psr\Http\Message\StreamInterface` by getting a body of a response. ### StreamResponseDecoder [](#streamresponsedecoder) It decodes a `Psr\Http\Message\StreamInterface` into a `string` by getting a stream contents (*if possible*). **Note**: There is also a [JsonResponseDecoder](https://github.com/lmc-eu/cqrs-types#jsonresponsedecoder) which decodes a string into an array. Profiler Formatters ------------------- [](#profiler-formatters) ### HttpProfilerFormatter [](#httpprofilerformatter) It formats a `Psr\Http\Message\MessageInterface` and `Psr\Http\Message\StreamInterface` into a readable format, so a data is nicer in profiler. ### Health Score 37 — LowBetter than 81% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community17 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~342 days Total 4 Last Release 849d ago Major Versions 1.0.0 → 2.0.02021-08-10 2.0.0 → 3.0.02022-04-27 PHP version history (3 changes)1.0.0PHP ^7.4 3.0.0PHP ^8.1 3.1.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/2bdf0b9957c08a48e70a52fce74fc4f1add30b12d442450d5e2b48854fc98b21?d=identicon)[MortalFlesh](/maintainers/MortalFlesh) --- Top Contributors [![MortalFlesh](https://avatars.githubusercontent.com/u/6317184?v=4)](https://github.com/MortalFlesh "MortalFlesh (20 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/lmc-cqrs-http/health.svg) ``` [![Health](https://phpackages.com/badges/lmc-cqrs-http/health.svg)](https://phpackages.com/packages/lmc-cqrs-http) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[telnyx/telnyx-php Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network. 35789.4k2](/packages/telnyx-telnyx-php)[flow-php/flow PHP ETL - Extract Transform Load - Data processing framework 85036.3k](/packages/flow-php-flow)[mollie/mollie-api-php Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque. 60216.0M85](/packages/mollie-mollie-api-php)[cakephp/cakephp The CakePHP framework 8.9k19.5M1.8k](/packages/cakephp-cakephp)[getbrevo/brevo-php Official Brevo provided RESTFul API V3 php library 1003.9M50](/packages/getbrevo-brevo-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)