README

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

https://rcmaker.runchance.com

LICENSE

Apache2.0

项目简介

GitHub：https://github.com/runchance/rcmaker，欢迎点个 Star。

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

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

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

快速入口

目标	文档
第一次使用，快速跑起项目	5 分钟开始
安装运行环境并启动项目	安装与启动
下载独立 PHP CLI	独立 PHP CLI 下载
构建、加密、注册服务和生成签名密钥（推荐）	交互式项目工具
了解项目目录和入口文件	目录结构
编写接口和页面控制器	控制器 / 路由
使用请求、响应、模板能力	请求对象 / 响应对象 / 视图与模板
配置应用独立进程组	应用进程组
传统参数脚本（兼容备选，随时可能删除）	备选脚本说明

在项目根目录运行交互式工具，无需记忆脚本参数：

php index.php interact

interact 是当前推荐且持续维护的操作入口。scripts/*.php 仅用于兼容旧流程或暂未迁移的自动化任务，随时可能删除，新项目不应依赖这些传统脚本。

适合场景

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

核心优势

1. 快速交付与独立运行

延续 PHP 的开发效率和 Composer 生态，无需更换技术栈
可将 PHP 运行环境、项目代码和依赖封装为独立可执行程序
目标服务器无需单独安装和配置 PHP，降低部署与环境维护成本
独立运行时和单文件程序覆盖 Linux、macOS 与 Windows，支持 x86_64，并在 Linux、macOS 支持 AArch64

2. 多应用与进程组隔离

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

3. CLI 常驻内存

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

4. 源码保护

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

5. 静态应用与资源

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

6. 常用能力与 Composer 生态

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

7. PHP 版本兼容

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

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 //启用静态文件预热
	],
];

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

进一步了解

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

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]

autocannon

CLI 模式无业务压测 [swoole]