Skip to content
zoujingliPublic

About

TypeApp:面向原生交付的 PHP 应用框架,基于 TypePHP 全量编译,提供组件装配与应用运行能力。

Topics

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

TypeApp

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["目标操作系统与所需业务服务"]
Loading
环节 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。文档、注释与提交说明使用简体中文。

About

TypeApp:面向原生交付的 PHP 应用框架,基于 TypePHP 全量编译,提供组件装配与应用运行能力。

Topics

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages