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 參考。