DriverRegistry.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Resource\Driver;

class DriverRegistry implements \TYPO3\CMS\Core\SingletonInterface {

    protected $drivers = array();

    protected $driverConfigurations = array();

    public function __construct() {
        $driverConfigurations = $GLOBALS['TYPO3_CONF_VARS']['SYS']['fal']['registeredDrivers'];
        foreach ($driverConfigurations as $shortName => $driverConfig) {
            $shortName = $shortName ?: $driverConfig['shortName'];
            $this->registerDriverClass($driverConfig['class'], $shortName, $driverConfig['label'], $driverConfig['flexFormDS']);
        }
    }

    public function registerDriverClass($className, $shortName = NULL, $label = NULL, $flexFormDataStructurePathAndFilename = NULL) {
        // check if the class is available for TYPO3 before registering the driver
        if (!class_exists($className)) {
            throw new \InvalidArgumentException('Class ' . $className . ' does not exist.', 1314979197);
        }

        if (!in_array('TYPO3\CMS\Core\Resource\Driver\DriverInterface', class_implements($className), TRUE)) {
            throw new \InvalidArgumentException('Driver ' . $className . ' needs to implement the DriverInterface.', 1387619575);
        }
        if ($shortName === '') {
            $shortName = $className;
        }
        if (array_key_exists($shortName, $this->drivers)) {
                // Return immediately without changing configuration
            if ($this->drivers[$shortName] === $className) {
                return TRUE;
            } else {
                throw new \InvalidArgumentException('Driver ' . $shortName . ' is already registered.', 1314979451);
            }
        }
        $this->drivers[$shortName] = $className;
        $this->driverConfigurations[$shortName] = array(
            'class' => $className,
            'shortName' => $shortName,
            'label' => $label,
            'flexFormDS' => $flexFormDataStructurePathAndFilename
        );
        return TRUE;
    }

    public function addDriversToTCA() {
        // Add driver to TCA of sys_file_storage
        if (TYPO3_MODE !== 'BE') {
            return;
        }
        $driverFieldConfig = &$GLOBALS['TCA']['sys_file_storage']['columns']['driver']['config'];
        $configurationFieldConfig = &$GLOBALS['TCA']['sys_file_storage']['columns']['configuration']['config'];
        foreach ($this->driverConfigurations as $driver) {
            $label = $driver['label'] ?: $driver['class'];
            $driverFieldConfig['items'][] = array($label, $driver['shortName']);
            if ($driver['flexFormDS']) {
                $configurationFieldConfig['ds'][$driver['shortName']] = $driver['flexFormDS'];
            }
        }
    }

    public function getDriverClass($shortName) {
        if (in_array($shortName, $this->drivers) && class_exists($shortName)) {
            return $shortName;
        }
        if (!array_key_exists($shortName, $this->drivers)) {
            throw new \InvalidArgumentException('Desired storage is not in the list of available storages.', 1314085990);
        }
        return $this->drivers[$shortName];
    }

    public function driverExists($shortName) {
        return array_key_exists($shortName, $this->drivers);
    }
}