File.php

Same filename in this branch
  1. 11.x core/modules/media/src/Plugin/media/Source/File.php
  2. 11.x core/modules/file/src/Entity/File.php
  3. 11.x core/modules/file/src/Plugin/views/field/File.php
  4. 11.x core/modules/file/src/Plugin/views/wizard/File.php
  5. 11.x core/modules/file/src/Plugin/migrate/source/d6/File.php
  6. 11.x core/lib/Drupal/Core/Render/Element/File.php
Same filename and directory in other branches
  1. 9 core/modules/media/src/Plugin/media/Source/File.php
  2. 9 core/modules/file/src/Entity/File.php
  3. 9 core/modules/file/src/Plugin/views/field/File.php
  4. 9 core/modules/file/src/Plugin/views/wizard/File.php
  5. 9 core/modules/file/src/Plugin/migrate/source/d6/File.php
  6. 9 core/modules/file/src/Plugin/migrate/source/d7/File.php
  7. 9 core/lib/Drupal/Core/Render/Element/File.php
  8. 8.9.x core/modules/media/src/Plugin/media/Source/File.php
  9. 8.9.x core/modules/file/src/Entity/File.php
  10. 8.9.x core/modules/file/src/Plugin/views/field/File.php
  11. 8.9.x core/modules/file/src/Plugin/views/wizard/File.php
  12. 8.9.x core/modules/file/src/Plugin/migrate/source/d6/File.php
  13. 8.9.x core/modules/file/src/Plugin/migrate/source/d7/File.php
  14. 8.9.x core/lib/Drupal/Core/Render/Element/File.php
  15. 10 core/modules/media/src/Plugin/media/Source/File.php
  16. 10 core/modules/file/src/Entity/File.php
  17. 10 core/modules/file/src/Plugin/views/field/File.php
  18. 10 core/modules/file/src/Plugin/views/wizard/File.php
  19. 10 core/modules/file/src/Plugin/migrate/source/d6/File.php
  20. 10 core/modules/file/src/Plugin/migrate/source/d7/File.php
  21. 10 core/lib/Drupal/Core/Render/Element/File.php

Namespace

Drupal\file\Plugin\migrate\source\d7

File

core/modules/file/src/Plugin/migrate/source/d7/File.php

View source
<?php

namespace Drupal\file\Plugin\migrate\source\d7;

use Drupal\migrate\Row;
use Drupal\migrate_drupal\Plugin\migrate\source\DrupalSqlBase;

/**
 * Drupal 7 file source from database.
 *
 * Available configuration keys:
 * - scheme: (optional) The scheme of the files to get from the source, for
 *   example, 'public' or 'private'. Can be a string or an array of schemes.
 *   The 'temporary' scheme is not supported. If omitted, all files in
 *   supported schemes are retrieved.
 *
 * Example:
 *
 * @code
 * source:
 *   plugin: d7_file
 *   scheme: public
 * @endcode
 *
 * In this example, public file values are retrieved from the source database.
 * For complete example, refer to the d7_file.yml migration.
 *
 * For additional configuration keys, refer to the parent classes.
 *
 * @see \Drupal\migrate\Plugin\migrate\source\SqlBase
 * @see \Drupal\migrate\Plugin\migrate\source\SourcePluginBase
 * @see d7_file.yml
 *
 * @MigrateSource(
 *   id = "d7_file",
 *   source_module = "file"
 * )
 */
class File extends DrupalSqlBase {
    
    /**
     * The public file directory path.
     *
     * @var string
     */
    protected $publicPath;
    
    /**
     * The private file directory path, if any.
     *
     * @var string
     */
    protected $privatePath;
    
    /**
     * {@inheritdoc}
     */
    public function query() {
        $query = $this->select('file_managed', 'f')
            ->fields('f')
            ->condition('f.uri', 'temporary://%', 'NOT LIKE')
            ->orderBy('f.timestamp');
        // Filter by scheme(s), if configured.
        if (isset($this->configuration['scheme'])) {
            $schemes = [];
            // Remove 'temporary' scheme.
            $valid_schemes = array_diff((array) $this->configuration['scheme'], [
                'temporary',
            ]);
            // Accept either a single scheme, or a list.
            foreach ((array) $valid_schemes as $scheme) {
                $schemes[] = rtrim($scheme) . '://';
            }
            $schemes = array_map([
                $this->getDatabase(),
                'escapeLike',
            ], $schemes);
            // Add conditions, uri LIKE 'public://%' OR uri LIKE 'private://%'.
            $conditions = $this->getDatabase()
                ->condition('OR');
            foreach ($schemes as $scheme) {
                $conditions->condition('f.uri', $scheme . '%', 'LIKE');
            }
            $query->condition($conditions);
        }
        return $query;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function initializeIterator() {
        $this->publicPath = $this->variableGet('file_public_path', 'sites/default/files');
        $this->privatePath = $this->variableGet('file_private_path', NULL);
        return parent::initializeIterator();
    }
    
    /**
     * {@inheritdoc}
     */
    public function prepareRow(Row $row) {
        // Compute the filepath property, which is a physical representation of
        // the URI relative to the Drupal root.
        $path = str_replace([
            'public:/',
            'private:/',
        ], [
            $this->publicPath,
            $this->privatePath,
        ], $row->getSourceProperty('uri'));
        // At this point, $path could be an absolute path or a relative path,
        // depending on how the scheme's variable was set. So we need to shear out
        // the source_base_path in order to make them all relative.
        $path = preg_replace('#' . preg_quote($this->configuration['constants']['source_base_path']) . '#', '', $path, 1);
        $row->setSourceProperty('filepath', $path);
        return parent::prepareRow($row);
    }
    
    /**
     * {@inheritdoc}
     */
    public function fields() {
        return [
            'fid' => $this->t('File ID'),
            'uid' => $this->t('The {users}.uid who added the file. If set to 0, this file was added by an anonymous user.'),
            'filename' => $this->t('File name'),
            'filepath' => $this->t('File path'),
            'filemime' => $this->t('File MIME Type'),
            'status' => $this->t('The published status of a file.'),
            'timestamp' => $this->t('The time that the file was added.'),
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function getIds() {
        $ids['fid']['type'] = 'integer';
        $ids['fid']['alias'] = 'f';
        return $ids;
    }

}

Classes

Title Deprecated Summary
File Drupal 7 file source from database.

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