Наша группа в телеграмм для обмена идеями, проектами, мыслями, людьми в сфере ИТ г.Ростова-на-Дону: @it_rostov

id3_set_tag

(PECL id3 >= 0.1)

id3_set_tag — Обновляет информацию в ID3 теге


Описание

bool id3_set_tag ( string $filename , array $tag [, int $version = ID3_V1_0 ] )

id3_set_tag() используется для изменения информации, сохранённой в ID3 теге. Если тег отстутствует, он будет добавлен в файл.


Список параметров

filename -

Путь к MP3 файлу

Вместо имени файла можно передать потоковый ресурс

tag -

Ассоциативный массив ключей и значений тега.

Следующие ключи могут быть использованы в ассоциативном массиве:

Ключи в ассоциативном массиве
ключ возможные значения доступен с версии
titleстрока длиной максимум 30 символовv1.0, v1.1
artistстрока длиной максимум 30 символовv1.0, v1.1
albumстрока длиной максимум 30 символовv1.0, v1.1
year4 цифрыv1.0, v1.1
genreчисло в интервале от 0 до 147v1.0, v1.1
commentстрока длиной максимум 30 символов (30 в v1.1)v1.0, v1.1
trackцелое число в интервале от 0 до 255v1.1

version -

Позволяет определять версию ID3 тега, так как MP3 файл может содержать теги версии 1.х и 1.2.


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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.


Примеры

Пример #1 Пример использования id3_set_tag()
$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-тега


Описание на ru2.php.net
Описание на php.ru

.

Популярное:


Содержание: