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

# 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
year | 4 桁の数値 | v1.0, v1.1
genre | 0 から 147 までの整数値 | v1.0, v1.1
comment | 最大 30 文字 (v1.1 では 28 文字) までの文字列 | v1.0, v1.1
track | 0 から 255 までの整数値 | v1.1

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

前のページ | ホーム | 次のページ
id3_remove_tag | 上に戻る | IIS 管理関数