class FileRepository

Same name in other branches
  1. 10 core/modules/file/src/FileRepository.php \Drupal\file\FileRepository
  2. 11.x core/modules/file/src/FileRepository.php \Drupal\file\FileRepository

Provides a file entity repository.

Hierarchy

Expanded class hierarchy of FileRepository

3 files declare their use of FileRepository
CopyTest.php in core/modules/file/tests/src/Kernel/CopyTest.php
FileRepositoryTest.php in core/modules/file/tests/src/Kernel/FileRepositoryTest.php
MoveTest.php in core/modules/file/tests/src/Kernel/MoveTest.php
1 string reference to 'FileRepository'
file.services.yml in core/modules/file/file.services.yml
core/modules/file/file.services.yml
1 service uses FileRepository
file.repository in core/modules/file/file.services.yml
Drupal\file\FileRepository

File

core/modules/file/src/FileRepository.php, line 17

Namespace

Drupal\file
View source
class FileRepository implements FileRepositoryInterface {
    
    /**
     * The file system service.
     *
     * @var \Drupal\Core\File\FileSystemInterface
     */
    protected $fileSystem;
    
    /**
     * The stream wrapper manager.
     *
     * @var \Drupal\Core\StreamWrapper\StreamWrapperManagerInterface
     */
    protected $streamWrapperManager;
    
    /**
     * The entity type manager.
     *
     * @var \Drupal\Core\Entity\EntityTypeManagerInterface
     */
    protected $entityTypeManager;
    
    /**
     * The module handler.
     *
     * @var \Drupal\Core\Extension\ModuleHandlerInterface
     */
    protected $moduleHandler;
    
    /**
     * The file usage service.
     *
     * @var \Drupal\file\FileUsage\FileUsageInterface
     */
    protected $fileUsage;
    
    /**
     * The current user.
     *
     * @var \Drupal\Core\Session\AccountInterface
     */
    protected $currentUser;
    
    /**
     * FileRepository constructor.
     *
     * @param \Drupal\Core\File\FileSystemInterface $fileSystem
     *   The file system.
     * @param \Drupal\Core\StreamWrapper\StreamWrapperManagerInterface $streamWrapperManager
     *   The stream wrapper manager.
     * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entityTypeManager
     *   The entity type manager.
     * @param \Drupal\Core\Extension\ModuleHandlerInterface $moduleHandler
     *   The module handler.
     * @param \Drupal\file\FileUsage\FileUsageInterface $fileUsage
     *   The file usage service.
     * @param \Drupal\Core\Session\AccountInterface $currentUser
     *   The current user.
     */
    public function __construct(FileSystemInterface $fileSystem, StreamWrapperManagerInterface $streamWrapperManager, EntityTypeManagerInterface $entityTypeManager, ModuleHandlerInterface $moduleHandler, FileUsageInterface $fileUsage, AccountInterface $currentUser) {
        $this->fileSystem = $fileSystem;
        $this->streamWrapperManager = $streamWrapperManager;
        $this->entityTypeManager = $entityTypeManager;
        $this->moduleHandler = $moduleHandler;
        $this->fileUsage = $fileUsage;
        $this->currentUser = $currentUser;
    }
    
    /**
     * {@inheritdoc}
     */
    public function writeData(string $data, string $destination, int $replace = FileSystemInterface::EXISTS_RENAME) : FileInterface {
        if (!$this->streamWrapperManager
            ->isValidUri($destination)) {
            throw new InvalidStreamWrapperException("Invalid stream wrapper: {$destination}");
        }
        $uri = $this->fileSystem
            ->saveData($data, $destination, $replace);
        return $this->createOrUpdate($uri, $destination, $replace === FileSystemInterface::EXISTS_RENAME);
    }
    
    /**
     * Create a file entity or update if it exists.
     *
     * @param string $uri
     *   The file URI.
     * @param string $destination
     *   The destination URI.
     * @param bool $rename
     *   Whether to rename the file.
     *
     * @return \Drupal\file\Entity\File|\Drupal\file\FileInterface
     *   The file entity.
     *
     * @throws \Drupal\Core\Entity\EntityStorageException
     *   Thrown when there is an error saving the file.
     */
    protected function createOrUpdate(string $uri, string $destination, bool $rename) : FileInterface {
        $file = $this->loadByUri($uri);
        if ($file === NULL) {
            $file = File::create([
                'uri' => $uri,
            ]);
            $file->setOwnerId($this->currentUser
                ->id());
        }
        if ($rename && is_file($destination)) {
            $file->setFilename($this->fileSystem
                ->basename($destination));
        }
        $file->setPermanent();
        $file->save();
        return $file;
    }
    
