ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
Public Member Functions | Data Fields
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.

26  {
27  return true;
28  }

Member Function Documentation

◆ CleanVorbisCommentName()

getid3_write_vorbiscomment::CleanVorbisCommentName (   $originalcommentname)

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

Referenced by WriteVorbisComment().

108  {
109  // A case-insensitive field name that may consist of ASCII 0x20 through 0x7D, 0x3D ('=') excluded.
110  // ASCII 0x41 through 0x5A inclusive (A-Z) is to be considered equivalent to ASCII 0x61 through
111  // 0x7A inclusive (a-z).
112 
113  // replace invalid chars with a space, return uppercase text
114  // Thanks Chris Bolt <chris-getid3Øbolt*cx> for improving this function
115  // note: *reg_replace() replaces nulls with empty string (not space)
116  return strtoupper(preg_replace('#[^ -<>-}]#', ' ', str_replace("\x00", ' ', $originalcommentname)));
117 
118  }
+ Here is the caller graph for this function:

◆ DeleteVorbisComment()

getid3_write_vorbiscomment::DeleteVorbisComment ( )

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

References array, and WriteVorbisComment().

103  {
104  $this->tag_data = array(array());
105  return $this->WriteVorbisComment();
106  }
getid3_write_vorbiscomment\WriteVorbisComment
WriteVorbisComment()
Definition: write.vorbiscomment.php:30
array
Create styles array
The data for the language used.
Definition: 40duplicateStyle.php:19
+ Here is the call graph for this function:

◆ WriteVorbisComment()

getid3_write_vorbiscomment::WriteVorbisComment ( )

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

References $key, and CleanVorbisCommentName().

Referenced by DeleteVorbisComment().

30  {
31 
32  if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
33  $this->errors[] = 'PHP running in Safe Mode (backtick operator not available) - cannot call vorbiscomment, tags not written';
34  return false;
35  }
36 
37  // Create file with new comments
38  $tempcommentsfilename = tempnam(GETID3_TEMP_DIR, 'getID3');
39  if (is_writable($tempcommentsfilename) && is_file($tempcommentsfilename) && ($fpcomments = fopen($tempcommentsfilename, 'wb'))) {
40 
41  foreach ($this->tag_data as $key => $value) {
42  foreach ($value as $commentdata) {
43  fwrite($fpcomments, $this->CleanVorbisCommentName($key).'='.$commentdata."\n");
44  }
45  }
46  fclose($fpcomments);
47 
48  } else {
49  $this->errors[] = 'failed to open temporary tags file "'.$tempcommentsfilename.'", tags not written';
50  return false;
51  }
52 
53  $oldignoreuserabort = ignore_user_abort(true);
54  if (GETID3_OS_ISWINDOWS) {
55 
56  if (file_exists(GETID3_HELPERAPPSDIR.'vorbiscomment.exe')) {
57  //$commandline = '"'.GETID3_HELPERAPPSDIR.'vorbiscomment.exe" -w --raw -c "'.$tempcommentsfilename.'" "'.str_replace('/', '\\', $this->filename).'"';
58  // vorbiscomment works fine if you copy-paste the above commandline into a command prompt,
59  // but refuses to work with `backtick` if there are "doublequotes" present around BOTH
60  // the metaflac pathname and the target filename. For whatever reason...??
61  // The solution is simply ensure that the metaflac pathname has no spaces,
62  // and therefore does not need to be quoted
63 
64  // On top of that, if error messages are not always captured properly under Windows
65  // To at least see if there was a problem, compare file modification timestamps before and after writing
66  clearstatcache();
67  $timestampbeforewriting = filemtime($this->filename);
68 
69  $commandline = GETID3_HELPERAPPSDIR.'vorbiscomment.exe -w --raw -c "'.$tempcommentsfilename.'" "'.$this->filename.'" 2>&1';
70  $VorbiscommentError = `$commandline`;
71 
72  if (empty($VorbiscommentError)) {
73  clearstatcache();
74  if ($timestampbeforewriting == filemtime($this->filename)) {
75  $VorbiscommentError = 'File modification timestamp has not changed - it looks like the tags were not written';
76  }
77  }
78  } else {
79  $VorbiscommentError = 'vorbiscomment.exe not found in '.GETID3_HELPERAPPSDIR;
80  }
81 
82  } else {
83 
84  $commandline = 'vorbiscomment -w --raw -c "'.$tempcommentsfilename.'" "'.$this->filename.'" 2>&1';
85  $VorbiscommentError = `$commandline`;
86 
87  }
88 
89  // Remove temporary comments file
90  unlink($tempcommentsfilename);
91  ignore_user_abort($oldignoreuserabort);
92 
93  if (!empty($VorbiscommentError)) {
94 
95  $this->errors[] = 'system call to vorbiscomment failed with message: '."\n\n".$VorbiscommentError;
96  return false;
97 
98  }
99 
100  return true;
101  }
getid3_write_vorbiscomment\CleanVorbisCommentName
CleanVorbisCommentName($originalcommentname)
Definition: write.vorbiscomment.php:108
$key
$key
Definition: croninfo.php:18
+ 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: