getid3_write_vorbiscomment Class Reference

getID3() by James Heinrich info@.nosp@m.geti.nosp@m.d3.or.nosp@m.g // More...

Collaboration diagram for getid3_write_vorbiscomment:

Public Member Functions
	__construct ()
	WriteVorbisComment ()
	DeleteVorbisComment ()
	CleanVorbisCommentName ($originalcommentname)

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

Detailed Description

getID3() by James Heinrich info@.nosp@m.geti.nosp@m.d3.or.nosp@m.g //

Definition at line 18 of file write.vorbiscomment.php.

Constructor & Destructor Documentation

__construct()

getid3_write_vorbiscomment::__construct

(

)

Definition at line 26 of file write.vorbiscomment.php.

                                      {
                return true;
        }

Member Function Documentation

CleanVorbisCommentName()

getid3_write_vorbiscomment::CleanVorbisCommentName

(

$originalcommentname

)

Definition at line 108 of file write.vorbiscomment.php.

                                                                     {
                // 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: *reg_replace() replaces nulls with empty string (not space)
                return strtoupper(preg_replace('#[^ -<>-}]#', ' ', str_replace("\x00", ' ', $originalcommentname)));
 
        }

Referenced by WriteVorbisComment().

Here is the caller graph for this function:

DeleteVorbisComment()

getid3_write_vorbiscomment::DeleteVorbisComment

(

)

Definition at line 103 of file write.vorbiscomment.php.

                                              {
                $this->tag_data = array(array());
                return $this->WriteVorbisComment();
        }

References WriteVorbisComment().

Here is the call graph for this function:

WriteVorbisComment()

getid3_write_vorbiscomment::WriteVorbisComment

(

)

Definition at line 30 of file write.vorbiscomment.php.

                                             {
 
                if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
                        $this->errors[] = 'PHP running in Safe Mode (backtick operator not available) - cannot call vorbiscomment, tags not written';
                        return false;
                }
 
                // Create file with new comments
                $tempcommentsfilename = tempnam(GETID3_TEMP_DIR, 'getID3');
                if (is_writable($tempcommentsfilename) && is_file($tempcommentsfilename) && ($fpcomments = fopen($tempcommentsfilename, 'wb'))) {
 
                        foreach ($this->tag_data as $key => $value) {
                                foreach ($value as $commentdata) {
                                        fwrite($fpcomments, $this->CleanVorbisCommentName($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.'vorbiscomment.exe')) {
                                //$commandline = '"'.GETID3_HELPERAPPSDIR.'vorbiscomment.exe" -w --raw -c "'.$tempcommentsfilename.'" "'.str_replace('/', '\\', $this->filename).'"';
                                //  vorbiscomment 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.'vorbiscomment.exe -w --raw -c "'.$tempcommentsfilename.'" "'.$this->filename.'" 2>&1';
                                $VorbiscommentError = `$commandline`;
 
                                if (empty($VorbiscommentError)) {
                                        clearstatcache();
                                        if ($timestampbeforewriting == filemtime($this->filename)) {
                                                $VorbiscommentError = 'File modification timestamp has not changed - it looks like the tags were not written';
                                        }
                                }
                        } else {
                                $VorbiscommentError = 'vorbiscomment.exe not found in '.GETID3_HELPERAPPSDIR;
                        }
 
                } else {
 
                        $commandline = 'vorbiscomment -w --raw -c "'.$tempcommentsfilename.'" "'.$this->filename.'" 2>&1';
                        $VorbiscommentError = `$commandline`;
 
                }
 
                // Remove temporary comments file
                unlink($tempcommentsfilename);
                ignore_user_abort($oldignoreuserabort);
 
                if (!empty($VorbiscommentError)) {
 
                        $this->errors[] = 'system call to vorbiscomment failed with message: '."\n\n".$VorbiscommentError;
                        return false;
 
                }
 
                return true;
        }

References $key, and CleanVorbisCommentName().

Referenced by DeleteVorbisComment().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$errors

getid3_write_vorbiscomment::$errors = array()

Definition at line 24 of file write.vorbiscomment.php.

$filename

getid3_write_vorbiscomment::$filename

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

$tag_data

getid3_write_vorbiscomment::$tag_data

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

$warnings

getid3_write_vorbiscomment::$warnings = array()

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

---

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

• libs/composer/vendor/james-heinrich/getid3/getid3/write.vorbiscomment.php