Configuración

KCFinder mantiene la configuración tradicional en PHP y permite que la aplicación anfitriona sobrescriba valores mediante sesión. Prioriza una configuración explícita, versiona sólo ejemplos seguros y conserva los valores locales fuera del repositorio.

Orden de configuración

1. Valores predeterminados del núcleo.
2. conf/config.php de la instalación.
3. conf/config.local.php, cuando se utiliza.
4. Valores proporcionados por la integración y la sesión.

Ajustes esenciales

Opción	Propósito
disabled	Mantiene KCFinder cerrado hasta que la aplicación autentique y autorice al usuario.
uploadURL	URL pública o controlada que representa el almacenamiento.
uploadDir	Ruta física confinada donde se administran archivos.
theme	Tema visual activo, por ejemplo default o bootstrap5.
themeOptions	Opciones visuales acotadas por tema, incluida la paleta semántica Bootstrap 5.
search	Búsqueda optativa por nombre, con límites de resultados, recorrido y tiempo.
dragMove	Movimiento directo optativo mediante arrastre o Mover a….
types	Reglas de extensiones, MIME, tamaños y dimensiones por tipo de archivo.

Configuración por sesión

$_SESSION['KCFINDER'] = [
    'disabled' => false,
    'uploadURL' => '/storage/media',
    'uploadDir' => '/srv/app/storage/media',
    'theme' => 'bootstrap5',
];

No mezcles URL y ruta física

uploadURL se entrega al navegador. uploadDir sólo debe utilizarse en el servidor y nunca debe filtrarse en respuestas o mensajes de error.

Continúa con búsqueda de carpetas y archivos, movimiento directo, uploads y URLs o revisa la referencia de configuración.