Web aym.pekori.to

id3_set_tag

(PECL)

id3_set_tag -- ID3 タグに格納されている情報を更新する

説明

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

id3_set_tag() は、ID3 タグに格納されている情報を 変更するために使用されます。タグが存在しない場合は、新たに追加されます。

注意: ファイル名のかわりに、ストリームリソースを渡すことも可能です。

MP3 ファイルがバージョン 1.x およびバージョン 2.x の両方のタグを 含んでいる場合は、オプションのパラメータ version を用いてタグのバージョンを指定することが可能となります。

例 1. id3_set_tag() の例

<?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
"タグが正常に更新されました\n";
}
?>

ファイルが書き込み可能な場合、 この例の出力は次のようになります。

タグが正常に更新されました

注意: 現時点では id3_set_tag() がサポートしているのは バージョン 1.0 および 1.1 のみです。

連想配列の中で使用できるキーは以下のようになります。

表 1. 連想配列内のキー

キーとりうる値使用可能なバージョン
title最大 30 文字までの文字列v1.0, v1.1
artist最大 30 文字までの文字列v1.0, v1.1
album最大 30 文字までの文字列v1.0, v1.1
year4 桁の数値v1.0, v1.1
genre0 から 147 までの整数値v1.0, v1.1
comment最大 30 文字 (v1.1 では 28 文字) までの文字列v1.0, v1.1
track0 から 255 までの整数値v1.1

id3_get_tag()id3_remove_tag() および id3_get_version() も参照ください。