PHPackages                             runchance/rcmaker - 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. [Framework](/categories/framework)
4. /
5. runchance/rcmaker

ActiveProject[Framework](/categories/framework)

runchance/rcmaker
=================

rcmaker is oneness of fpm and cli high performance php framework, support workerman and swoole run mode

v3.1.3(3w ago)51682Apache-2.0PHPPHP &gt;=8.1

Since Dec 9Pushed 3w ago1 watchersCompare

[ Source](https://github.com/runchance/rcmaker)[ Packagist](https://packagist.org/packages/runchance/rcmaker)[ Docs](http://rcmaker.runchance.com)[ RSS](/packages/runchance-rcmaker/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (5)Versions (26)Used By (0)

rcmaker
=======

[](#rcmaker)

**用 PHP 快速开发，像 Go 应用一样交付。**

LICENSE
-------

[](#license)

Apache2.0

项目简介
----

[](#项目简介)

GitHub：，欢迎点个 Star。

rcmaker 是一个面向快速交付的 PHP 常驻内存应用框架。它保留了 PHP 与 Composer 生态成熟、开发高效的优势，同时提供多应用架构与应用级进程隔离能力：不同应用可以绑定不同的 APP 进程组，独立配置监听端口、进程数量、重启策略和资源配额。

在交付阶段，rcmaker 可以将 PHP 运行环境、项目代码及依赖封装为支持代码保护的独立可执行程序。目标服务器无需单独搭建 PHP 环境，即可像部署 Go 应用一样直接运行，适合需要快速开发、便捷部署和源码保护的项目。

核心能力为项目带来的价值PHP 与 Composer 生态延续成熟的开发方式和组件生态，降低学习与迁移成本CLI 常驻内存减少框架重复初始化开销，适合高并发接口和长期运行服务多应用与 APP 进程组按业务拆分端口、进程和资源，支持独立启停与重启独立可执行程序将运行环境、代码和依赖一起交付，简化服务器部署代码保护支持源码加密以及明文、加密代码混合部署快速入口
----

[](#快速入口)

目标文档安装运行环境并启动项目[安装与启动](doc/md/install.md)了解项目目录和入口文件[目录结构](doc/md/directory.md)编写接口和页面控制器[控制器](doc/md/controller.md) / [路由](doc/md/route.md)使用请求、响应、模板能力[请求对象](doc/md/request.md) / [响应对象](doc/md/response.md) / [视图与模板](doc/md/view.md)配置应用独立进程组[应用进程组](doc/md/app-process.md)打包、加密和注册服务[二进制打包](doc/md/scripts/buildBin.md) / [PHP 加密与打包](doc/md/scripts/encryptPhp.md) / [Linux 服务注册](doc/md/scripts/systemd.md)适合场景
----

[](#适合场景)

- 需要快速交付的业务系统
- 需要打包为独立程序并简化服务器环境部署的项目
- 需要源码加密、混合分发和商业化交付的项目
- 需要多个应用按进程组隔离运行、独立管理资源的项目
- 需要按应用、按域名、按目录绑定静态入口的项目
- 需要自定义进程、RPC、定时任务和长驻服务的项目
- 需要把常见基础能力直接收进框架，而不是每个项目重复封装

核心优势
----

[](#核心优势)

### 1. 快速交付与独立运行

[](#1-快速交付与独立运行)

- 延续 PHP 的开发效率和 Composer 生态，无需更换技术栈
- 可将 PHP 运行环境、项目代码和依赖封装为独立可执行程序
- 目标服务器无需单独安装和配置 PHP，降低部署与环境维护成本
- 支持 x86\_64 与 AArch64 环境，便于在服务器和 ARM 设备上交付

### 2. 多应用与进程组隔离

[](#2-多应用与进程组隔离)

- 一个项目可以承载多个动态应用或静态应用
- 不指定 `bind_process` 时，应用由主 APP 进程组处理
- 指定 `bind_process` 后，应用可以绑定到独立 APP 进程组
- 每个进程组可以独立配置端口、进程数、重启策略和资源配额
- 多个应用也可以共享同一个进程组，兼顾隔离能力与资源利用率

### 3. CLI 常驻内存

[](#3-cli-常驻内存)

- 业务代码和框架能力常驻进程，减少每次请求的重复初始化开销
- 支持高频接口、自定义进程、RPC、定时任务和队列消费
- 同一套业务代码也可以运行在传统 PHP-FPM 环境中

### 4. 源码保护

[](#4-源码保护)

- 支持项目源码加密与运行时解密/加载，便于交付和源码保护
- 加密和解密需要配合 rcmaker 提供的 PHP 独立执行程序使用，其中内置了 rcmaker 加密解密扩展
- 可配合打包流程生成可分发的运行包
- 支持明文代码和加密代码混合部署，兼顾灵活性和保护强度

### 5. 静态应用与资源

[](#5-静态应用与资源)

- 支持按应用、域名、静态目录绑定独立站点
- 支持多级应用结构，例如 `api/v2` 这类目录层级
- 支持 `document_root`、`index_default` 等独立静态配置
- 适合官网、活动页、后台静态资源、前后端分离静态站点
- 支持静态文件直出
- 支持 gzip 响应
- 支持启动时预热和缓存
- 支持按类型控制预热，避免无意义扫描和压缩
- 支持静态首页回退和多应用目录隔离

### 6. 常用能力与 Composer 生态

[](#6-常用能力与-composer-生态)

- `Validator`：参数和业务校验
- `AutoForm`：常见表单增删改查
- `Token` / `Captcha` / `Sms` / `Mailer`：认证、验证码和消息能力
- `Db` / `Redis`：数据访问和缓存封装
- `Qrcode` / `Xlsx` / `Pdf` / `Pinyin` / `Stopwatch` / `Curl`：常见业务工具
- 继续支持通过 Composer 引入成熟第三方组件，不封闭 PHP 生态
- 框架内置高频能力，减少项目重复封装和依赖组合成本

### 7. PHP 版本兼容

[](#7-php-版本兼容)

- 持续兼容 PHP 8.1 - 8.5
- 重点处理 nullable、签名、返回类型和动态属性等升级问题
- 让老项目升级时更少踩弃用告警

### 8. 安全与性能

[](#8-安全与性能)

- 路径、文件和静态资源处理都尽量做白名单和 `realpath` 校验
- 避免在请求热路径做多余 IO 和重型反射
- 优先做低开销优化，避免为了“封装感”牺牲性能

一个静态绑定示例
--------

[](#一个静态绑定示例)

```
return [
	'app' => [
		'domains' => ['file.test.com'],
		'document_root' => 'file', //绑定静态目录(./public/file)
		'index_default' => 'index.html', //绑定静态首页(./public/file/index.html)
		'static_preload_extensions' => ['css', 'js', 'html'],//预热静态文件类型
		'enable_static_file' => true,//启用静态文件直出
		'enable_static_gzip' => true,//启用静态文件 gzip 压缩
		'enable_static_preload' => true //启用静态文件预热
	],
];
```

这种方式适合把不同应用、不同域名和不同静态入口拆开管理，静态目录和默认首页都可以独立配置。

进一步了解
-----

[](#进一步了解)

- 详细手册见：
- 如果你更关注具体能力的使用方式，可以继续查看仓库内的文档和示例代码

rcmaker能做什么
-----------

[](#rcmaker能做什么)

**1、作为独立的高性能 web 容器**

> 只要操作系统中装有 PHP 即可，不依赖 nginx、apache 等容器即可原生支持 HTTP|HTTPS 协议对外提供 web 服务。 使用 nginx、apache 等容器反向代理可以获得第三方容器的高兼容性、丰富的组件。 CLI 模式支持常驻进程、自定义进程、RPC 和任务调度。

**2、作为 web 容器下的 PHP 独立框架**

> 使用 nginx、apache 作为 web 容器为项目提供基础框架支持。

**3、自定义进程**

> 定时任务。

> RPC 服务。

> web 服务。

> websocket 服务。

> 物联网、游戏、TCP 服务、UDP 服务、unix socket 服务。

> 其他定制协议服务。

压测
--

[](#压测)

展开压测截图虚拟机 VM 8 核 16G 操作系统 Ubuntu 20.04.3 LTS

**CLI 模式无业务压测****\[workerman\]**

[![](https://camo.githubusercontent.com/9bf76aeb73f360b71b8c11f9eab145c09e2a59835acefd8aac8e5827555e3988/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f776f726b65726d616e2e706e67)](https://camo.githubusercontent.com/9bf76aeb73f360b71b8c11f9eab145c09e2a59835acefd8aac8e5827555e3988/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f776f726b65726d616e2e706e67)

ab

[![](https://camo.githubusercontent.com/f11225c1912946bd85f62e38627fb7808317d5feac12532d9915ee0ac6fe08a4/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f61625f636c695f776f726b65726d616e2e706e67)](https://camo.githubusercontent.com/f11225c1912946bd85f62e38627fb7808317d5feac12532d9915ee0ac6fe08a4/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f61625f636c695f776f726b65726d616e2e706e67)

autocannon

[![](https://camo.githubusercontent.com/eb3fb3d821147295d4adeeb0b2fac17c17ec0662090df5be218089a9d037384e/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f636c695f776f726b65726d616e2e706e67)](https://camo.githubusercontent.com/eb3fb3d821147295d4adeeb0b2fac17c17ec0662090df5be218089a9d037384e/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f636c695f776f726b65726d616e2e706e67)

**CLI 模式无业务压测****\[swoole\]**

[![](https://camo.githubusercontent.com/07fb846b221ae1a7e346423eed584cec88e980054ba3e9bea333e8ecfd46c08c/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f73776f6f6c652e706e67)](https://camo.githubusercontent.com/07fb846b221ae1a7e346423eed584cec88e980054ba3e9bea333e8ecfd46c08c/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f73776f6f6c652e706e67)

ab

[![](https://camo.githubusercontent.com/1e621f25e421e9e7ed668fb75a34e953b5d1412597490783223e418b40b5254f/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f61625f636c695f73776f6f6c652e706e67)](https://camo.githubusercontent.com/1e621f25e421e9e7ed668fb75a34e953b5d1412597490783223e418b40b5254f/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f61625f636c695f73776f6f6c652e706e67)

autocannon

[![](https://camo.githubusercontent.com/14a9c2143b02599f5409d5bfe2c5da7fa159d05ad9a75c60f604c4349112097c/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f636c695f73776f6f6c652e706e67)](https://camo.githubusercontent.com/14a9c2143b02599f5409d5bfe2c5da7fa159d05ad9a75c60f604c4349112097c/687474703a2f2f72636d616b65722e72756e6368616e63652e636f6d2f62656e63686d61726b732f636c695f73776f6f6c652e706e67)

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance94

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity69

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~70 days

Recently: every ~1 days

Total

25

Last Release

27d ago

Major Versions

v1.1 → v2.02022-10-11

v2.5.4 → v3.02026-07-08

PHP version history (3 changes)v1.0PHP &gt;=7.2

v1.1PHP &gt;=7.3

v3.0PHP &gt;=8.1

### Community

Maintainers

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

---

Top Contributors

[![runchance](https://avatars.githubusercontent.com/u/93974235?v=4)](https://github.com/runchance "runchance (26 commits)")

---

Tags

high-performancephp http frameworkoneness of fpm and cli modestandalone http servicestandalone php process manager

### Embed Badge

![Health badge](/badges/runchance-rcmaker/health.svg)

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

###  Alternatives

[workerman/webman-framework

High performance HTTP Service Framework.

145372.0k298](/packages/workerman-webman-framework)

PHPackages © 2026

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