class FileUsageBase

Same name in other branches
  1. 9 core/modules/file/src/FileUsage/FileUsageBase.php \Drupal\file\FileUsage\FileUsageBase
  2. 10 core/modules/file/src/FileUsage/FileUsageBase.php \Drupal\file\FileUsage\FileUsageBase
  3. 11.x core/modules/file/src/FileUsage/FileUsageBase.php \Drupal\file\FileUsage\FileUsageBase

Defines the base class for database file usage backend.

Hierarchy

Expanded class hierarchy of FileUsageBase

2 files declare their use of FileUsageBase
LegacyFileTest.php in core/modules/file/tests/src/Unit/LegacyFileTest.php
TestFileUsage.php in core/modules/system/tests/modules/service_provider_test/src/TestFileUsage.php

File

core/modules/file/src/FileUsage/FileUsageBase.php, line 11

Namespace

Drupal\file\FileUsage
View source
abstract class FileUsageBase implements FileUsageInterface {
    
    /**
     * The config factory.
     *
     * @var \Drupal\Core\Config\ConfigFactoryInterface
     */
    protected $configFactory;
    
    /**
     * Creates a FileUsageBase object.
     *
     * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
     *   The config factory. This parameter is required as of drupal:8.4.0 and
     *   trigger a fatal error if not passed in drupal:9.0.0.
     *
     * @todo Update the docblock and make $config_factory required in
     *   https://www.drupal.org/project/drupal/issues/3070114 when the
     *   drupal:9.0.x branch is opened.
     */
    public function __construct(ConfigFactoryInterface $config_factory = NULL) {
        // @todo Remove below conditional when the drupal:9.0.x branch is opened.
        // @see https://www.drupal.org/project/drupal/issues/3070114
        if (empty($config_factory)) {
            @trigger_error('Not passing the $config_factory parameter to ' . __METHOD__ . ' is deprecated in drupal:8.4.0 and will trigger a fatal error in drupal:9.0.0. See https://www.drupal.org/project/drupal/issues/2801777', E_USER_DEPRECATED);
            $config_factory = \Drupal::configFactory();
        }
        $this->configFactory = $config_factory;
    }
    
    /**
     * {@inheritdoc}
     */
    public function add(FileInterface $file, $module, $type, $id, $count = 1) {
        // Make sure that a used file is permanent.
        if (!$file->isPermanent()) {
            $file->setPermanent();
            $file->save();
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function delete(FileInterface $file, $module, $type = NULL, $id = NULL, $count = 1) {
        // Do not actually mark files as temporary when the behavior is disabled.
        if (!$this->configFactory
            ->get('file.settings')
            ->get('make_unused_managed_files_temporary')) {
            return;
        }
        // If there are no more remaining usages of this file, mark it as temporary,
        // which result in a delete through system_cron().
        $usage = \Drupal::service('file.usage')->listUsage($file);
        if (empty($usage)) {
            $file->setTemporary();
            $file->save();
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
FileUsageBase::$configFactory protected property The config factory.
FileUsageBase::add public function Records that a module is using a file. Overrides FileUsageInterface::add 3
FileUsageBase::delete public function Removes a record to indicate that a module is no longer using a file. Overrides FileUsageInterface::delete 3
FileUsageBase::__construct public function Creates a FileUsageBase object. 1
FileUsageInterface::listUsage public function Determines where a file is used. 3

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.