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；兩個 Package 名稱都公開相同的 namespace。接著註冊 Bundle、匯入路由並建立至少一個儲存資源。請從安裝與快速開始開始，完整選項可參考設定參考。

正式支援的 Framework 版本線

Symfony 6.4／7.4、Laravel 12／13 與共用 PSR-15 Host 均為正式支援的 Full-stack 整合。Laravel、Slim、Mezzio 和純 PHP 的可執行接入步驟見框架整合指南，具體 PHP 8 組合詳見Framework 支援策略。PHP 8 主線絕不為 PHP 7.2 降級；Legacy 可行性始終獨立評估。

在 CMS 中使用 SoFinder？請先閱讀 CMS 內容編輯者指南。需要瞭解全部檔案操作時，繼續閱讀完整檔案管理器指南和圖片管理。開發整合請查看開發者指南及 HTTP API 參考。