get_meta_tags(3) [php man page]

GET_META_TAGS(3)							 1							  GET_META_TAGS(3)

get_meta_tags - Extracts all meta tag content attributes from a file and returns an array

SYNOPSIS

       array get_meta_tags (string  $filename, [bool  $use_include_path = false])

DESCRIPTION

	Opens $filename and parses it line by line for <meta> tags in the file. The parsing stops at </head>.

PARAMETERS

	      o $filename
		- The path to the HTML file, as a string. This can be a local file or an URL.

	      Example #1

		     What get_meta_tags(3) parses

		     <meta name="author" content="name">
		     <meta name="keywords" content="php documentation">
		     <meta name="DESCRIPTION" content="a php manual">
		     <meta name="geo.position" content="49.33;-86.59">
		     </head> <!-- parsing stops here -->
	       (pay attention to line endings - PHP uses a native function to parse the input, so a Mac file won't work on Unix).

	      o $use_include_path
		-  Setting  $use_include_path  to  TRUE  will  result  in  PHP	trying to open the file along the standard include path as per the
		include_path directive. This is used for local files, not URLs.

RETURN VALUES

	Returns an array with all the parsed meta tags.

	The value of the name property becomes the key, the value of the content property becomes the value of the returned array, so you can eas-
       ily  use  standard array functions to traverse it or access single values. Special characters in the value of the name property are substi-
       tuted with '_', the rest is converted to lower case. If two meta tags have the same name, only the last one is returned.

EXAMPLES

       Example #2

	      What get_meta_tags(3) returns

	      <?php
	      // Assuming the above tags are at www.example.com
	      $tags = get_meta_tags('http://www.example.com/');

	      // Notice how the keys are all lowercase now, and
	      // how . was replaced by _ in the key.
	      echo $tags['author'];	  // name
	      echo $tags['keywords'];	  // php documentation
	      echo $tags['description'];  // a php manual
	      echo $tags['geo_position']; // 49.33;-86.59
	      ?>

NOTES

       Note

	       Only meta tags with name attributes will be parsed. Quotes are not required.

SEE ALSO

       htmlentities(3), urlencode(3).

PHP Documentation Group 													  GET_META_TAGS(3)

ID3_SET_TAG(3)								 1							    ID3_SET_TAG(3)

id3_set_tag - Update information stored in an ID3 tag

SYNOPSIS

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

DESCRIPTION

       id3_set_tag(3) is used to change the information stored of an ID3 tag. If no tag has been present, it will be added to the file.

PARAMETERS

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

	      o $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		      |   |
	      |        |				      |   |
	      +--------+--------------------------------------+---+
	      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

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      id3_set_tag(3) 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
";
	      }
	      ?>

	       If the file is writable, this will output:

	      Tag successfully updated

NOTES

       Note

	       Currently id3_set_tag(3) only supports version 1.0 and 1.1.

SEE ALSO

       id3_remove_tag(3), id3_get_tag(3), id3_get_version(3).

PHP Documentation Group 													    ID3_SET_TAG(3)