PHP マニュアル
前のページ |  | 次のページ

# 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 Gze
        [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() も参照ください。

前のページ | ホーム | 次のページ
id3_get_genre_name | 上に戻る | id3_get_version