PHPackages                             mpyw/php-hyper-builtin-server - 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. [DevOps &amp; Deployment](/categories/devops)
4. /
5. mpyw/php-hyper-builtin-server

AbandonedArchivedProject[DevOps &amp; Deployment](/categories/devops)

mpyw/php-hyper-builtin-server
=============================

Reverse proxy for PHP built-in server which supports multiprocessing and TLS/SSL encryption

v3.1.0(5y ago)10593.1k↓11.1%11[4 issues](https://github.com/mpyw/php-hyper-builtin-server/issues)[2 PRs](https://github.com/mpyw/php-hyper-builtin-server/pulls)1MITPHPPHP &gt;=5.4.0

Since Aug 16Pushed 5y ago5 watchersCompare

[ Source](https://github.com/mpyw/php-hyper-builtin-server)[ Packagist](https://packagist.org/packages/mpyw/php-hyper-builtin-server)[ RSS](/packages/mpyw-php-hyper-builtin-server/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (9)Versions (6)Used By (1)

PHP Hyper Built-in Server [![Build Status](https://camo.githubusercontent.com/e9f4f0d17b37022067bae6b1de0bda281d1f3d3e114894c692a2294d6fb1992f/68747470733a2f2f7472617669732d63692e636f6d2f6d7079772f7068702d68797065722d6275696c74696e2d7365727665722e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/mpyw/php-hyper-builtin-server) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/9be3ca41b467d306ad1916bc96bc0437a8a50c6f0fb80b3979364e386170eb9e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d7079772f7068702d68797065722d6275696c74696e2d7365727665722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/mpyw/php-hyper-builtin-server/?branch=master)
=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#php-hyper-built-in-server--)

Reverse proxy for PHP built-in server which supports multiprocessing and TLS/SSL encryption.

Installing
----------

[](#installing)

### Global install

[](#global-install)

```
composer global require mpyw/php-hyper-builtin-server:^3.0
```

If not yet, you must add **`~/.composer/vendor/bin`** to `$PATH`.
Append the following statement to `~/.bashrc`, `~/.zshrc` or what not.

```
export PATH="$HOME/.composer/vendor/bin:$PATH"
```

### Local install only for development environment

[](#local-install-only-for-development-environment)

```
composer require --dev mpyw/php-hyper-builtin-server:^3.0
```

Use **`vendor/bin/hyper-run`** as the execution path.

Usage
-----

[](#usage)

### Quick start

[](#quick-start)

```
hyper-run -S localhost -s localhost -t src/app/www
```

2 servers will start with the directory `src/app/www` as the document root:

- `http://localhost:8000`
- `https://localhost:44300`

Servers start with first unoccupied port within range depending on a scheme.

SchemeDefaultRange`HTTP`80008000-8099`HTTPS`4430044300-44399### Customize ports

[](#customize-ports)

```
hyper-run -S localhost:8080 -s localhost:4000 -t src/app/www
```

2 servers will start with the directory `src/app/www` as the document root:

- `http://localhost:8080`
- `https://localhost:4000`

### Command Reference

[](#command-reference)

```
mpyw@localhost:~$ hyper-run -h

Usage:
    hyper-run

Example:
    hyper-run -S localhost:8000 -s localhost:44300

[Required]
    -S   ":" of an HTTP server. Multiple arguments can be accepted.
    -s   ":" of an HTTPS server. Multiple arguments can be accepted.

[Optional]
    -n   The number of PHP built-in server clusters, from 1 to 20. Default is 10.
    -t   Path for the document root. Default is the current directory.
    -r   Path for the router script. Default is empty.
    -c   Path for the PEM-encoded certificate.
         Default is "/Users/mpyw/.composer/vendor/mpyw/php-hyper-builtin-server/certificate.pem".

Restrictions:
    - The option -s is only supported on PHP 5.6.0 or later.
    - Access logs will not be displayed on Windows.

mpyw@localhost:~$
```

Note for Windows users
----------------------

[](#note-for-windows-users)

Unfortunately, `cmd.exe` has no option to run via shebang `#!/usr/bin/env php`, so you need to create the following batch file in the proper directory.

### For Standalone PHP

[](#for-standalone-php)

```
@echo OFF
"C:\php\php.exe" "%HOMEPATH%\.composer\vendor\mpyw\php-hyper-builtin-server\hyper-run" %*
```

### For XAMPP

[](#for-xampp)

```
@echo OFF
"C:\xampp\php\php.exe" "%HOMEPATH%\.composer\vendor\mpyw\php-hyper-builtin-server\hyper-run" %*
```

License
-------

[](#license)

- `PHP Hyper Built-in Server` is open-sourced software licensed under the [MIT license](LICENSE) by [@mpyw](https://github.com/mpyw).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity44

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 82.1% 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 ~346 days

Total

5

Last Release

2176d ago

Major Versions

v1.x-dev → v2.0.52016-09-02

v2.0.5 → v3.0.02020-06-01

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1351893?v=4)[mpyw](/maintainers/mpyw)[@mpyw](https://github.com/mpyw)

---

Top Contributors

[![mpyw](https://avatars.githubusercontent.com/u/1351893?v=4)](https://github.com/mpyw "mpyw (78 commits)")[![antonkomarev](https://avatars.githubusercontent.com/u/1849174?v=4)](https://github.com/antonkomarev "antonkomarev (16 commits)")[![chitoku-k](https://avatars.githubusercontent.com/u/6535425?v=4)](https://github.com/chitoku-k "chitoku-k (1 commits)")

---

Tags

builtin-servermulti-processmultiprocessingphpssltlsproxyservertlssslmultiprocessingreversemultiprocessBuilt-inbuiltin

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/mpyw-php-hyper-builtin-server/health.svg)

```
[![Health](https://phpackages.com/badges/mpyw-php-hyper-builtin-server/health.svg)](https://phpackages.com/packages/mpyw-php-hyper-builtin-server)
```

###  Alternatives

[spatie/laravel-webhook-server

Send webhooks in Laravel apps

1.1k8.8M22](/packages/spatie-laravel-webhook-server)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[voryx/thruway

Thruway WAMP router core

6771.0M17](/packages/voryx-thruway)[php-mcp/server

PHP SDK for building Model Context Protocol (MCP) servers - Create MCP tools, resources, and prompts

828280.5k25](/packages/php-mcp-server)[clue/socket-raw

Simple and lightweight OOP wrapper for PHP's low-level sockets extension (ext-sockets).

35111.1M48](/packages/clue-socket-raw)[laminas/laminas-server

Create Reflection-based RPC servers

2423.1M23](/packages/laminas-laminas-server)

PHPackages © 2026

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