    /**
     * {@inheritdoc}
     */
    public function copy(FileInterface $source, string $destination, int $replace = FileSystemInterface::EXISTS_RENAME) : FileInterface {
        if (!$this->streamWrapperManager
            ->isValidUri($destination)) {
            throw new InvalidStreamWrapperException("Invalid stream wrapper: {$destination}");
        }
        $uri = $this->fileSystem
            ->copy($source->getFileUri(), $destination, $replace);
        // If we are replacing an existing file, load it.
        if ($replace === FileSystemInterface::EXISTS_REPLACE && ($existing = $this->loadByUri($uri))) {
            $file = $existing;
        }
        else {
            $file = $source->createDuplicate();
            $file->setFileUri($uri);
            // If we are renaming around an existing file (rather than a directory),
            // use its basename for the filename.
            if ($replace === FileSystemInterface::EXISTS_RENAME && is_file($destination)) {
                $file->setFilename($this->fileSystem
                    ->basename($destination));
            }
            else {
                $file->setFilename($this->fileSystem
                    ->basename($uri));
            }
        }
        $file->save();
        // Inform modules that the file has been copied.
        $this->moduleHandler
            ->invokeAll('file_copy', [
            $file,
            $source,
        ]);
        return $file;
    }
    
    /**
     * {@inheritdoc}
     */
    public function move(FileInterface $source, string $destination, int $replace = FileSystemInterface::EXISTS_RENAME) : FileInterface {
        if (!$this->streamWrapperManager
            ->isValidUri($destination)) {
            throw new InvalidStreamWrapperException("Invalid stream wrapper: {$destination}");
        }
        $uri = $this->fileSystem
            ->move($source->getFileUri(), $destination, $replace);
        $delete_source = FALSE;
        $file = clone $source;
        $file->setFileUri($uri);
        // If we are replacing an existing file re-use its database record.
        if ($replace === FileSystemInterface::EXISTS_REPLACE) {
            if ($existing = $this->loadByUri($uri)) {
                $delete_source = TRUE;
                $file->fid = $existing->id();
                $file->uuid = $existing->uuid();
            }
        }
        elseif ($replace === FileSystemInterface::EXISTS_RENAME && is_file($destination)) {
            $file->setFilename($this->fileSystem
                ->basename($destination));
        }
        $file->save();
        // Inform modules that the file has been moved.
        $this->moduleHandler
            ->invokeAll('file_move', [
            $file,
            $source,
        ]);
        // Delete the original if it's not in use elsewhere.
        if ($delete_source && !$this->fileUsage
            ->listUsage($source)) {
            $source->delete();
        }
        return $file;
    }
    
    /**
     * {@inheritdoc}
     */
    public function loadByUri(string $uri) : ?FileInterface {
        $fileStorage = $this->entityTypeManager
            ->getStorage('file');
        
        /** @var \Drupal\file\FileInterface[] $files */
        $files = $fileStorage->loadByProperties([
            'uri' => $uri,
        ]);
        if (count($files)) {
            foreach ($files as $item) {
                // Since some database servers sometimes use a case-insensitive
                // comparison by default, double check that the filename is an exact
                // match.
                if ($item->getFileUri() === $uri) {
                    return $item;
                }
            }
        }
        return NULL;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
FileRepository::$currentUser protected property The current user.
FileRepository::$entityTypeManager protected property The entity type manager.
FileRepository::$fileSystem protected property The file system service.
FileRepository::$fileUsage protected property The file usage service.
FileRepository::$moduleHandler protected property The module handler.
FileRepository::$streamWrapperManager protected property The stream wrapper manager.
FileRepository::copy public function Copies a file to a new location and adds a file record to the database. Overrides FileRepositoryInterface::copy
FileRepository::createOrUpdate protected function Create a file entity or update if it exists.
FileRepository::loadByUri public function Loads the first File entity found with the specified URI. Overrides FileRepositoryInterface::loadByUri
FileRepository::move public function Moves a file to a new location and update the file's database entry. Overrides FileRepositoryInterface::move
FileRepository::writeData public function Writes a file to the specified destination and creates a file entity. Overrides FileRepositoryInterface::writeData
FileRepository::__construct public function FileRepository constructor.

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