id3_get_version(3) [php man page]

ID3_GET_VERSION(3)							 1							ID3_GET_VERSION(3)

id3_get_version - Get version of an ID3 tag

SYNOPSIS

       int id3_get_version (string  $filename)

DESCRIPTION

       id3_get_version(3) retrieves the version(s) of the ID3 tag(s) in the MP3 file.

	If a file contains an ID3 v1.1 tag, it always contains a 1.0 tag, as version 1.1 is just an extension of 1.0.

PARAMETERS

	      o $filename
		- The path to the MP3 file  Instead of a filename you may also pass a valid stream resource

RETURN VALUES

	Returns  the  version  number  of  the ID3 tag of the file. As a tag can contain ID3 v1.x and v2.x tags, the return value of this function
       should be bitwise compared with the predefined constants ID3_V1_0, ID3_V1_1 and ID3_V2.

EXAMPLES

       Example #1

	      id3_get_version(3) example

	      <?php
	      $version = id3_get_version( "path/to/example.mp3" );
	      if ($version & ID3_V1_0) {
		  echo "Contains a 1.x tag
";
	      }
	      if ($version & ID3_V1_1) {
		  echo "Contains a 1.1 tag
";
	      }
	      if ($version & ID3_V2) {
		  echo "Contains a 2.x tag
";
	      }
	      ?>

	      The above example will output something similar to:

	      Contains a 1.x tag
	      Contains a 1.1 tag

SEE ALSO

       id3_set_tag(3), id3_get_tag(3), id3_remove_tag(3).

PHP Documentation Group 													ID3_GET_VERSION(3)

ID3_GET_TAG(3)								 1							    ID3_GET_TAG(3)

id3_get_tag - Get all information stored in an ID3 tag

SYNOPSIS

       array id3_get_tag (string  $filename, [int  $version = ID3_BEST])

DESCRIPTION

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

PARAMETERS

	      o $filename
		- The path to the MP3 file  Instead of a filename you may also pass a valid stream resource

	      o $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(3) also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one  of  the  con-
		stants 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.

RETURN VALUES

	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(3) to convert it to a human readable string.

EXAMPLES

       Example #1

	      id3_get_tag(3) example

	      <?php
	      $tag = id3_get_tag( "path/to/example.mp3" );
	      print_r($tag);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [title] => DN-38416
		  [artist] => Re:Legion
		  [album] => Reflections
		  [year] => 2004
		  [genre] => 19
	      )

       Example #2

	      id3_get_tag(3) example

	      <?php
	      $tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 );
	      print_r($tag);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [copyright] => Dirty Mac
		  [originalArtist] => Dirty Mac
		  [composer] => Marcus Gotze
		  [artist] => Dirty Mac
		  [title] => Little Big Man
		  [album] => Demo-Tape
		  [track] => 5/12
		  [genre] => (17)Rock
		  [year] => 2001
	      )

SEE ALSO

       id3_set_tag(3), id3_remove_tag(3), id3_get_version(3).

PHP Documentation Group 													    ID3_GET_TAG(3)