PHP: id3_get_tag - Manual

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

search for in the

id3_get_version id3_get_genre_name

Last updated: Sat, 27 Jan 2007

view this page in

# id3_get_tag

(PECL)

id3_get_tag -- Get all information stored in an ID3 tag

## Описание

array id3_get_tag ( string filename [, int version] )

id3_get_tag() is used to get all information stored in the id3 tag of the specified file.

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

`filename`

  The path to the MP3 file

  Instead of a filename you may also pass a valid stream resource

`version`

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

  Since version 0.2 id3_get_tag() also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one of the constants ID3_V2_2, ID3_V2_3 or ID3_V2_4 as the second parameter. ID3 v2.x tags can contain a lot more information about the MP3 file than ID3 v1.x tags.

## Возвращаемые значения

Returns an associative array with various keys like: `title`, `artist`, ..

The key `genre` will contain an integer between 0 and 147. You may use id3_get_genre_name() to convert it to a human readable string.

## Примеры

Пример 1. id3_get_tag() example

`<?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
    )

Пример 2. id3_get_tag() example

`<?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ötze
        [artist] => Dirty Mac
        [title] => Little Big Man
        [album] => Demo-Tape
        [track] => 5/12
        [genre] => (17)Rock
        [year] => 2001
    )

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

id3_set_tag()
id3_remove_tag()
id3_get_version()

add a note User Contributed Notes
id3_get_tag
jbwalker at telus dot net
06-Nov-2006 06:25
`I couldn't get this to work in Windows XP. Windows users may be interested to note that the following bug with Windows, reported in Feb 2006, appears not to have been fixed yet.
http://pecl.php.net/bugs/search.php?
cmd=display&status=Open&package_name[]=id3
(NB you'll have to concat the two lines above)`
add a note
id3_get_version id3_get_genre_name

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