id3_get_tag
(PECL)
id3_get_tag -- ID3 タグに含まれるすべての情報を取得する
説明
array
id3_get_tag ( string filename [, int version] )
id3_get_tag() は、指定したファイルの ID3 タグに
含まれるすべての情報を取得するために使用されます。
注意: ファイル名のかわりに、ストリームリソースを渡すことも可能です。
MP3 ファイルがバージョン 1.x およびバージョン 2.x の両方のタグを
含んでいる場合は、オプションのパラメータ version
を用いてタグのバージョンを指定することが可能となります。
例 1. id3_get_tag() の例
<?php $tag = id3_get_tag( "path/to/example.mp3" ); print_r($tag); ?>
|
この例の出力は次のようになります。
Array
(
[title] => DN-38416
[artist] => Re:\Legion
[album] => Reflections
[year] => 2004
[genre] => 19
) |
|
genre には 0 から 147 までの整数値が格納されています。
id3_get_genre_name() を使用することで、
この数値をジャンル名に変換することが可能です。
バージョン 0.2 以降、id3_get_tag() は
ID3 タグのバージョン 2.2、2.3 および 2.4 にも対応するようになりました。
これらのタグに関する情報を取得するには、2 番目の引数に
ID3_V2_2、ID3_V2_3 あるいは ID3_V2_4 のいずれかの定数を指定します。
例 2. id3_get_tag() の例
<?php $tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 ); print_r($tag); ?>
|
この例の出力は次のようになります。
Array
(
[copyright] => Dirty Mac
[originalArtist] => Dirty Mac
[composer] => Marcus Gze
[artist] => Dirty Mac
[title] => Little Big Man
[album] => Demo-Tape
[track] => 5/12
[genre] => (17)Rock
[year] => 2001
) |
|
ID3 v2.x タグは、ID3 v1.x タグに比べてはるかに多くの情報を
MP3 ファイルに含めることが可能です。
id3_set_tag()、
id3_remove_tag() および
id3_get_version() も参照ください。