Транслитерация имени файла при создании медиа entity программно в Drupal

При импорте изображений возникает задача транслитерации. Картинки, например, могут содержать буквы национальной кодировки (кириллицы) и/или иметь несовместимые с файловой системой сервера символы.

Drupal (начиная с 8.2) объявляет специальный интерфейс, который формализует эту задачу:
сore/lib/Drupal/Component/Transliteration/TransliterationInterface.php.

Но нужных нам реализаций в ядре нет, их можно найти в сторонних модулях.

Установим модуль transliterate_filenames.

Он предоставляет имплементацию интерфейса в виде сервиса, а также добавляет свою функцию — sanitizeFilename(). Если требуется выполнить транслитерацию имени файла, то реализуется это так:

// исходные данные - файловый путь 
// и директорий для сохранения файла
$filepath = '...';
$directory = 'public://my-dir';

// транслитерация имени файла
$translit = \Drupal::service('transliterate_filenames.sanitize_name');
$newName = $translit->sanitizeFilename(
    pathinfo($filepath, PATHINFO_FILENAME)
  )
  . '.'
  . pathinfo($filepath, PATHINFO_EXTENSION);

// исходные данные - файловый путь

// и директорий для сохранения файла

$filepath = '...';

$directory = 'public://my-dir';

// транслитерация имени файла

$translit = \Drupal::service('transliterate_filenames.sanitize_name');

$newName = $translit->sanitizeFilename(

pathinfo($filepath, PATHINFO_FILENAME)

)

. '.'

. pathinfo($filepath, PATHINFO_EXTENSION);

Теперь можно создавать файл:

$fs = \Drupal::service('file_system');
$fs->prepareDirectory(
  $directory, 
  FileSystemInterface:: CREATE_DIRECTORY | FileSystemInterface::MODIFY_PERMISSIONS);
$fs->copy($filepath, $directory . '/' . $newName, 
  FileSystemInterface::EXISTS_REPLACE);

$file = \Drupal\file\Entity\File::create([
  'filename' => basename($newName),
  'uri' => $directory . '/' . $newName,
  'status' => 1,
  'uid' => \Drupal::currentUser()->id(),
]);
$file->save();

$fs = \Drupal::service('file_system');

$fs->prepareDirectory(

$directory,

FileSystemInterface:: CREATE_DIRECTORY | FileSystemInterface::MODIFY_PERMISSIONS);

$fs->copy($filepath, $directory . '/' . $newName,

FileSystemInterface::EXISTS_REPLACE);

$file = \Drupal\file\Entity\File::create([

'filename' => basename($newName),

'uri' => $directory . '/' . $newName,

'status' => 1,

'uid' => \Drupal::currentUser()->id(),

]);

$file->save();

И, наконец, создадим медиа объект на основе сохраненного файла.

В разных версиях друпала может отличаться имя медиа-поля, куда сохраняется file ID. В 10ке — это field_media_image, в более ранних версиях может быть просто field_image.

$media = \Drupal\media\Entity\Media::create([
  'bundle' => 'image',
  'uid' => \Drupal::currentUser()->id(),
  'langcode' => \Drupal::languageManager()->getDefaultLanguage()->getId(),
  'status' => 1,
  'field_media_image' => [
     'target_id' => $file->id(),
     'alt' => $name,
     'title' => $name,
   ],
 ]);
 $media->save();

$media = \Drupal\media\Entity\Media::create([

'bundle' => 'image',

'uid' => \Drupal::currentUser()->id(),

'langcode' => \Drupal::languageManager()->getDefaultLanguage()->getId(),

'status' => 1,

'field_media_image' => [

'target_id' => $file->id(),

'alt' => $name,

'title' => $name,

]);

$media->save();

Drupal 9/10

Написать комментарий

Данная запись опубликована в 21.05.2023 20:10 и размещена в рубрике Drupal. Вы можете перейти в конец страницы и оставить ваш комментарий.

Мало букафф? Читайте есчо !

Загрузка файла через форму в Drupal

Май 19, 2023 г.

Посмотрим как получить непосредственный доступ к файлу без загрузки файла в хранилище, при его загрузке в поле типа "file" Form API. Много гайдов посвящено тому как использовать поле managed_file, а для unmanaged случая считается, что разработчик ...

Читать

Как получить код языка по умолчанию в Drupal

Июль 4, 2025 г.

В Drupal (начиная с версии 8 и выше, включая 10 и 11), чтобы получить код языка по умолчанию сайта (например, en, ru, fr), используйте следующий способ: [crayon-68e549c63ee03828168432/] Подробности запроса: \Drupal::languageManager() — обращение ...

Читать

Как добавить css классы в attributes (twig, Drupal)

Май 16, 2024 г.

Порою требуется добавить свои классы в переменную attributes на уровне шаблона (в twig). Переменная attributes - это объект Drupal\Core\Template\Attribute. У него есть нужный нам метод - addClass(). Пример использования: [crayon-68e549c63ef46709737167/]

Читать

Дополняем результаты views

Февраль 14, 2024 г.

Пример того, как можно дополнить результаты views в Drupal 9/10. Задача - вывести для статьи блок со связанными публикациями. В начале нужно было просто выводить последние статьи того же типа, а потом у заказчика возникло желание переопределять выдачу, ...

Читать

Комментарии к «Транслитерация имени файла при создании медиа entity программно в Drupal»

Понравилась статья? Есть вопросы? - пишите в комментариях.

Имя (обязательно)	Е-майл (не будет опубликован на сайте, обязательно для заполнения)
Комментарий: