TypeApp 是面向原生交付的 PHP 应用框架。用 PHP 编写业务,按需组合组件,通过 TypePHP 全量 AOT 编译生成原生应用。
框架提供通信、数据、任务与资源管理能力。Swoole 作为内置原生运行库提供网络与并发支持,由构建流程管理并随应用交付,无需在部署端单独安装。TypePHP 和 Composer 用于构建,业务请求不依赖它们。
交付一个主程序文件,配置使用环境变量或外置文件,启动不释放运行库。 当前 v1.0.0-rc.19 已固定到 tag 提交 b485f0bbc8d7578749a1dce98d7586897f9e00fe,目标矩阵为 Linux x64、Linux ARM64、macOS ARM64 × sqlite、mysql、pgsql,共 9 个发布 profile;Windows x64 仅保留诊断,不生成本 RC 附件。RC19 已创建为预发布 Release,当前公开 Linux x64 与 Linux ARM64 的 6 个 profile;macOS ARM64 三个附件仍待补齐,使用前须选择已公开的 Linux 程序;安装方法见版本安装,系统基线与业务服务要求见环境与依赖。
文档站:iots.top。新业务从 type-project 创建;主仓附带的物联中心展示框架如何组成业务产品。也可以访问在线 Demo,使用页面公布的演示身份体验物联中心;Demo 是独立部署,版本、数据和账号以站点实际状态为准,不代表 RC19 Release 已公开。正式安装不会预置通用账号或默认口令。
flowchart TB
Source["业务应用 + 按需安装的组件"] --> Build["TypePHP · 全量 AOT 编译"]
Build --> App["原生应用 · 业务、组件、内置运行库"]
Config["外置配置"] --> App
style Build fill:#147d64,color:#ffffff,stroke:#147d64,stroke-width:2px
App --> Env["目标操作系统与所需业务服务"]
| 环节 | TypeApp 提供的能力 |
|---|---|
| 开发应用 | 显式装配、路由与中间件、三库 ORM、通信与后台任务 |
| 构建产物 | 提前生成路由、配置和模型;TypePHP 编译全部生产 PHP 输入,校验实际原生依赖 |
| 运行服务 | 复用内置运行库的网络与协程能力,以作用域、截止和预算控制资源 |
| 发布维护 | 记录产物身份和摘要,分开管理程序、配置与持久数据 |
TypePHP 的编译流程和输入边界见TypePHP 全量编译。当前源码锁定 PHP 8.5.12 ZTS、TypePHP c5599c5c(v0.10.1 对应提交)及 PHPX 2.9.8,直接复用上游的类常量符号、提升属性作用域和持久字符串实现。工具链与生产依赖分别由 toolchain.lock.json 和 composer.lock 固定;语法基线说明保留适配的原因。实际验证范围见平台与验收,已发布版本保留各自的验收身份。
构建组件另附 Linux x64 / ARM64、macOS ARM64、Windows x64 的 Swoole 共享模块,用于开发及共享库回归;生产单程序使用静态 SDK。当前源码固定 6.3 开发快照 81404909,运行时版本字符串为 6.3.0RC1,不是正式 6.3.0。官方稳定线 6.2.5 与当前 6.3 路线分叉;本项目继续沿 6.3 路线更新。模块重建进度见构建输入。基础需求和已有入口见基础能力,未完成项见实现规划。
RC19 的当前候选证据按平台和 profile 单独记录;Linux x64 与 Linux ARM64 的 6 个静态 profile 已通过发布验收并进入预发布附件,macOS ARM64 已完成本地 AOT、三库管理链路和真实 TLS MQTT 验证但尚未生成公开附件,Windows 仅保留诊断。历史 RC14 的四平台、十二程序结果保留在升级验收记录,不能继承为 RC19 的通过结论。
开发机准备 PHP >=8.4 <8.6、Composer、匹配的 Swoole 和所选 PDO 扩展,具体分工见环境与依赖。版本安装示例与当前教程已准备为 RC19,待该版本公开后创建 my-app,选择数据库并安装同批组件,然后在应用根目录执行:
php dev.php help
php dev.php check安装后提交应用的 composer.lock,固定实际依赖版本。连续目录教程从同一 RC19 批次创建第二模块,再演练缓存、事件、Outbox、队列与调度;已有 RC14 应用继续使用原 tag 的说明,升级差异见版本说明。生产构建还须准备目标平台的静态 SDK,按构建与部署执行 composer build。
本地模板与 Git tag 创建方式见快速开始。dev-main 跟进子仓开发分支,不一定与当前 RC 相同;按版本安装才能复现本批次。
独立使用组件时,从组件参考选择公开入口与第一项练习,再按版本与接口依据固定完整依赖。组件 README 提供可独立运行的起点,教程继续说明配置、失败与清理;组合为应用时统一接入执行作用域和业务 Service。
物联中心在同一部署中装配 Platform、System 和 Center 三个工作区,并统一使用 RBAC。Platform 负责客户开通、注册资格、全局资产与 MQTT 运维;Tenant 内的 System 管理人员、角色、会话和系统设置,Center 管理接入应用及逐设备通信权限;设备与客户业务系统交换原始消息,分类资料不决定通信协议。安装、接入与已有数据升级见物联网中心。当前开发源码的最终候选仍在验收,公开版本按各自发布说明使用。
当前 main 补齐了配置与角色预检、生产错误关联、业务就绪探针和维护调度停止。物联中心采用全新空库安装,旧安装拒绝接入且不自动升级;操作顺序与实际平台验收范围见构建与部署和实现规划。
物联中心前端随 TypePHP 构建编入主程序,首次 app:install 安装到 public/,升级可用 web:install --dry-run --force 预览后再执行 web:install --force。普通启动不释放资源,运行端无需 Node.js 或前端开发服务器。推送版本 tag 的三平台构建、同版本组件分发、Packagist 核验与 Release 顺序见版本发布与安装。
plugin/type-*/ Plugins,可独立组合的 Composer 包
templates/type-project/ 独立业务应用起点
app/ 成品案例物联中心(common / platform / system / center)
web/ 物联中心 Vben Admin Pro 5.7.0 管理端(Vue 3.5.45 / Vite 8.3.8 / TypeScript 7.0.2)
config/ 成品案例的应用、数据库配置与路由声明
docs/guide/ 公开使用指南(发布到 iots.top)
docs/development/ 实现规范与验收方法,不进入公开站点
docs/evidence/ 按原产物身份保留的历史验收记录
tests/ 契约、真实依赖与原生验收
HTTP 路由来自控制器 #[Route] 或 config/route.php;#[Transactional]、#[Cacheable] 等声明同样在构建期生成显式代码。运行时不扫描未知目录,也不做 AOP 拦截。
| 读者 | 入口 |
|---|---|
| 开始使用 | 公开指南 · 环境与依赖 · 快速开始 · 连续目录教程 |
| 组合组件 | 15 个组件与练习 · 数据库与模型 · 缓存、事件与可靠任务 |
| 运行与交付 | 系统架构 · 性能与调优 · 构建与部署 |
| 成品案例 | 物联网中心 |
| 许可证 | LICENSE · NOTICE · 许可证说明 |
| 协作约定 | CONTRIBUTING.md · AGENTS.md |
| 术语与决策 | CONTEXT.md · 架构决策 |
内部实现说明在 docs/development/;待完成能力与验收条件见实现规划。
第一方源码、文档、示例、测试、配置、模板与 Web 应用按 Apache License 2.0 发布,版权主体为 Anyon。
swoole/typephp 为 GPL-3.0-only 的独立构建工具,不改变 TypeApp 第一方代码的许可证。Swoole、Vben Admin、Docsify 及其他依赖保留各自许可证,见 NOTICE。
需求与讨论在本仓库进行。提交须包含与作者身份一致的 Signed-off-by,验证步骤见 CONTRIBUTING.md。文档、注释与提交说明使用简体中文。