PHP: id3_set_tag - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

IIS Functions id3_remove_tag

Last updated: Sat, 27 Jan 2007

view this page in

# id3_set_tag

(PECL)

id3_set_tag -- Update information stored in an ID3 tag

## Описание

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.

## Список параметров

`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:

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

`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` в случае возникновения ошибки.

## Примеры

Пример 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_remove_tag() only supports version 1.0 and 1.1.

## Смотрите также

id3_remove_tag()
id3_get_tag()
id3_get_version()

add a note User Contributed Notes
id3_set_tag
There are no user contributed notes for this page.
IIS Functions id3_remove_tag

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 09:32:46 2007 PST