|
|
id3_set_tag (PECL) id3_set_tag -- Update information stored in an ID3 tag Описаниеbool id3_set_tag ( string filename, array tag [, int version] )
id3_set_tag() is used to change the information stored
of an ID3 tag. If no tag has been present, it will be added to the file.
Список параметров
filename
The path to the MP3 file
Instead of a filename you may also pass a valid stream resource
tag
An associative array of tag keys and values
The following keys may be used in the associative array:
Таблица 1. Keys in the associative array | key | possible value | available in version |
|---|
| title | string with maximum of 30 characters | v1.0, v1.1 | | artist | string with maximum of 30 characters | v1.0, v1.1 | | album | string with maximum of 30 characters | v1.0, v1.1 | | year | 4 digits | v1.0, v1.1 | | genre | integer value between 0 and 147 | v1.0, v1.1 | | comment | string with maximum of 30 characters (28 in v1.1) | v1.0, v1.1 | | track | integer between 0 and 255 | v1.1 |
version
Allows you to specify the version of the tag as MP3 files may contain
both, version 1.x and version 2.x tags
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Примеры
Пример 1. id3_set_tag() example |
<?php
$data = array(
"title" => "Re:Start",
"artist" => "Re:\Legion",
"comment" => "A nice track"
);
$result = id3_set_tag( "path/to/example.mp3", $data, ID3_V1_0 );
if ($result === true) {
echo "Tag succesfully updated\n";
}
?>
|
If the file is writable, this will output:
|
There are no user contributed notes for this page.
|