Get files from a local path.

This is a wrapper to use Symfony Finder with 2 extras features {group} and {icon_id}.

Parameters

string $source: The source path, which can be absolute (starting with '/') or relative to the definition folder.

string $relative_path: The relative path to the definition folder.

Return value

array<string, array<string, string|null>> The file discovered.

1 call to IconFinder::getFilesFromPath()

IconFinder::getFilesFromSources in core/lib/Drupal/Core/Theme/Icon/IconFinder.php

Create files from source paths.

File

core/lib/Drupal/Core/Theme/Icon/IconFinder.php, line 194

Class

IconFinder

Icon finder to discover files under specific paths or URLs.

Namespace

Drupal\Core\Theme\Icon

Code

private function getFilesFromPath(string $source, string $relative_path) : array {
  $path_info = pathinfo($source);
  $dirname = $path_info['dirname'] ?? '';
  $extension = $path_info['extension'] ?? '';
  $filename = $path_info['filename'] ?? '';
  if (empty($dirname)) {
    return [];
  }
  // Set extension to wildcard if empty, and validate against allowed
  // extensions.
  $extension = empty($extension) ? '*' : $extension;
  if ('*' !== $extension && !in_array($extension, self::ALLOWED_EXTENSION, TRUE)) {
    $this->logger
      ->warning('Invalid icon path extension @filename.@extension in source: @source', [
      '@filename' => $filename,
      '@extension' => $extension,
      '@source' => $source,
    ]);
    return [];
  }
  // Use allowed extension bracket for Finder if wildcard.
  $extension = '*' === $extension ? '{' . implode(',', self::ALLOWED_EXTENSION) . '}' : $extension;
  // Prepare filename wildcard if empty or with {icon_id} pattern.
  $filename_wildcard = empty($filename) ? '*' : str_replace(self::ICON_ID_PATTERN, '*', $filename);
  // If icons are in the same folder dirname is 'dot'.
  if ('.' === $dirname) {
    $dirname = '';
  }
  // Prepare path to search for icons for Finder::in().
  $path = str_starts_with($source, '/') ? $this->appRoot . $dirname : sprintf('%s/%s/%s', $this->appRoot, $relative_path, $dirname);
  // Prepare file names for Finder::name().
  $names = sprintf('%s.%s', $filename_wildcard, $extension);
  if (!($finder = $this->findFiles($path, $names))) {
    return [];
  }
  // Wildcard around filename are ignored for extractIconIdFromFilename.
  $filename = str_replace('*', '', $filename);
  return $this->processFoundFiles($finder, $source, $filename, self::determineGroupPosition($path));
}

---