【第6回】 カテゴリを考慮したランダム選択 - [Drupal非管理ファイル完全ガイド]チュートリアルシリーズ

public://segregated_maps/
├── africa
├── antarctica
├── asia
├── australia
├── caribbean
├── central america
├── europe
├── mideast
├── north america
├── pacific islands
└── south america

<?php
namespace Drupal\unmanaged_files\Service;
use Drupal\Core\File\FileSystemInterface;
/**
 * カテゴリを考慮した非管理ファイルのランダム選択を提供します。
 *
 * public://segregated_maps配下の異なるサブフォルダーから
 * 3つのランダムファイルを選択します。
 */
class RandomCategoryFileHandler {
  protected FileSystemInterface $fileSystem;
  protected string $basePath;
  public function __construct(FileSystemInterface $file_system) {
    $this->fileSystem = $file_system;
    $this->basePath = 'public://segregated_maps';
  }
  /**
   * 異なるカテゴリサブフォルダーからランダムファイルを選択します。
   */
  public function getCategoryConstrainedFiles(int $limit = 3): array {
    $selected = [];
    $base = $this->fileSystem->realpath($this->basePath);
    if (!$base || !is_dir($base)) {
      return $selected;
    }
    $dirs = glob($base . '/*', GLOB_ONLYDIR);
    if (empty($dirs)) {
      return $selected;
    }
    shuffle($dirs);
    foreach ($dirs as $dir) {
      $files = glob($dir . '/*.{jpg,jpeg,png,gif,webp}', GLOB_BRACE);
      if (!empty($files)) {
        $selected[] = $files[array_rand($files)];
      }
      if (count($selected) >= $limit) {
        break;
      }
    }
    shuffle($selected);
    return $selected;
  }
  /**
   * ランダム選択されたファイルのレンダリング可能な画像配列を返します。
   */
  public function getRenderableCategoryConstrainedFiles(int $limit = 3): array {
    $real_public = $this->fileSystem->realpath('public://');
    $base_url = '/sites/default/files';
    $files = $this->getCategoryConstrainedFiles($limit);
    $renderable = [];
    foreach ($files as $file) {
      $url = str_replace($real_public, $base_url, $file);
      $renderable[] = [
        '#theme' => 'image',
        '#uri' => $url,
        '#alt' => 'ランダムマップ画像',
        '#attributes' => ['loading' => 'lazy'],
      ];
    }
    return $renderable;
  }
}

<?php
namespace Drupal\unmanaged_files\Plugin\Block;
use Drupal\Core\Block\BlockBase;
use Drupal\Core\Plugin\ContainerFactoryPluginInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;
/**
 * 異なるsegregated-mapカテゴリから3つのランダムファイルを表示します。
 *
 * @Block(
 *   id = "random_category_files_block",
 *   admin_label = @Translation("Random Category Files Block")
 * )
 */
class RandomCategoryFilesBlock extends BlockBase implements ContainerFactoryPluginInterface {
  protected $randomCategoryHandler;
  public function __construct(array $configuration, $plugin_id, $plugin_definition, $random_category_handler) {
    parent::__construct($configuration, $plugin_id, $plugin_definition);
    $this->randomCategoryHandler = $random_category_handler;
  }
  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
    return new static(
      $configuration,
      $plugin_id,
      $plugin_definition,
      $container->get('unmanaged_files.random_category_file_handler')
    );
  }
  public function build() {
    $images = $this->randomCategoryHandler->getRenderableCategoryConstrainedFiles(3);
    return [
      '#theme' => 'unmanaged_files_category_block',
      '#images' => $images,
    ];
  }
}

services:
  unmanaged_files.handler:
    class: Drupal\unmanaged_files\Service\FileHandler
    arguments: ['@file_system','@stream_wrapper_manager']
  unmanaged_files.twig_extension:
    class: Drupal\unmanaged_files\Twig\UnmanagedFilesExtension
    arguments: ['@unmanaged_files.handler','@file_url_generator']
    tags:
      - { name: twig.extension }
  unmanaged_files.random_category_file_handler:
    class: Drupal\unmanaged_files\Service\RandomCategoryFileHandler
    arguments: ['@file_system']

<?php
/**
 * Implements hook_theme().
 */
function unmanaged_files_theme() {
  return [
    'unmanaged_files_test' => [
      'variables' => [
        'image_url' => NULL,
        'uri' => NULL,
        'message' => NULL,
      ],
      'template' => 'unmanaged-files-test',
    ],
    'unmanaged_files_category_block' => [
      'variables' => [
        'images' => [],
      ],
      'template' => 'unmanaged-files-category-block',
    ],
  ];
}

{# 
/**
 * @file
 * Random Category Files Block用のテンプレート。
 */
#}
<div class="unmanaged-files-category-block">
  {% if images is not empty %}
    <div class="random-category-images">
      {% for image in images %}
        <div class="random-category-image">
          {{ image }}
        </div>
      {% endfor %}
    </div>
  {% else %}
    <p>{{ 'segregated mapフォルダーに画像が見つかりません。'|t }}</p>
  {% endif %}
</div>