This package is abandoned and no longer maintained. The author suggests using the pyrex-fwi/id3 package instead.

The package lays the basis for the simple manipulation of ID3 tags.You can define readers and writers to manipulate the metadata in read or write.

v1.0.0 2016-07-18 17:26 UTC

This package is not auto-updated.

Last update: 2022-02-01 12:53:52 UTC


README

Software License Build Status

The package lays the basis for the simple ID3 tags manipulation.

You can define readers and writers to manipulate the metadata in read or write.

Bin readers Available Mp3 read Mp3 write Mp4 read Mp4 write Flac read Flac write
Mediainfo no - no
EyeD3 - - - no
Id3v2 - - - no
metaflac no - - -

Usages

Read Id3 Tags

<?php

class MyClass
{

    public function readId3()
    {
        $mp3OrFlacFile = '/path/to/file';
        
        /** @var Sapar\Id3\Metadata\Id3MetadataInterface */
        $id3Metadata = new Sapar\Metadata\Id3Metadata($mp3OrFlacFile);
        
        /** @var Sapar\Wrapper\BinWrapper\BinWrapperInterface */
        $mediaInfoWrapper = new Sapar\Wrapper\BinWrapper\MediainfoWrapper();
        $mediaInfoWrapper->setBin('/usr/local/bin/mediainfo');
        
		if ($mediaInfoWrapper->read($metaDataFile)) {
			$metaDataFile->getTitle();
			$metaDataFile->getArtist();
			$metaDataFile->getAlbum();
			$metaDataFile->getGenre();
			$metaDataFile->getYear();
			$metaDataFile->getBpm();
			$metaDataFile->getTimeDuration();
		}
    }

}

Write Id3 Tags

<?php

class MyClass
{

    public function writeId3()
    {
        $mp3OrFlacFile = '/path/to/file';
        
        /** @var Sapar\Id3\Metadata\Id3MetadataInterface */
        $id3Metadata = new Sapar\Metadata\Id3Metadata($mp3OrFlacFile);
		$id3Metadata->setAlbum('album');
		$id3Metadata->setTitle('title');
		$id3Metadata->setGenre('genre');
		$id3Metadata->setYear(2016);
		$id3Metadata->setComment('comment');
		$id3Metadata->setBpm(120);
		
        /** @var Sapar\Wrapper\BinWrapper\BinWrapperInterface */
        $id3v2wrapper = new Sapar\Wrapper\BinWrapper\Id3v2Wrapper();
        $id3v2wrapper->setBin('/usr/local/bin/id3v2');
        
		if ($mediaInfoReader->write($metaDataFile)) {
			//it's done!
		}
    }

Create custom Wrapper

<?php

class MyClass
{

}

Tests

Make sure you have mediainfo available at location /usr/bin/mediainfo.

Make sure you have eyeD3 available at location /usr/local/bin/eyeD3

Bench: phpunit --group eyed3-read --repeat 100 phpunit --group mediainfo-read --repeat 100