id3_set_tag
(PECL id3 >= 0.1)
id3_set_tag — Обновляет информацию в ID3 теге
Описание
$filename
, array $tag
[, int $version = ID3_V1_0
] ) : boolid3_set_tag() используется для изменения информации, сохранённой в теге ID3. Если тег отсутствует, он будет добавлен в файл.
Список параметров
-
filename -
Путь к файлу MP3
Вместо имени файла можно передать потоковый ресурс
-
tag -
Ассоциативный массив ключей и значений тега.
Следующие ключи могут быть использованы в ассоциативном массиве:
Ключи в ассоциативном массиве ключ возможные значения доступен с версии title строка длиной максимум 30 символов v1.0, v1.1 artist строка длиной максимум 30 символов v1.0, v1.1 album строка длиной максимум 30 символов v1.0, v1.1 year 4 цифры v1.0, v1.1 genre число в интервале от 0 до 147 v1.0, v1.1 comment строка длиной максимум 30 символов (30 в v1.1) v1.0, v1.1 track целое число в интервале от 0 до 255 v1.1 -
version -
Позволяет определять версию тега ID3, так как MP3-файл может содержать теги версии 1.х и 1.2.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Примеры
Пример #1 Пример использования id3_set_tag()
<?php
$data = array(
"title" => "Re:Начало",
"artist" => "Re:\Легион",
"comment" => "Прекрасный трек"
);
$result = id3_set_tag( "path/to/example.mp3", $data, ID3_V1_0 );
if ($result === true) {
echo "Тег успешно обновлен\n";
}
?>
Если файл доступен для записи и содержит тег версии 1.0, то вывод будет следующим:
Тег успешно обновлен
Примечания
Замечание: В настоящее время функция id3_set_tag() поддерживает только версию 1.0 и 1.1.
Смотрите также
- id3_remove_tag() - Удаляет существующий ID3-тег
- id3_get_tag() - Возвращает всю информацию, сохранённую в ID3-теге
- id3_get_version() - Возвращает версию ID3-тега