MIT 许可

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

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

几秒内完成安装

Composer

composer require sohophp/sofinder:^0.1@beta

持续开发 · 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:^0.1@beta

配置存储

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

编辑器集成

选择器与编辑器保持解耦

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

CKEditor 4CKEditor 5TinyMCECustom editorCustom picker

1编辑器

2SoFinder JS API

3SoFinder 后端

4存储

查看编辑器集成

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

安装

bash

composer require sohophp/sofinder:^0.1@beta

接着注册 Bundle、导入路由并建立至少一个存储资源。请从安装与快速开始开始，完整选项可参考配置参考。

Beta 版本

SoFinder 当前是公开 Beta。请明确指定 Beta 版本条件，升级前阅读更新日志及升级指南。

已经在使用 SoFinder？请阅读文件管理器指南、图片管理和主流编辑器集成。开发集成请查看开发者指南及 HTTP API 参考。