Транслитерация имени файла при создании медиа 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 10: path_alias, Pathauto и Token

Июль 2, 2025 г.

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

Читать

The installed version of the /Имя модуля/ module is too old to update

Октябрь 9, 2024 г.

При выполнении drush updb вы можете увидеть такое сообщение. Обычно это связано с обновлением модуля до следующей major версии. Тогда в модуле может быть прописан hook_update_last_removed, где прописан номер hook_update, ниже которого номерные ...

Читать

Делаем выгрузку xml для яндекс маркет

Сентябрь 23, 2023 г.

Ключевая особенность в том, что данные выгружаются из Drupal Commerce. Первое, что понадобится - это настроить какой то route, а потом мы напишем для него контроллер. Маршрут можно добавить в какой то кастомный модуль, выглядеть он может следующим ...

Читать

Как добавить поле "количество" для кнопки add to cart в Drupal Commerce

Июль 13, 2023 г.

Кнопка выводится как элемент product.variations, а вот настройки полей, которые выводятся в этой сущности довольно глубоко зарыты. [crayon-69aca5aae0cb5835201522/] Поле "кол-во товара в корзине" не является частью сущности product variation, ...

Читать

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

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

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