MIT 许可

安全的文件管理面向 PHP 与 Symfony

MIT 许可，支持本机与 S3 兼容存储、细致权限控制、可靠上传及图片工具。

几秒内完成安装

Composer

composer require sohophp/sofinder-symfony:^1.1

持续开发 · MIT 许可 · PHP 8.2+

以安全为设计核心

路径沙箱、私有隔离区、CSRF 保护、继承式 ACL 与操作门禁。

了解安全设计

完整文件浏览器

响应式文件浏览器，支持目录、预览、搜索、拖放、批量操作与回收站。

内容编辑快速入门

弹性存储

支持本机存储及 AWS S3、Cloudflare R2、MinIO 等 S3 兼容存储。

比较存储方案

适合框架集成

Symfony Bundle、公开 PHP 契约、事件、Tagged Service 与可扩展 API。

集成 SoFinder

面向真实应用

图片处理、可靠上传、Picker 模式、稳定资产 ID 与私有交付。

探索产品能力

适合正式环境

配额、分页、限流、维护命令与部署时安全审计。

生产环境运维

30 秒快速开始

从安装到第一个文件浏览器

三个步骤建立受 Symfony 授权保护的本机文件资源。

安装

Bash

composer require sohophp/sofinder-symfony:^1.1

配置存储

YAMLconfig/packages/so_finder.yaml

so_finder:
  resources:
    Files:
      adapter: local
      root: '%kernel.project_dir%/var/files'
      delivery_mode: proxy
      roles: [ROLE_USER]

打开 SoFinder

登录后访问/sofinder/browser

阅读完整安装指南

供应商无关

在同一套 API 后选择存储

先使用本机存储，需要时再安装独立 S3 Adapter。核心不绑定任何云服务商。

比较存储选项

Local Storage

AWS S3

Cloudflare R2

MinIO

Other S3-compatible providers

编辑器集成

选择器与编辑器保持解耦

SoEditor、CKEditor、TinyMCE 或自定义编辑器只依赖公开 JS API；后端授权与存储选择保持一致。

SoEditorCKEditor 4CKEditor 5TinyMCECustom editorCustom picker

1编辑器

2SoFinder JS API

3SoFinder 后端

4存储

查看编辑器集成

MIT 许可PHP 8.2+Symfony 6.4+S3 兼容开放源代码

安装

bash

composer require sohophp/sofinder-symfony:^1.1

现有应用可以继续使用兼容 Meta Package sohophp/sofinder:^1.1；两个包名都公开相同的 namespace。接着注册 Bundle、导入路由并建立至少一个存储资源。请从安装与快速开始开始，完整选项可参考配置参考。

正式支持的框架版本线

Symfony 6.4／7.4、Laravel 12／13 与共享 PSR-15 Host 均是正式支持的 Full-stack 集成。Laravel、Slim、Mezzio 和纯 PHP 的可执行接入步骤见框架集成指南，具体 PHP 8 组合见框架支持策略。PHP 8 主线绝不为 PHP 7.2 降级；Legacy 可行性始终独立评估。

在 CMS 中使用 SoFinder？请先阅读 CMS 内容编辑者指南。需要了解全部文件操作时，继续阅读完整文件管理器指南和图片管理。开发集成请查看开发者指南及 HTTP API 参考。