框架兼容

框架兼容

Laravel、ThinkPHP、Symfony 等主流框架的兼容情况、版本范围与接入说明。

共 10 个框架记录

Laravel
9.x – 12.x
已验证

PSR-4 自动加载、门面与服务容器调用保持一致

PHP 要求 8.0+ 自动加载 PSR-4
ThinkPHP
6.x / 8.x
已验证

多应用模式、容器绑定与中间件链路正常

PHP 要求 7.2+ 自动加载 PSR-4
Symfony
6.x / 7.x
已验证

依赖注入编译与事件分发不受影响

PHP 要求 8.1+ 自动加载 PSR-4
Hyperf
3.x
兼容

常驻进程按 CLI 方式装载，容器只解析一次

PHP 要求 8.0+ 自动加载 PSR-4
Webman
1.x / 2.x
兼容

常驻场景建议在启动阶段完成装载

PHP 要求 7.2+ 自动加载 PSR-4
Workerman
4.x / 5.x
兼容

守护进程模式与普通 CLI 一致

PHP 要求 7.0+ 自动加载 PSR-4
Yii
2.0.x
兼容

别名与自动加载映射保持原样

PHP 要求 7.4+ 自动加载 PSR-4
CodeIgniter
4.x
兼容

命名空间加载与过滤器机制正常

PHP 要求 8.1+ 自动加载 PSR-4
Slim
4.x
兼容

中间件与路由解析正常

PHP 要求 7.4+ 自动加载 PSR-4
CakePHP
5.x
兼容

ORM 与事件系统正常

PHP 要求 8.1+ 自动加载 PSR-4
状态说明：「已验证」表示在 CI 中完成过完整装载与请求链路测试； 「兼容」表示装载与主要调用链路正常，个别扩展或自定义编译器可能需要额外确认。
接入建议

三类项目，三种注意点

框架本身不需要改造，但部署细节决定接入是否顺利。

常规 FPM 项目

与普通 PHP 站点一致：装扩展、放容器、清 OPcache。建议先在一台预发布节点验证完整请求链路。

常驻内存框架

在进程启动阶段完成装载，容器只解析一次；修改代码后需重启进程，避免旧容器留在内存中。

第三方依赖

vendor 目录建议保持明文，便于升级与审计；只对自有业务代码生成容器，减少版本联调成本。

兼容性自查

三步确认你的项目能跑

  • 版本 — php -v 确认主版本与线程模型，选择对应 loader。
  • 装载 — php -m 确认扩展已启用，php --ri 确认版本。
  • 链路 — 跑一遍登录、下单等核心请求，检查日志是否有 LOAK 记录。
查看接入文档 反馈兼容问题
shell · 快速自查 
# 1. 运行环境
$ php -v | head -1
$ php -r 'echo PHP_SAPI, PHP_EOL;'
fpm-fcgi

# 2. 扩展状态
$ php -m | grep loakphp_loader
loakphp_loader

# 3. 容器与授权
$ php --ri loakphp_loader | head -5

先下载扩展，再决定怎么接

按 PHP 版本获取 loader 并核对 SHA-256；域名绑定、授权状态与容器签发都在授权服务里完成。

下载 loader 授权服务