PHPackages amphp/aerys - 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. amphp/aerys Abandoned → [amphp/http-server](/?search=amphp%2Fhttp-server)Library[HTTP & Networking](/categories/http) amphp/aerys =========== A non-blocking HTTP/Websocket server v0.7.4(8y ago)3630.1k8[1 PRs](https://github.com/amphp/aerys/pulls)5MITPHPPHP >=7CI failing Since Nov 26Pushed 5y ago9 watchersCompare [ Source](https://github.com/amphp/aerys)[ Packagist](https://packagist.org/packages/amphp/aerys)[ Docs](https://github.com/amphp/aerys)[ RSS](/packages/amphp-aerys/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (13)Versions (21)Used By (5) aerys ===== [](#aerys) [![Build Status](https://camo.githubusercontent.com/7a070b74afbb9cc2a7ffb34232c838b50efbda5aea61596bd2514f50fbe4b5c6/68747470733a2f2f7472617669732d63692e6f72672f616d7068702f61657279732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/amphp/aerys)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/amphp/aerys/blob/master/LICENSE) Aerys is a non-blocking HTTP/1.1 and HTTP/2 application, WebSocket and static file server written in PHP based on [Amp](https://github.com/amphp/amp). Deprecation ----------- [](#deprecation) This repository is deprecated in favor of [`amphp/http-server`](https://github.com/amphp/http-server). It still exists to keep the documentation and also Packagist working as before. Installation ------------ [](#installation) ``` composer require amphp/aerys ``` Documentation ------------- [](#documentation) - [Official Documentation](http://amphp.org/aerys/) - [Getting Started with Aerys](http://blog.kelunik.com/2015/10/21/getting-started-with-aerys.html) - [Getting Started with Aerys WebSockets](http://blog.kelunik.com/2015/10/20/getting-started-with-aerys-websockets.html) Running a Server ---------------- [](#running-a-server) ``` php bin/aerys -c demo.php ``` Simply execute the `aerys` binary (with PHP 7) to start a server listening on `http://localhost/` using the default configuration file (packaged with the repository). Add a `-d` switch to see some debug output like the routes called etc.: ``` php bin/aerys -d -c demo.php ``` Config File ----------- [](#config-file) Use the `-c, --config` switches to define the config file: ``` php bin/aerys -c /path/to/my/config.php ``` Use the `-h, --help` switches for more instructions. Static File Serving ------------------- [](#static-file-serving) To start a static file server simply pass a root handler as part of your config file. ``` return (new Aerys\Host) ->expose("*", 1337) ->use(Aerys\root(__DIR__ . "/public")); ``` Security -------- [](#security) If you discover any security related issues, please email `bobwei9@hotmail.com` or `me@kelunik.com` instead of using the issue tracker. License ------- [](#license) The MIT License (MIT). Please see [LICENSE](./LICENSE) for more information. ### Health Score 40 — FairBetter than 88% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity37 Limited adoption so far Community34 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 52.9% 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 ~39 days Recently: every ~16 days Total 20 Last Release 3072d ago PHP version history (3 changes)v0.1.0PHP >=7.0.0-dev v0.4.0PHP >=7.0.0 v0.6.2PHP >=7 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1628287?v=4)[Aaron Piotrowski](/maintainers/Trowski)[@trowski](https://github.com/trowski) ![](https://www.gravatar.com/avatar/12852217f3369e8144bc9ce6ac2a2341c28c5512c5b3df5749bfbbd45b6877ff?d=identicon)[kelunik](/maintainers/kelunik) ![](https://www.gravatar.com/avatar/f6db63ad594446f67d79532b75c69439fd0df779cc90868b43c187c02a4221ef?d=identicon)[bwoebi](/maintainers/bwoebi) --- Top Contributors [![rdlowrey](https://avatars.githubusercontent.com/u/1259291?v=4)](https://github.com/rdlowrey "rdlowrey (711 commits)")[![bwoebi](https://avatars.githubusercontent.com/u/3154871?v=4)](https://github.com/bwoebi "bwoebi (365 commits)")[![trowski](https://avatars.githubusercontent.com/u/1628287?v=4)](https://github.com/trowski "trowski (115 commits)")[![kelunik](https://avatars.githubusercontent.com/u/2743004?v=4)](https://github.com/kelunik "kelunik (108 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (13 commits)")[![brstgt](https://avatars.githubusercontent.com/u/331879?v=4)](https://github.com/brstgt "brstgt (8 commits)")[![morrisonlevi](https://avatars.githubusercontent.com/u/253316?v=4)](https://github.com/morrisonlevi "morrisonlevi (6 commits)")[![maxmeijer42](https://avatars.githubusercontent.com/u/10037153?v=4)](https://github.com/maxmeijer42 "maxmeijer42 (2 commits)")[![nikic](https://avatars.githubusercontent.com/u/216080?v=4)](https://github.com/nikic "nikic (2 commits)")[![tpunt](https://avatars.githubusercontent.com/u/1403064?v=4)](https://github.com/tpunt "tpunt (2 commits)")[![shouze](https://avatars.githubusercontent.com/u/54712?v=4)](https://github.com/shouze "shouze (2 commits)")[![rlmumford](https://avatars.githubusercontent.com/u/879407?v=4)](https://github.com/rlmumford "rlmumford (1 commits)")[![samizdam](https://avatars.githubusercontent.com/u/1556299?v=4)](https://github.com/samizdam "samizdam (1 commits)")[![dbalabka](https://avatars.githubusercontent.com/u/1269372?v=4)](https://github.com/dbalabka "dbalabka (1 commits)")[![stefanotorresi](https://avatars.githubusercontent.com/u/2952427?v=4)](https://github.com/stefanotorresi "stefanotorresi (1 commits)")[![strayobject](https://avatars.githubusercontent.com/u/2257473?v=4)](https://github.com/strayobject "strayobject (1 commits)")[![joshdifabio](https://avatars.githubusercontent.com/u/5609851?v=4)](https://github.com/joshdifabio "joshdifabio (1 commits)")[![ck99](https://avatars.githubusercontent.com/u/136840?v=4)](https://github.com/ck99 "ck99 (1 commits)")[![Ocramius](https://avatars.githubusercontent.com/u/154256?v=4)](https://github.com/Ocramius "Ocramius (1 commits)")[![PeeHaa](https://avatars.githubusercontent.com/u/1330296?v=4)](https://github.com/PeeHaa "PeeHaa (1 commits)") --- Tags aerysamphpasynchttpphpserverhttpasyncnon-blockingserverwebsocketampamphpaerys ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/amphp-aerys/health.svg) ``` [![Health](https://phpackages.com/badges/amphp-aerys/health.svg)](https://phpackages.com/packages/amphp-aerys) ``` ### Alternatives [amphp/http-server A non-blocking HTTP application server for PHP based on Amp. 1.3k4.5M81](/packages/amphp-http-server)[amphp/websocket-client Async WebSocket client for PHP based on Amp. 1623.0M39](/packages/amphp-websocket-client)[amphp/websocket Shared code for websocket servers and clients. 463.1M9](/packages/amphp-websocket)[amphp/http-client An advanced async HTTP client library for PHP, enabling efficient, non-blocking, and concurrent requests and responses. 7296.8M137](/packages/amphp-http-client)[hhxsv5/laravel-s 🚀 LaravelS is an out-of-the-box adapter between Laravel/Lumen and Swoole. 3.9k676.0k10](/packages/hhxsv5-laravel-s)[amphp/redis Efficient asynchronous communication with Redis servers, enabling scalable and responsive data storage and retrieval. 165634.7k44](/packages/amphp-redis) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)