Транслитерация имени файла при создании медиа 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. Вы можете перейти в конец страницы и оставить ваш комментарий.

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

Использование контекста публикации во views

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

У вас есть публикация и в ней задана категория (таксономия). Задача - использовать значение выбранной категории во view, которая отображается на данной ...

Читать

Настройка ЧПУ в Drupal 10: path_alias, Pathauto и Token

Июль 2, 2025 г.

Drupal — мощная, гибкая и в то же время довольно сложная CMS. Один из важных аспектов SEO и удобства пользователей — это ЧПУ (человекопонятные URL). В ...

Читать

Получить список типов товаров в Drupal Commerce

Июль 23, 2023 г.

В терминологии Drupal, типы товаров это - бандлы (bundle) сущности commerce_product. Получить их список можно вот так: [crayon-6956d48d99940360922293/] Как результат, в $product_types вы получите массив типов товаров, где ключом является ...

Читать

Управление размерами autocomplete ui widget в Drupal

Октябрь 25, 2023 г.

Попался мне UI баг, когда autocomplete слой с результатами поиска оказывался больше по ширине, чем input элемент, к которому он был прикреплен. Не ясен был алгоритм, по которому вычислялась ширина слоя. В одних случаях это происходило корректно, ...

Читать

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

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

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