框架支持

当前发布线支持 PHP 8.1～8.5。Symfony 6.4 LTS 在 PHP 8.1～8.5 上提供完整浏览器界面、HTTP API、命令、安全和依赖注入支持；Symfony 7.4 LTS 支持 PHP 8.2～8.5。

宿主	当前级别	发布门槛
Symfony 6.4／7.4	完整、稳定	Symfony 6.4 × PHP 8.1～8.5；Symfony 7.4 × PHP 8.2～8.5
纯 PHP／任意容器	完整浏览器/API Runtime	宿主显式提供授权、CSRF、Actor、事件与 PSR Factory
Laravel 12/13	全栈支持：浏览器、51 个共享 Handler、Artisan/Queue、Auth/Gate 与 Session CSRF	完整兼容矩阵与黑盒一致性矩阵
Slim／Mezzio	通过 PSR-15 提供全栈支持及全部 52 个共享 Handler	完整兼容矩阵与黑盒一致性矩阵
其他框架	仅 headless 核心	实现公开契约，不继承内部 Controller

安装、授权及 Bootstrap 示例请阅读框架集成指南，其中包含 Laravel 12／13、Slim 4、Mezzio 3 和纯 PHP；Symfony 请阅读单独的集成指南。

正式支持的 PSR-15 包提供 Middleware、RouteRegistrar 和完整 52 路由浏览器/API 的本地 Runtime Factory。真实 Slim 4、Mezzio 3 与纯 PHP Front Controller 已在 PHP 8.1 和 8.5 上提供共享 /browser 外壳及前端资源，并执行全部 51 条非展示路由以及 Liveness、Capabilities、 Health、拒绝和写操作路径；Chromium 会在三个真实宿主启动 React UI 且不得产生运行时错误，共享 API 清单会把状态／错误契约和安全响应头与 Symfony 比较；每次同步发布前都会执行完整黑盒 Suite。

受门禁保护的 Laravel 包已在真实 Laravel 12/13 应用中通过自动发现启动，注册中央 51 个非浏览器路由，并把全部路由通过 PSR Dispatcher 接到共享 HTTP Action。Laravel Auth/Gate、 Session CSRF、Event Dispatcher、请求上下文、路由 URL 和统一配置 Adapter 已完成；浏览器分块会话、维护锁、指标、恶意软件状态与预览任务默认使用 Laravel Cache 和原子锁，不能提供安全锁的 Cache Driver 会在启动时失败。浏览器外壳、四个 Artisan 维护命令、基于框架无关审计器的 Artisan 安全审计命令、维护与异步文档预览的 Laravel Queue Dispatcher 和同步发布资源也已接入。Laravel 宿主启用恶意软件扫描后，上传和安全审计会接入共享的 Fail-closed ClamAV 扫描器。可运行的 Laravel 12/13 应用现已覆盖全部支持组合（Laravel 12 × PHP 8.2～8.5；Laravel 13 × PHP 8.3～8.5），并验证自动发现、配置与路由缓存、浏览器启动、CSRF、上传、下载、Range 及前端资源；Chromium 还会加载真实 Laravel 12／13 浏览器外壳，验证共享 API Bootstrap 且不产生运行时错误。真实宿主套件也会执行全部 51 条非展示路由，并与 Symfony 比较状态／错误及安全响应头契约；同时在五个宿主运行真实 multipart 上传、完整/Range 内容、ETag 重新验证、Range 下载、重命名、复制、移动、回收站恢复和永久删除生命周期。该套件还验证 Symfony 原生未认证 401 Challenge，并比较 Laravel、Slim、Mezzio 与纯 PHP 在未认证及“已认证但未授权”两种状态下共享的 403 access_denied 响应体与安全响应头契约。

门禁证据记录在 config/framework-support.json 并由 CI 校验。默认政策要求主线版本不低于 1.0.0、稳定满 30 天且 P0/P1 缺陷为零。本次在完整兼容、安全、拆分发布和干净消费者矩阵通过后，由维护者明确批准立即晋级豁免；政策如实记录批准日期、批准者和原因，不会伪称 30 天观察已经完成。稳定补丁版本满足版本下限；当前记录的稳定版本为 1.0.2，依据仍锚定不可变的 1.0.0 Release。同时必须记录最终 Symfony 矩阵的 Commit 与 Workflow URL、观察起止日期，以及安全的 P0/P1 缺陷审计链接。 1.0.0 发布后，每日 Symfony 1.0 observation Workflow 会记录观察期内建立且带有精确 priority:p0 或 priority:p1 Label 的所有 Issue。已关闭缺陷仍保留在证据中，不能通过关闭 Issue 伪造连续无缺陷的观察期。

php

$registrar = new RouteRegistrar($endpointDispatcher, '/sofinder');
$registrar->registerSlim($slimApp);
// 或：$registrar->registerMezzio($mezzioApp);

Dispatcher 必须注入已启用功能所需的共享 Handler。缺少 Handler 会返回 501 endpoint_not_implemented；缺少授权或 CSRF Provider 则必须令应用启动失败。无框架宿主选择异步文档预览时必须提供 DocumentPreviewDispatcherInterface；Dispatcher 缺失或不可用时，Messenger 模式必须启动失败。

不限框架的核心入口

Storage\ResourceRegistryFactory 不依赖框架请求或容器，并允许桥接层处理挂载路径：

php

use SohoPHP\SoFinder\FileManager;
use SohoPHP\SoFinder\Storage\ResourceRegistryFactory;

$registry = (new ResourceRegistryFactory(
    publicUrlResolver: static fn (string $url): string => '/admin' . $url,
))->create([
    'Files' => [
        'root' => __DIR__ . '/storage/files',
        'public_url' => '/files',
        'allowed_extensions' => ['jpg', 'png', 'pdf'],
    ],
]);

$files = new FileManager($registry, $authorization, $eventDispatcher);

$authorization 实现 AuthorizationInterface，$eventDispatcher 实现 PSR-14 EventDispatcherInterface。宿主路由仍必须完成认证、写操作 CSRF、异常到 HTTP JSON 的映射以及受 ACL 保护的文件流输出。Symfony 桥接也委托给同一个构建器，只额外处理 Request base path；后续桥接必须沿用这一模式，避免安全配置产生差异。

实施顺序

保持 Symfony 6.4 在 PHP 8.1～8.5、Symfony 7.4 在 PHP 8.2～8.5 及可运行示例中全部稳定。
固化与框架无关的请求、响应、上传、Actor 和 Workspace 边界，把完整栈代码移到桥接包。
首先增加 Laravel 完整桥接、可执行示例和共用 HTTP 契约测试。
只有可执行 Slim／Mezzio 示例持续通过同一契约套件时，才维持共用 PSR-7／PSR-15 Bridge 的正式支持。
其他框架只有通过相同 HTTP、安全和存储契约测试后才列为完整支持。

PHP 7.2 必须使用独立产品线

PHP 7.2 已停止维护，不能加入 main 或 1.x 的 Composer 约束。当前代码使用 PHP 8.1／8.2 语法，现行 Symfony、PHPUnit 和 PSR 依赖也无法直接形成安全的 PHP 7.2 矩阵。

兼容边界不可改变：PHP 8.1～8.5 主线绝不会为了实现 PHP 7.2 而降低语法、依赖、架构或测试标准。PHP 7.2 Runtime 是否具备开发可行性、是否值得继续，是只能在 Legacy 仓库内另行作出的产品决策。任何 Legacy 可行性结论都不能要求削弱或限制 PHP 8 主线。

独立的 sohophp/sofinder-legacy 仓库现已建立 7.2.x 兼容基线，并拥有独立 lock file、PHP 7.2.5／7.3／7.4 CI 和安全政策。Runtime 移植目前暂停，尚无 7.2.0 Release 或 Packagist 包；它不会与 sohophp/sofinder 1.x 共用 tag 或依赖解析。只有证明依赖组合及安全更新路径可维护后才会发布。所有 PHP 8 包都声明与 sohophp/sofinder-legacy 冲突，因此 Composer 会拒绝混装。

框架支持 ​

不限框架的核心入口 ​

实施顺序 ​

PHP 7.2 必须使用独立产品线 ​

框架支持

不限框架的核心入口

实施顺序

PHP 7.2 必须使用独立产品线