Функция wp_read_audio_metadata() в WordPress с примерами

Функция wp_read_audio_metadata() предназначена для извлечения метаданных из аудиофайлов, включая данные ID3-тегов. Эта функция позволяет разработчикам получать важную информацию о аудиофайлах, такую как продолжительность, исполнителя, альбом и другие атрибуты.

wp_read_audio_metadata( string $file ): array|false

Параметры:

• $file (string) — обязательный параметр, который представляет собой путь к аудиофайлу на сервере.

Возвращаемое значение:

• array|false — Возвращает массив метаданных аудиофайла, если данные были успешно извлечены, или false, если возникла ошибка.

Как это работает

Функция читает метаданные из аудиофайлов, используя их ID3-теги, которые содержат информацию о формате, каналах, битрейте, размере, MIME-типа, продолжительности, исполнителе, альбоме и других параметрах. Важно помнить, что функция доступна только в админке WordPress, поэтому, если вам нужно использовать её на фронтенде, необходимо предварительно подключить соответствующий файл.

Пример 1: Получение продолжительности аудиофайла

В этом примере мы получим продолжительность аудиофайла в секундах. Сначала проверим, находимся ли мы в админке, и затем извлечем метаданные.

// Проверяем, находимся ли мы в админке
if ( ! is_admin() ) {
    require_once ABSPATH . 'wp-admin/includes/media.php'; // Подключаем медиа библиотеку
}

$file_path = wp_get_upload_dir()['basedir'] . '/2023/05/sample-audio.mp3'; // Путь к файлу

$metadata = wp_read_audio_metadata( $file_path );

if ( $metadata ) {
    echo 'Аудио длится ' . $metadata['length'] . ' секунд.'; // Выводим продолжительность
} else {
    echo 'Не удалось получить метаданные аудиофайла.';
}

Пример 2: Извлечение всех метаданных аудиофайла

Здесь мы получим все доступные метаданные аудиофайла и выведем их на экран.

// Проверяем, находимся ли мы в админке
if ( ! is_admin() ) {
    require_once ABSPATH . 'wp-admin/includes/media.php'; // Подключаем медиа библиотеку
}

$file_path = wp_get_upload_dir()['basedir'] . '/2023/05/sample-audio.mp3'; // Путь к файлу

$metadata = wp_read_audio_metadata( $file_path );

if ( $metadata ) {
    print_r( $metadata ); // Выводим все метаданные
} else {
    echo 'Не удалось получить метаданные аудиофайла.';
}

Пример 3: Проверка на наличие определенного значения

В этом примере мы проверим, доступен ли определенный параметр, такой как artist, в метаданных аудиофайла.

// Проверяем, находимся ли мы в админке
if ( ! is_admin() ) {
    require_once ABSPATH . 'wp-admin/includes/media.php'; // Подключаем медиа библиотеку
}

$file_path = wp_get_upload_dir()['basedir'] . '/2023/05/sample-audio.mp3'; // Путь к файлу

$metadata = wp_read_audio_metadata( $file_path );

if ( $metadata ) {
    if ( isset( $metadata['artist'] ) ) {
        echo 'Исполнитель: ' . $metadata['artist']; // Выводим имя исполнителя
    } else {
        echo 'Информация о исполнителе недоступна.';
    }
} else {
    echo 'Не удалось получить метаданные аудиофайла.';
}

Заключение

Функция wp_read_audio_metadata() является полезным инструментом для извлечения метаданных аудиофайлов в WordPress. С помощью этой функции разработчики могут легко получать информацию о своих медиафайлах и использовать её для различных целей, таких как отображение информации о треке или анализ данных.