©
This document uses PHP Chinese website manual Release
(PECL id3 >= 0.1)
id3_set_tag — Update information stored in an ID3 tag
$filename
, array $tag
[, int $version
= ID3_V1_0
] )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:
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
。
Example #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 successfully updated\n" ;
}
?>
If the file is writable, this will output:
Tag successfully updated
Note: Currently id3_set_tag() only supports version 1.0 and 1.1.