Public Member Functions | Data Fields

getid3_write_metaflac Class Reference

getID3() by James Heinrich <info@getid3.org> // More...

Public Member Functions

 getid3_write_metaflac ()
 WriteMetaFLAC ()
 DeleteMetaFLAC ()
 CleanmetaflacName ($originalcommentname)

Data Fields

 $filename
 $tag_data
 $warnings = array()
 $errors = array()

Detailed Description

getID3() by James Heinrich <info@getid3.org> //

Definition at line 17 of file write.metaflac.php.


Member Function Documentation

getid3_write_metaflac::CleanmetaflacName ( originalcommentname  ) 

Definition at line 153 of file write.metaflac.php.

Referenced by WriteMetaFLAC().

                                                         {
                // A case-insensitive field name that may consist of ASCII 0x20 through 0x7D, 0x3D ('=') excluded.
                // ASCII 0x41 through 0x5A inclusive (A-Z) is to be considered equivalent to ASCII 0x61 through
                // 0x7A inclusive (a-z).

                // replace invalid chars with a space, return uppercase text
                // Thanks Chris Bolt <chris-getid3Øbolt*cx> for improving this function
                // note: ereg_replace() replaces nulls with empty string (not space)
                return strtoupper(ereg_replace('[^ -<>-}]', ' ', str_replace("\x00", ' ', $originalcommentname)));

        }

Here is the caller graph for this function:

getid3_write_metaflac::DeleteMetaFLAC (  ) 

Definition at line 107 of file write.metaflac.php.

                                  {

                if (!ini_get('safe_mode')) {

                        $oldignoreuserabort = ignore_user_abort(true);
                        if (GETID3_OS_ISWINDOWS) {

                                if (file_exists(GETID3_HELPERAPPSDIR.'metaflac.exe')) {
                                        // To at least see if there was a problem, compare file modification timestamps before and after writing
                                        clearstatcache();
                                        $timestampbeforewriting = filemtime($this->filename);

                                        $commandline = GETID3_HELPERAPPSDIR.'metaflac.exe --remove-vc-all "'.$this->filename.'" 2>&1';
                                        $metaflacError = `$commandline`;

                                        if (empty($metaflacError)) {
                                                clearstatcache();
                                                if ($timestampbeforewriting == filemtime($this->filename)) {
                                                        $metaflacError = 'File modification timestamp has not changed - it looks like the tags were not deleted';
                                                }
                                        }
                                } else {
                                        $metaflacError = 'metaflac.exe not found in '.GETID3_HELPERAPPSDIR;
                                }

                        } else {

                                // It's simpler on *nix
                                $commandline = 'metaflac --remove-vc-all "'.$this->filename.'" 2>&1';
                                $metaflacError = `$commandline`;

                        }

                        ignore_user_abort($oldignoreuserabort);

                        if (!empty($metaflacError)) {
                                $this->errors[] = 'System call to metaflac failed with this message returned: '."\n\n".$metaflacError;
                                return false;
                        }
                        return true;
                }
                $this->errors[] = 'PHP running in Safe Mode (backtick operator not available) - cannot call metaflac, tags not deleted';
                return false;
        }

getid3_write_metaflac::getid3_write_metaflac (  ) 

Definition at line 25 of file write.metaflac.php.

                                         {
                return true;
        }

getid3_write_metaflac::WriteMetaFLAC (  ) 

Definition at line 29 of file write.metaflac.php.

References CleanmetaflacName().

                                 {

                if (!ini_get('safe_mode')) {

                        // Create file with new comments
                        $tempcommentsfilename = tempnam('*', 'getID3');
                        if ($fpcomments = @fopen($tempcommentsfilename, 'wb')) {

                                foreach ($this->tag_data as $key => $value) {
                                        foreach ($value as $commentdata) {
                                                fwrite($fpcomments, $this->CleanmetaflacName($key).'='.$commentdata."\n");
                                        }
                                }
                                fclose($fpcomments);

                        } else {

                                $this->errors[] = 'failed to open temporary tags file "'.$tempcommentsfilename.'", tags not written';
                                return false;

                        }

                        $oldignoreuserabort = ignore_user_abort(true);
                        if (GETID3_OS_ISWINDOWS) {

                                if (file_exists(GETID3_HELPERAPPSDIR.'metaflac.exe')) {
                                        //$commandline = '"'.GETID3_HELPERAPPSDIR.'metaflac.exe" --no-utf8-convert --remove-vc-all --import-vc-from="'.$tempcommentsfilename.'" "'.str_replace('/', '\\', $this->filename).'"';
                                        //  metaflac works fine if you copy-paste the above commandline into a command prompt,
                                        //  but refuses to work with `backtick` if there are "doublequotes" present around BOTH
                                        //  the metaflac pathname and the target filename. For whatever reason...??
                                        //  The solution is simply ensure that the metaflac pathname has no spaces,
                                        //  and therefore does not need to be quoted

                                        // On top of that, if error messages are not always captured properly under Windows
                                        // To at least see if there was a problem, compare file modification timestamps before and after writing
                                        clearstatcache();
                                        $timestampbeforewriting = filemtime($this->filename);

                                        $commandline = GETID3_HELPERAPPSDIR.'metaflac.exe --no-utf8-convert --remove-vc-all --import-vc-from="'.$tempcommentsfilename.'" "'.$this->filename.'" 2>&1';
                                        $metaflacError = `$commandline`;

                                        if (empty($metaflacError)) {
                                                clearstatcache();
                                                if ($timestampbeforewriting == filemtime($this->filename)) {
                                                        $metaflacError = 'File modification timestamp has not changed - it looks like the tags were not written';
                                                }
                                        }
                                } else {
                                        $metaflacError = 'metaflac.exe not found in '.GETID3_HELPERAPPSDIR;
                                }

                        } else {

                                // It's simpler on *nix
                                $commandline = 'metaflac --no-utf8-convert --remove-vc-all --import-vc-from='.$tempcommentsfilename.' "'.$this->filename.'" 2>&1';
                                $metaflacError = `$commandline`;

                        }

                        // Remove temporary comments file
                        unlink($tempcommentsfilename);
                        ignore_user_abort($oldignoreuserabort);

                        if (!empty($metaflacError)) {

                                $this->errors[] = 'System call to metaflac failed with this message returned: '."\n\n".$metaflacError;
                                return false;

                        }

                        return true;
                }

                $this->errors[] = 'PHP running in Safe Mode (backtick operator not available) - cannot call metaflac, tags not written';
                return false;
        }

Here is the call graph for this function:


Field Documentation

getid3_write_metaflac::$errors = array()

Definition at line 23 of file write.metaflac.php.

getid3_write_metaflac::$filename

Definition at line 20 of file write.metaflac.php.

getid3_write_metaflac::$tag_data

Definition at line 21 of file write.metaflac.php.

getid3_write_metaflac::$warnings = array()

Definition at line 22 of file write.metaflac.php.


The documentation for this class was generated from the following file: