README

Official Symfony and Flysystem adapter for krma-cl/kcfinder. It connects a Flysystem storage, Symfony Security and the event dispatcher to KCFinder's framework-independent selector contract.

Requirements

• PHP 8.2 or newer.
• Symfony 7.4 or 8.x.
• A Flysystem 3 filesystem service.
• A deployed KCFinder browser from krma-cl/kcfinder.

Installation

composer require krma-cl/kcfinder-symfony-bundle

Register Krma\KCFinder\Symfony\KCFinderBundle when Symfony Flex does not do it for you, then configure the bundle:

# config/packages/kcfinder.yaml
kcfinder:
    filesystem_service: 'app.transparency_filesystem'
    url_prefix: '/storage/transparencia'
    security_attribute: 'KCFINDER_SELECT'
    browser_url: '/vendor/kcfinder/browse.php'

Create a voter for KCFINDER_SELECT. Its subject is an array with operation and path. Resolve a selected file through the manager:

use Krma\KCFinder\Symfony\KCFinderManager;

$file = $manager->select('/01-actos/DO-20130614.pdf');
return $this->json($file);

The result contains name, path, url, mime and size. A FileSelectedEvent is dispatched after an authorized selection.

The bundle does not copy or publish the legacy browser automatically. Follow the core installation guide for the browser itself.

Development

composer install
composer check