PHPackages middlewares/method-override - 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. [HTTP & Networking](/categories/http) 4. / 5. middlewares/method-override ActiveLibrary[HTTP & Networking](/categories/http) middlewares/method-override =========================== Middleware to override the request method using the X-Http-Method-Override header v2.1.0(1y ago)519.5k↑80%1MITPHPPHP ^7.2 || ^8.0CI passing Since Oct 1Pushed 1y ago2 watchersCompare [ Source](https://github.com/middlewares/method-override)[ Packagist](https://packagist.org/packages/middlewares/method-override)[ Docs](https://github.com/middlewares/method-override)[ RSS](/packages/middlewares-method-override/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (8)Versions (12)Used By (1) middlewares/method-override =========================== [](#middlewaresmethod-override) [![Latest Version on Packagist](https://camo.githubusercontent.com/4268aecde6f32cd186eca43c2d42965697739926fcba028076696a8869ab4616/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6964646c6577617265732f6d6574686f642d6f766572726964652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/middlewares/method-override)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Testing](https://github.com/middlewares/method-override/workflows/testing/badge.svg)](https://github.com/middlewares/method-override/workflows/testing/badge.svg)[![Total Downloads](https://camo.githubusercontent.com/c850e0ab9d650985700e09d592f2f9265d2530bc8df5273db21a4a4043aea139/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6964646c6577617265732f6d6574686f642d6f766572726964652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/middlewares/method-override) Middleware to override the request method using the `X-Http-Method-Override` header. This is useful for clients unable to send other methods than GET and POST. Requirements ------------ [](#requirements) - PHP >= 7.2 - A [PSR-7 http library](https://github.com/middlewares/awesome-psr15-middlewares#psr-7-implementations) - A [PSR-15 middleware dispatcher](https://github.com/middlewares/awesome-psr15-middlewares#dispatcher) Installation ------------ [](#installation) This package is installable and autoloadable via Composer as [middlewares/method-override](https://packagist.org/packages/middlewares/method-override). ``` composer require middlewares/method-override ``` Example ------- [](#example) ``` Dispatcher::run([ (new Middlewares\MethodOverride()) ->getMethods(['HEAD', 'CONNECT', 'TRACE', 'OPTIONS']) ->postMethods(['PATCH', 'PUT', 'DELETE', 'COPY', 'LOCK', 'UNLOCK']) ->queryParameter('method') ->parsedBodyParameter('method') ]); ``` Usage ----- [](#usage) In the constructor you can provide a `Psr\Http\Message\ResponseFactoryInterface` to create the error response (`405`). If it's not defined, [Middleware\\Utils\\Factory](https://github.com/middlewares/utils#factory) will be used to detect it automatically. ``` $responseFactory = new MyOwnResponseFactory(); $override = new Middlewares\MethodOverride($responseFactory); ``` ### getMethods [](#getmethods) Allows to define the methods that can override the GET method. By default is `['HEAD', 'CONNECT', 'TRACE', 'OPTIONS']`. ``` //The GET method can be overrided only with HEAD and CONNECT $override = (new Middlewares\MethodOverride())->getMethods(['HEAD', 'CONNECT']); ``` ### postMethods [](#postmethods) Array with the methods that can override the POST method. By default is `['PATCH', 'PUT', 'DELETE', 'COPY', 'LOCK', 'UNLOCK']`. ``` //The POST method can be overrided only with DELETE and PUT $override = (new Middlewares\MethodOverride())->getMethods(['DELETE', 'PUT']); ``` ### queryParameter [](#queryparameter) Allows to use a query parameter in addition to the `X-Http-Method-Override` in GET requests. For example `http://example.com/view/23?method=HEAD` ``` //The method can be override with ?new_method=OPTIONS $override = (new Middlewares\MethodOverride())->queryParameter('new_method'); ``` ### parsedBodyParameter [](#parsedbodyparameter) Allows to use a parsed body parameter in addition to the `X-Http-Method-Override` in POST. --- Please see [CHANGELOG](CHANGELOG.md) for more information about recent changes and [CONTRIBUTING](CONTRIBUTING.md) for contributing details. The MIT License (MIT). Please see [LICENSE](LICENSE) for more information. ### Health Score 45 — FairBetter than 93% of packages Maintenance45 Moderate activity, may be stable Popularity31 Limited adoption so far Community13 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 94% 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 ~309 days Recently: every ~653 days Total 11 Last Release 423d ago Major Versions v0.5.0 → v1.0.02018-01-24 v1.1.0 → v2.0.02019-11-30 PHP version history (4 changes)v0.1.0PHP ^5.6 || ^7.0 v0.5.0PHP ^7.0 v2.0.0PHP ^7.2 v2.0.1PHP ^7.2 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/e99df56b617f4af8cf0556a51a0ca20c7420104920c57d7e9eab093f92bb744f?d=identicon)[oscarotero](/maintainers/oscarotero) ![](https://www.gravatar.com/avatar/42e0d72f42eb7d84f67e20d28606da42e5a3248ca908b1eadb4366aafeae2561?d=identicon)[filisko](/maintainers/filisko) --- Top Contributors [![oscarotero](https://avatars.githubusercontent.com/u/377873?v=4)](https://github.com/oscarotero "oscarotero (47 commits)")[![filisko](https://avatars.githubusercontent.com/u/8798694?v=4)](https://github.com/filisko "filisko (3 commits)") --- Tags httphttp-methodmiddlewarepsr-15httppsr-7middlewareserverpsr-15 ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/middlewares-method-override/health.svg) ``` [![Health](https://phpackages.com/badges/middlewares-method-override/health.svg)](https://phpackages.com/packages/middlewares-method-override) ``` ### Alternatives [middlewares/request-handler Middleware to execute request handlers 451.6M26](/packages/middlewares-request-handler)[middlewares/fast-route Middleware to use FastRoute 96191.1k15](/packages/middlewares-fast-route)[middlewares/negotiation Middleware to implement content negotiation 47442.1k11](/packages/middlewares-negotiation)[middlewares/payload Middleware to parse the body of the request with support for json, csv and url-encode 32466.8k17](/packages/middlewares-payload)[middlewares/http-authentication Middleware to implement Basic and Digest Http authentication 35302.0k2](/packages/middlewares-http-authentication)[middlewares/whoops Middleware to use Whoops as error handler 33205.4k24](/packages/middlewares-whoops) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)