Class de tag id3v1 pour mp3 (lecture/écriture)

Télécharger le projet
Commenter

Description

Cette classe permet d'accéder facilement aux tags d'un fichier mp3 (pour peu qu'il soit taggé au format ID3v1 !) ce qui est encore pas mal le cas (ouf!)

Intérêt principaux:
- si vous avez un site de mp3, vous pourrez lire les infos et afficher une description complète
- dans le même cas, si vous permettez l'upload de mp3 par vos visiteurs, vous pourrez le tagger directement selon les infos que le visiteur envoit
- classer vos propres mp3 plus facilement (voir zip, si je l'ai pas oublié ^^)

Source / Exemple : 


<?
//Cette classe (ontact: nicolasboumal@hotmail.com), lit et édite les tags mp3 ID3v1
//note: à propos de ID3v1.1: il serait facile de rendre ce code compatible (http://www.id3.org/id3v1.html)
//mais j'ai jugé que c'était inutile. (boh oui quoi ^^)
//infos tableau de genres: http://www.egr.uri.edu/~kovacsp/mp3/ID3-Tag.html

class mp3
{
 var $vide = "-";	//chaine retournée en cas de fichier non tagé
 var $genres = array("Blues","Classic Rock","Country","Dance","Disco","Funk","Grunge", 
                     "Hip-Hop","Jazz","Metal","New Age","Oldies","Other","Pop","R&B", 
                     "Rap","Reggae","Rock","Techno","Industrial","Alternative","Ska", 
                     "Death Metal","Pranks","Soundtrack","Euro-Techno","Ambient", 
              		 "Trip-Hop","Vocal","Jazz+Funk","Fusion","Trance","Classical", 
                     "Instrumental","Acid","House","Game","Sound Clip","Gospel", 
                     "Noise","AlternRock","Bass","Soul","Punk","Space","Meditative", 
                     "Instrumental Pop","Instrumental Rock","Ethnic","Gothic", 
                     "Darkwave","Techno-Industrial","Electronic","Pop-Folk", 
                     "Eurodance","Dream","Southern Rock","Comedy","Cult","Gangsta", 
                     "Top 40","Christian Rap","Pop/Funk","Jungle","Native American", 
                     "Cabaret","New Wave","Psychadelic","Rave","Showtunes","Trailer", 
                     "Lo-Fi","Tribal","Acid Punk","Acid Jazz","Polka","Retro", 
                     "Musical","Rock & Roll","Hard Rock","Folk","Folk-Rock", 
                     "National Folk","Swing","Fast Fusion","Bebob","Latin","Revival", 
                     "Celtic","Bluegrass","Avantgarde","Gothic Rock","Progressive Rock", 
                     "Psychedelic Rock","Symphonic Rock","Slow Rock","Big Band", 
                     "Chorus","Easy Listening","Acoustic","Humour","Speech","Chanson", 
                     "Opera","Chamber Music","Sonata","Symphony","Booty Bass","Primus", 
                     "Porn Groove","Satire","Slow Jam","Club","Tango","Samba", 
                     "Folklore","Ballad","Power Ballad","Rhythmic Soul","Freestyle", 
                     "Duet","Punk Rock","Drum Solo","Acapella","Euro-House","Dance Hall");
				    //tableau des genres selon les spécifications ID3v1
					 
 // private:
 var $chaine;		//contient la chaîne de 128 bits finaux du fichier
 var $tagged;		//"booléen" qui spécifie si le fichier est taggé ou pas
 var $fic;			//contient le chemin vers le fichier
 
 //constructeur
 function mp3(){
 }
 
 //ouvre un fichier mp3
 function ouvre($fichier)
 {
  $f = @fopen($fichier, "rb");		 //ouvre le fichier en lecture seulement (sans erreur php) (la spécification binaire ne semble pas être obligatoire)
  if(!$f){							 //le fichier n'existe pas ou ne peut être ouvert
   $this->tagged = false;
   return false;
  }
  
  fseek($f, filesize($fichier)-128); //pointe le début du tag
  $this->chaine = fread($f, 128);	 //lit la chaîne de 128 octets
  
  //vérifie qu'il s'agit bien d'une chaîne de tag (3 premiers caract. = TAG)
  if(substr($this->chaine, 0, 3) != "TAG") $this->tagged = false;
  else									   $this->tagged = true;
  
  @fclose($f);
  //sauve le nom du fichier ouvert
  $this->fic = $fichier;
  return true;
 }
 
 //retourne le titre
 function titre()
 {
  if($this->tagged)
   return trim(substr($this->chaine, 3, 30));
  else
   return $this->vide;
 }
 
 //retourne le nom de l'artiste
 function artiste()
 {
  if($this->tagged)
   return trim(substr($this->chaine, 33, 30));
  else
   return $this->vide;
 }
 
 //retourne le nom de l'album
 function album()
 {
  if($this->tagged)
   return trim(substr($this->chaine, 63, 30));
  else
   return $this->vide;
 }
 
 //retourne l'année
 function annee()
 {
  if($this->tagged)
   return trim(substr($this->chaine, 93, 4));
  else
   return $this->vide;
 }
 
 //retourne le commentaire
 function commentaire()
 {
  if($this->tagged)
   return trim(substr($this->chaine, 97, 30));
  else
   return $this->vide;
 }
 
 //retourne le genre
 function genre()
 {
  if($this->tagged)
   return $this->genres[ord(substr($this->chaine, 127, 1))]; //ord() retourne le code ascii d'un caract. (inverse de chr())
  else
   return $this->vide;
 }
 
 //tag un fichier (ajoute une chaîne de 128 bits à la fin commençant par TAG et fournie avec des \0
 //les tags sont vides mais les emplacements réservés
 function tagit()
 {
  //préparatifs: ouverture du fichier
  $f = @fopen($this->fic, "r+b");
  if(!$f) return false;
 
  fseek($f, filesize($this->fic)); //place à la fin
  //note: pas 128 caract, car le dernier déclarerait blues comme genre (0), or ce n'est pas forcément le cas
  //le 128ème est la valeur 255 (comme ça, aucun genre associé)
  $ch = "TAG";
  $null = chr(0); //évite de lancer 124 fois la même fct
  for($i=0; $i<124; $i++) $ch .= $null;
  $ch .= chr(255);
  fputs($f, $ch);

  fclose($f);
  $this->ouvre($this->fic); //met à jour
 }
 
 //modifie la valeur du tag selon deux paramètres (tag, valeur)
 function set($tag, $val)
 {
  //préparatifs: ouverture du fichier
  $f = @fopen($this->fic, "r+b");
  if(!$f) return false;
  
  //si pas taggé -> tag ! ^^
  if(!$this->tagged)
   if(!$this->tagit()) return false;
  
  $lg = strlen($val);
 
  if($tag == "titre"){
   //note: si la valeur est trop grande, elle sera coupée
   //complète la valeur avec des \0 (caract. null) puis l'écrit dans le fichier au bon endroit
   //attention! '\0' ne donne pas un bon résultat! il faut "\0" (va savoir! -_-)
   for($i=0; $i<30-$lg; $i++) $val .= "\0";
   fseek($f, filesize($this->fic) - 128 + 3);
   fputs($f, $val, 30); //précision du 30 par sécurité
   fclose($f);
   $this->ouvre($this->fic); //mise à jour
   return true;
  }
  elseif($tag == "artiste"){
   for($i=0; $i<30-$lg; $i++) $val .= "\0";
   fseek($f, filesize($this->fic) - 128 + 33);
   fputs($f, $val, 30);
   fclose($f);
   $this->ouvre($this->fic);
   return true;
  }
  elseif($tag == "album"){
   for($i=0; $i<30-$lg; $i++) $val .= "\0";
   fseek($f, filesize($this->fic) - 128 + 63);
   fputs($f, $val, 30);
   fclose($f);
   $this->ouvre($this->fic);
   return true;  
  }
  elseif($tag == "année"){
   for($i=0; $i<4-$lg; $i++) $val .= "\0";
   fseek($f, filesize($this->fic) - 128 + 93);
   fputs($f, $val, 4);
   fclose($f);
   $this->ouvre($this->fic);
   return true;    
  }
  elseif($tag == "commentaire"){
   for($i=0; $i<30-$lg; $i++) $val .= "\0";
   fseek($f, filesize($this->fic) - 128 + 97);
   fputs($f, $val, 30);
   fclose($f);
   $this->ouvre($this->fic);
   return true;    
  }
  elseif($tag == "genre"){
   fseek($f, filesize($this->fic) - 1);
   fputs($f, chr($val), 1);	//chr() retourne la valeure caractère pr un nombre ascii
   fclose($f);
   $this->ouvre($this->fic);
   return true;      
  }
  else
   return false;
 }
 
 //lance la fonction selon le paramètre (ansi, si la l'info à récupérée est contenue dans une variable, on la passe ici)
 function get($tag)
 {
      if($tag == "titre") 		return $this->titre;
  elseif($tag == "artiste") 	return $this->artiste;
  elseif($tag == "album") 		return $this->album;
  elseif($tag == "année") 		return $this->annee;
  elseif($tag == "commentaire") return $this->commentaire;
  elseif($tag == "genre") 		return $this->genre;
  else 							return false;
 }
}
?>

Conclusion :


exemples d'utilisation (en plus de ceux du zip):

include("class.mp3.php");

$zic = new mp3();
$zic->ouvre("musique/monhit.mp3");

lecture:
echo $zic->titre();

écriture:
$zic->set("titre", "Mon Hit");

notez: dans le zip, il y a des scripts (pas des plus propres ^^) qui illustrent une utilisation plus élaborée. (documentée)
Télécharger le projet

Codes Sources

A voir également

S'inscrire maintenant

Vous n'êtes pas encore membre ?

inscrivez-vous, c'est gratuit et ça prend moins d'une minute !

Les membres obtiennent plus de réponses que les utilisateurs anonymes.

Le fait d'être membre vous permet d'avoir un suivi détaillé de vos demandes et codes sources.

Le fait d'être membre vous permet d'avoir des options supplémentaires.

Du même auteur (cs_Kirua)