Руководство по PHP
Пред. |  | След.

# id3_set_tag

(PECL)

id3_set_tag -- Update information stored in an ID3 tag

## Description

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

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.

> Замечание: Instead of a filename you may also pass a valid stream resource.

The optional version parameter allows you to specify the version of the tag as MP3 files may contain both, version 1.x and version 2.x tags.

Пример 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 succesfully updated\n"; } ?>`

If the file is writable, this will output:

    Tag succesfully updated

> Замечание: Currently id3_set_tag() only supports version 1.0 and 1.1.

The following keys may be used in the associative array:

Таблица 1. 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

See also id3_get_tag(), id3_remove_tag() and id3_get_version().

Пред. | Начало | След.
id3_remove_tag | Уровень выше | IIS Administration Functions