# id3_set_tag

(PECL id3 >= 0.1)

id3_set_tag — Update information stored in an ID3 tag

### 说明

id3_set_tag ( string `$filename` , array `$tag` [, int `$version` = ID3_V1_0 ] ) : bool

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:

  Keys 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.

### 参见

- id3_remove_tag() - Remove an existing ID3 tag
- id3_get_tag() - Get all information stored in an ID3 tag
- id3_get_version() - Get version of an ID3 tag