id3_get_tag
(PECL id3 >= 0.1)
id3_get_tag — Возвращает всю информацию, сохранённую в ID3-теге
Описание
$filename
[, int $version
= ID3_BEST
] ) : arrayid3_get_tag() используется для получения всей информации, хранящейся в ID3-теге данного файла.
Список параметров
-
filename
-
Путь к MP3-файлу
Вместо имени файла можно передать потоковый ресурс
-
version
-
Позволяет определять версию ID3-тега, так как MP3-файл может содержать теги версии 1.х и 1.2.
Начиная с версии 0.2 id3_get_tag() также поддерживает ID3-теги версии 2.2, 2.3 и 2.4. Для извлечения информации из этих тегов, передайте одну из констант ID3_V2_2, ID3_V2_3 или ID3_V2_4 вторым параметром. Теги ID3 версии 2.х могут содержать больше информации об MP3-файле, чем теги версии 1.х.
Возвращаемые значения
Возвращает ассоциативный массив с различными ключами: title, artist, ..
Ключ genre содержит число в интервале от 0 до 147. Вы можете использовать функцию id3_get_genre_name() для получения текстового названия жанра.
Примеры
Пример #1 Пример использования id3_get_tag()
<?php
$tag = id3_get_tag( "path/to/example.mp3" );
print_r($tag);
?>
Результатом выполнения данного примера будет что-то подобное:
Array ( [title] => DN-38416 [artist] => Re:\Legion [album] => Reflections [year] => 2004 [genre] => 19 )
Пример #2 Пример использования id3_get_tag()
<?php
$tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 );
print_r($tag);
?>
Результатом выполнения данного примера будет что-то подобное:
Array ( [copyright] => Dirty Mac [originalArtist] => Dirty Mac [composer] => Marcus Götze [artist] => Dirty Mac [title] => Little Big Man [album] => Demo-Tape [track] => 5/12 [genre] => (17)Rock [year] => 2001 )
Смотрите также
- id3_set_tag() - Обновляет информацию в ID3 теге
- id3_remove_tag() - Удаляет существующий ID3-тег
- id3_get_version() - Возвращает версию ID3-тега