{"id":23782547,"url":"https://github.com/roydejong/flyphp","last_synced_at":"2026-04-12T08:30:18.139Z","repository":{"id":62505917,"uuid":"54325904","full_name":"roydejong/FlyPHP","owner":"roydejong","description":":rocket: Make PHP Fly. A process manager, web server and bootstrapper built for performance.","archived":false,"fork":false,"pushed_at":"2017-02-17T17:23:06.000Z","size":83,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-01T12:17:29.668Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://flyphp.org","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roydejong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-20T15:45:38.000Z","updated_at":"2018-01-02T17:07:48.000Z","dependencies_parsed_at":"2022-11-02T10:16:00.596Z","dependency_job_id":null,"html_url":"https://github.com/roydejong/FlyPHP","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roydejong%2FFlyPHP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roydejong%2FFlyPHP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roydejong%2FFlyPHP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roydejong%2FFlyPHP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roydejong","download_url":"https://codeload.github.com/roydejong/FlyPHP/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239993877,"owners_count":19730778,"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":[],"created_at":"2025-01-01T12:16:06.754Z","updated_at":"2026-04-12T08:30:18.071Z","avatar_url":"https://github.com/roydejong.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":":warning: **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.\n\nFlyPHP\n======\n\n[![Build Status](https://travis-ci.org/roydejong/FlyPHP.svg?branch=master)](https://travis-ci.org/roydejong/FlyPHP)\n\n**[flyphp.org](http://www.flyphp.org)**\n\n**An asychronous, non-blocking HTTP server, bootstrapper and process manager written in pure PHP that lets you supercharge your web applications.**\n\nFlyPHP 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.\n\nFeatures\n--------\n\n- PHP-based HTTP server (asynchronous, non-blocking IO)\n- Process manager and bootstrapper for your application\n\nRequirements\n------------\n\n- PHP 7 with CLI module\n- Composer\n\nUsage\n-----\n\n**Install FlyPHP**\n\nClone FlyPHP from GitHub to fetch the latest version (while it's still in development):\n\n    git clone https://github.com/roydejong/FlyPHP.git flyphp\n    cd flyphp\n\nInstall the composer dependencies:\n\n    composer install\n\nThis 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`.\n\nNote: If you do not wish to install the development components (such as PHPUnit), use `composer install --no-dev`.\n\n**Starting the server**\n\nTo start the FlyPHP server on the default port (`8080`):\n\n    php bin/fly\n\nOptionally, you can request a non-default port (e.g. `80` to have FlyPHP act as a drop-in replacement for your web server):\n\n    php bin/fly start --port 80\n\nIt may be necessary if, for example, you want to use HTTPS, HTTP v2, to set up a reverse proxy such as nginx.\n\n**Stopping the server**\n\nTo stop the server, simply terminate the main process. An interrupt will also (`CTRL+C`) do the trick.\n\nPerformance\n-----------\nFlyPHP is faster than `php-fpm`. That's the idea, anyway. Benchmarks coming soon.\n\nTroubleshooting\n---------------\n\n**Long running processes crashing**\n\nBecause 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.\n\n**Could not bind to TCP socket - Permission denied / Running as superuser**\n\nYou 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).\n\nThe 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.\n\n**Configuration file location / troubleshooting**\n\nThe 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.\n\nYou 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.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froydejong%2Fflyphp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froydejong%2Fflyphp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froydejong%2Fflyphp/lists"}