PHPackages                             fly-php/fly - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. fly-php/fly

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

fly-php/fly
===========

The PHP Supercharger

317PHP

Since Feb 17Pushed 9y ago1 watchersCompare

[ Source](https://github.com/roydejong/FlyPHP)[ Packagist](https://packagist.org/packages/fly-php/fly)[ RSS](/packages/fly-php-fly/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

⚠️ **Important:** This project is still under development and is not ready for any kind of usage. It's a playground, nothing more. Move along, nothing to see here yet.

FlyPHP
======

[](#flyphp)

[![Build Status](https://camo.githubusercontent.com/6144aa5cbd3cdf5ec1946191874f3cdf3757eb9cd2d69d54b2ff702ebbf7dc2d/68747470733a2f2f7472617669732d63692e6f72672f726f7964656a6f6e672f466c795048502e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/roydejong/FlyPHP)

**[flyphp.org](http://www.flyphp.org)**

**An asychronous, non-blocking HTTP server, bootstrapper and process manager written in pure PHP that lets you supercharge your web applications.**

FlyPHP is a drop-in replacement for `php-fpm` and, optionally, your web server. By managing long-running PHP processes it can bootstrap your application or framework to memory for a significant performance boost.

Features
--------

[](#features)

- PHP-based HTTP server (asynchronous, non-blocking IO)
- Process manager and bootstrapper for your application

Requirements
------------

[](#requirements)

- PHP 7 with CLI module
- Composer

Usage
-----

[](#usage)

**Install FlyPHP**

Clone FlyPHP from GitHub to fetch the latest version (while it's still in development):

```
git clone https://github.com/roydejong/FlyPHP.git flyphp
cd flyphp

```

Install the composer dependencies:

```
composer install

```

This command assumes you have installed composer to a system bin folder. If you haven't used composer before, [download and install it](https://getcomposer.org/download/) with the command `php composer-setup.php --install-dir=/usr/bin --filename=composer`.

Note: If you do not wish to install the development components (such as PHPUnit), use `composer install --no-dev`.

**Starting the server**

To start the FlyPHP server on the default port (`8080`):

```
php bin/fly

```

Optionally, you can request a non-default port (e.g. `80` to have FlyPHP act as a drop-in replacement for your web server):

```
php bin/fly start --port 80

```

It may be necessary if, for example, you want to use HTTPS, HTTP v2, to set up a reverse proxy such as nginx.

**Stopping the server**

To stop the server, simply terminate the main process. An interrupt will also (`CTRL+C`) do the trick.

Performance
-----------

[](#performance)

FlyPHP is faster than `php-fpm`. That's the idea, anyway. Benchmarks coming soon.

Troubleshooting
---------------

[](#troubleshooting)

**Long running processes crashing**

Because long running PHP processes have a tendency to crash - PHP was never really designed for it - it is *highly recommended* to use a watchdog to ensure that the `fly` process is restarted should it crash.

**Could not bind to TCP socket - Permission denied / Running as superuser**

You may see this error when trying to start the server. This happens because on Unix systems,the process needs to be run with root access to bind to ports lower than 1024 for security reasons [(some additional details)](https://serverfault.com/questions/112795/how-can-i-run-a-server-on-linux-on-port-80-as-a-normal-user).

The easiest solution is to run the server as the superuser, either under the root account or by using `sudo` - but this may be a potential security risk should a vulnerability be discovered in FlyPHP. Possible workarounds may involve using `authbind` or a reverse proxy server such as nginx.

**Configuration file location / troubleshooting**

The configuration file is called `fly.yaml`. It is located in the root of the FlyPHP installation directory. The installation directory is wherever you cloned the repository to.

You can verify your configuration file and view some basic information about it by using the `bin/fly config:test` command from the installation directory. This command will also alert you to any potential problems found in your settings.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a6873ef39d8543fca22ac4bbc6ceded1454067f2d82d2b51cdd2642d7f14bed?d=identicon)[roydejong](/maintainers/roydejong)

---

Top Contributors

[![roydejong](https://avatars.githubusercontent.com/u/6772638?v=4)](https://github.com/roydejong "roydejong (58 commits)")

### Embed Badge

![Health badge](/badges/fly-php-fly/health.svg)

```
[![Health](https://phpackages.com/badges/fly-php-fly/health.svg)](https://phpackages.com/packages/fly-php-fly)
```

###  Alternatives

[vistik/typed-collections

A simple way to create typed collections in PHP - build on Illuminate\\Support\\Collection

1128.2k5](/packages/vistik-typed-collections)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
