Транслитерация имени файла при создании медиа 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_get_path() в Drupal 9/10

Январь 9, 2024 г.

Функция считается устаревшей, начиная с версии ядра 9.3, в 10-й версии функция удалена из кода. В новом API нужно воспользоваться одним из сервисов ядра, которые реализуют нужную функцию. Сервис extension.list.module - реализует функции, связанные ...

Читать

Настройка редиректов в Drupal

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

Речь пойдет о модуле redirect, который, несмотря на свои простые функции, не всегда понятен редакторам сайта. После установки модуля, на сайте появляется ...

Читать

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

Май 16, 2024 г.

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

Читать

Как полностью удалить поле в Drupal, если оно «зависло» в хранилище полей

Сентябрь 5, 2025 г.

Иногда в Drupal возникает ситуация: вы удаляете поле с типов сущностей (bundle), но оно не исчезает полностью из системы. UI говорит, что поле «используется», хотя на самом деле ни одна сущность его не использует. В этом случае поле остаётся в конфигурации ...

Читать

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

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

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