source: spip-zone/_core_/branches/spip-3.1/plugins/medias/lib/getid3/getid3.php @ 96229

Last change on this file since 96229 was 96229, checked in by brunobergot@…, 3 years ago

report de r96228

maj de la lib getid3 en version 1.9.12 + ajout de getid3 et mejs aux crédits

ref ​https://core.spip.net/issues/3693

File size: 63.8 KB
Line 
1<?php
2/////////////////////////////////////////////////////////////////
3/// getID3() by James Heinrich <info@getid3.org>               //
4//  available at http://getid3.sourceforge.net                 //
5//            or http://www.getid3.org                         //
6//          also https://github.com/JamesHeinrich/getID3       //
7/////////////////////////////////////////////////////////////////
8//                                                             //
9// Please see readme.txt for more information                  //
10//                                                            ///
11/////////////////////////////////////////////////////////////////
12
13// define a constant rather than looking up every time it is needed
14if (!defined('GETID3_OS_ISWINDOWS')) {
15        define('GETID3_OS_ISWINDOWS', (stripos(PHP_OS, 'WIN') === 0));
16}
17// Get base path of getID3() - ONCE
18if (!defined('GETID3_INCLUDEPATH')) {
19        define('GETID3_INCLUDEPATH', dirname(__FILE__).DIRECTORY_SEPARATOR);
20}
21// Workaround Bug #39923 (https://bugs.php.net/bug.php?id=39923)
22if (!defined('IMG_JPG') && defined('IMAGETYPE_JPEG')) {
23        define('IMG_JPG', IMAGETYPE_JPEG);
24}
25
26// attempt to define temp dir as something flexible but reliable
27$temp_dir = ini_get('upload_tmp_dir');
28if ($temp_dir && (!is_dir($temp_dir) || !is_readable($temp_dir))) {
29        $temp_dir = '';
30}
31if (!$temp_dir && function_exists('sys_get_temp_dir')) { // sys_get_temp_dir added in PHP v5.2.1
32        // sys_get_temp_dir() may give inaccessible temp dir, e.g. with open_basedir on virtual hosts
33        $temp_dir = sys_get_temp_dir();
34}
35$temp_dir = @realpath($temp_dir); // see https://github.com/JamesHeinrich/getID3/pull/10
36$open_basedir = ini_get('open_basedir');
37if ($open_basedir) {
38        // e.g. "/var/www/vhosts/getid3.org/httpdocs/:/tmp/"
39        $temp_dir     = str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $temp_dir);
40        $open_basedir = str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $open_basedir);
41        if (substr($temp_dir, -1, 1) != DIRECTORY_SEPARATOR) {
42                $temp_dir .= DIRECTORY_SEPARATOR;
43        }
44        $found_valid_tempdir = false;
45        $open_basedirs = explode(PATH_SEPARATOR, $open_basedir);
46        foreach ($open_basedirs as $basedir) {
47                if (substr($basedir, -1, 1) != DIRECTORY_SEPARATOR) {
48                        $basedir .= DIRECTORY_SEPARATOR;
49                }
50                if (preg_match('#^'.preg_quote($basedir).'#', $temp_dir)) {
51                        $found_valid_tempdir = true;
52                        break;
53                }
54        }
55        if (!$found_valid_tempdir) {
56                $temp_dir = '';
57        }
58        unset($open_basedirs, $found_valid_tempdir, $basedir);
59}
60if (!$temp_dir) {
61        $temp_dir = '*'; // invalid directory name should force tempnam() to use system default temp dir
62}
63// $temp_dir = '/something/else/';  // feel free to override temp dir here if it works better for your system
64if (!defined('GETID3_TEMP_DIR')) {
65        define('GETID3_TEMP_DIR', $temp_dir);
66}
67unset($open_basedir, $temp_dir);
68
69// End: Defines
70
71
72class getID3
73{
74        // public: Settings
75        public $encoding        = 'UTF-8';        // CASE SENSITIVE! - i.e. (must be supported by iconv()). Examples:  ISO-8859-1  UTF-8  UTF-16  UTF-16BE
76        public $encoding_id3v1  = 'ISO-8859-1';   // Should always be 'ISO-8859-1', but some tags may be written in other encodings such as 'EUC-CN' or 'CP1252'
77
78        // public: Optional tag checks - disable for speed.
79        public $option_tag_id3v1         = true;  // Read and process ID3v1 tags
80        public $option_tag_id3v2         = true;  // Read and process ID3v2 tags
81        public $option_tag_lyrics3       = true;  // Read and process Lyrics3 tags
82        public $option_tag_apetag        = true;  // Read and process APE tags
83        public $option_tags_process      = true;  // Copy tags to root key 'tags' and encode to $this->encoding
84        public $option_tags_html         = true;  // Copy tags to root key 'tags_html' properly translated from various encodings to HTML entities
85
86        // public: Optional tag/comment calucations
87        public $option_extra_info        = true;  // Calculate additional info such as bitrate, channelmode etc
88
89        // public: Optional handling of embedded attachments (e.g. images)
90        public $option_save_attachments  = true; // defaults to true (ATTACHMENTS_INLINE) for backward compatibility
91
92        // public: Optional calculations
93        public $option_md5_data          = false; // Get MD5 sum of data part - slow
94        public $option_md5_data_source   = false; // Use MD5 of source file if availble - only FLAC and OptimFROG
95        public $option_sha1_data         = false; // Get SHA1 sum of data part - slow
96        public $option_max_2gb_check     = null;  // Check whether file is larger than 2GB and thus not supported by 32-bit PHP (null: auto-detect based on PHP_INT_MAX)
97
98        // public: Read buffer size in bytes
99        public $option_fread_buffer_size = 32768;
100
101        // Public variables
102        public $filename;                         // Filename of file being analysed.
103        public $fp;                               // Filepointer to file being analysed.
104        public $info;                             // Result array.
105        public $tempdir = GETID3_TEMP_DIR;
106        public $memory_limit = 0;
107
108        // Protected variables
109        protected $startup_error   = '';
110        protected $startup_warning = '';
111
112        const VERSION           = '1.9.12-201602240818';
113        const FREAD_BUFFER_SIZE = 32768;
114
115        const ATTACHMENTS_NONE   = false;
116        const ATTACHMENTS_INLINE = true;
117
118        // public: constructor
119        public function __construct() {
120
121                // Check for PHP version
122                $required_php_version = '5.3.0';
123                if (version_compare(PHP_VERSION, $required_php_version, '<')) {
124                        $this->startup_error .= 'getID3() requires PHP v'.$required_php_version.' or higher - you are running v'.PHP_VERSION;
125                        return false;
126                }
127
128                // Check memory
129                $this->memory_limit = ini_get('memory_limit');
130                if (preg_match('#([0-9]+)M#i', $this->memory_limit, $matches)) {
131                        // could be stored as "16M" rather than 16777216 for example
132                        $this->memory_limit = $matches[1] * 1048576;
133                } elseif (preg_match('#([0-9]+)G#i', $this->memory_limit, $matches)) { // The 'G' modifier is available since PHP 5.1.0
134                        // could be stored as "2G" rather than 2147483648 for example
135                        $this->memory_limit = $matches[1] * 1073741824;
136                }
137                if ($this->memory_limit <= 0) {
138                        // memory limits probably disabled
139                } elseif ($this->memory_limit <= 4194304) {
140                        $this->startup_error .= 'PHP has less than 4MB available memory and will very likely run out. Increase memory_limit in php.ini';
141                } elseif ($this->memory_limit <= 12582912) {
142                        $this->startup_warning .= 'PHP has less than 12MB available memory and might run out if all modules are loaded. Increase memory_limit in php.ini';
143                }
144
145                // Check safe_mode off
146                if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
147                        $this->warning('WARNING: Safe mode is on, shorten support disabled, md5data/sha1data for ogg vorbis disabled, ogg vorbos/flac tag writing disabled.');
148                }
149
150                if (intval(ini_get('mbstring.func_overload')) > 0) {
151                        $this->warning('WARNING: php.ini contains "mbstring.func_overload = '.ini_get('mbstring.func_overload').'", this may break things.');
152                }
153
154                // Check for magic_quotes_runtime
155                if (function_exists('get_magic_quotes_runtime')) {
156                        if (get_magic_quotes_runtime()) {
157                                return $this->startup_error('magic_quotes_runtime must be disabled before running getID3(). Surround getid3 block by set_magic_quotes_runtime(0) and set_magic_quotes_runtime(1).');
158                        }
159                }
160
161                // Check for magic_quotes_gpc
162                if (function_exists('magic_quotes_gpc')) {
163                        if (get_magic_quotes_gpc()) {
164                                return $this->startup_error('magic_quotes_gpc must be disabled before running getID3(). Surround getid3 block by set_magic_quotes_gpc(0) and set_magic_quotes_gpc(1).');
165                        }
166                }
167
168                // Load support library
169                if (!include_once(GETID3_INCLUDEPATH.'getid3.lib.php')) {
170                        $this->startup_error .= 'getid3.lib.php is missing or corrupt';
171                }
172
173                if ($this->option_max_2gb_check === null) {
174                        $this->option_max_2gb_check = (PHP_INT_MAX <= 2147483647);
175                }
176
177
178                // Needed for Windows only:
179                // Define locations of helper applications for Shorten, VorbisComment, MetaFLAC
180                //   as well as other helper functions such as head, tail, md5sum, etc
181                // This path cannot contain spaces, but the below code will attempt to get the
182                //   8.3-equivalent path automatically
183                // IMPORTANT: This path must include the trailing slash
184                if (GETID3_OS_ISWINDOWS && !defined('GETID3_HELPERAPPSDIR')) {
185
186                        $helperappsdir = GETID3_INCLUDEPATH.'..'.DIRECTORY_SEPARATOR.'helperapps'; // must not have any space in this path
187
188                        if (!is_dir($helperappsdir)) {
189                                $this->startup_warning .= '"'.$helperappsdir.'" cannot be defined as GETID3_HELPERAPPSDIR because it does not exist';
190                        } elseif (strpos(realpath($helperappsdir), ' ') !== false) {
191                                $DirPieces = explode(DIRECTORY_SEPARATOR, realpath($helperappsdir));
192                                $path_so_far = array();
193                                foreach ($DirPieces as $key => $value) {
194                                        if (strpos($value, ' ') !== false) {
195                                                if (!empty($path_so_far)) {
196                                                        $commandline = 'dir /x '.escapeshellarg(implode(DIRECTORY_SEPARATOR, $path_so_far));
197                                                        $dir_listing = `$commandline`;
198                                                        $lines = explode("\n", $dir_listing);
199                                                        foreach ($lines as $line) {
200                                                                $line = trim($line);
201                                                                if (preg_match('#^([0-9/]{10}) +([0-9:]{4,5}( [AP]M)?) +(<DIR>|[0-9,]+) +([^ ]{0,11}) +(.+)$#', $line, $matches)) {
202                                                                        list($dummy, $date, $time, $ampm, $filesize, $shortname, $filename) = $matches;
203                                                                        if ((strtoupper($filesize) == '<DIR>') && (strtolower($filename) == strtolower($value))) {
204                                                                                $value = $shortname;
205                                                                        }
206                                                                }
207                                                        }
208                                                } else {
209                                                        $this->startup_warning .= 'GETID3_HELPERAPPSDIR must not have any spaces in it - use 8dot3 naming convention if neccesary. You can run "dir /x" from the commandline to see the correct 8.3-style names.';
210                                                }
211                                        }
212                                        $path_so_far[] = $value;
213                                }
214                                $helperappsdir = implode(DIRECTORY_SEPARATOR, $path_so_far);
215                        }
216                        define('GETID3_HELPERAPPSDIR', $helperappsdir.DIRECTORY_SEPARATOR);
217                }
218
219                return true;
220        }
221
222        public function version() {
223                return self::VERSION;
224        }
225
226        public function fread_buffer_size() {
227                return $this->option_fread_buffer_size;
228        }
229
230
231        // public: setOption
232        public function setOption($optArray) {
233                if (!is_array($optArray) || empty($optArray)) {
234                        return false;
235                }
236                foreach ($optArray as $opt => $val) {
237                        if (isset($this->$opt) === false) {
238                                continue;
239                        }
240                        $this->$opt = $val;
241                }
242                return true;
243        }
244
245
246        public function openfile($filename, $filesize=null) {
247                try {
248                        if (!empty($this->startup_error)) {
249                                throw new getid3_exception($this->startup_error);
250                        }
251                        if (!empty($this->startup_warning)) {
252                                $this->warning($this->startup_warning);
253                        }
254
255                        // init result array and set parameters
256                        $this->filename = $filename;
257                        $this->info = array();
258                        $this->info['GETID3_VERSION']   = $this->version();
259                        $this->info['php_memory_limit'] = (($this->memory_limit > 0) ? $this->memory_limit : false);
260
261                        // remote files not supported
262                        if (preg_match('/^(ht|f)tp:\/\//', $filename)) {
263                                throw new getid3_exception('Remote files are not supported - please copy the file locally first');
264                        }
265
266                        $filename = str_replace('/', DIRECTORY_SEPARATOR, $filename);
267                        $filename = preg_replace('#(.+)'.preg_quote(DIRECTORY_SEPARATOR).'{2,}#U', '\1'.DIRECTORY_SEPARATOR, $filename);
268
269                        // open local file
270                        //if (is_readable($filename) && is_file($filename) && ($this->fp = fopen($filename, 'rb'))) { // see http://www.getid3.org/phpBB3/viewtopic.php?t=1720
271                        if ((is_readable($filename) || file_exists($filename)) && is_file($filename) && ($this->fp = fopen($filename, 'rb'))) {
272                                // great
273                        } else {
274                                $errormessagelist = array();
275                                if (!is_readable($filename)) {
276                                        $errormessagelist[] = '!is_readable';
277                                }
278                                if (!is_file($filename)) {
279                                        $errormessagelist[] = '!is_file';
280                                }
281                                if (!file_exists($filename)) {
282                                        $errormessagelist[] = '!file_exists';
283                                }
284                                if (empty($errormessagelist)) {
285                                        $errormessagelist[] = 'fopen failed';
286                                }
287                                throw new getid3_exception('Could not open "'.$filename.'" ('.implode('; ', $errormessagelist).')');
288                        }
289
290                        $this->info['filesize'] = (!is_null($filesize) ? $filesize : filesize($filename));
291                        // set redundant parameters - might be needed in some include file
292                        // filenames / filepaths in getID3 are always expressed with forward slashes (unix-style) for both Windows and other to try and minimize confusion
293                        $filename = str_replace('\\', '/', $filename);
294                        $this->info['filepath']     = str_replace('\\', '/', realpath(dirname($filename)));
295                        $this->info['filename']     = getid3_lib::mb_basename($filename);
296                        $this->info['filenamepath'] = $this->info['filepath'].'/'.$this->info['filename'];
297
298
299                        // option_max_2gb_check
300                        if ($this->option_max_2gb_check) {
301                                // PHP (32-bit all, and 64-bit Windows) doesn't support integers larger than 2^31 (~2GB)
302                                // filesize() simply returns (filesize % (pow(2, 32)), no matter the actual filesize
303                                // ftell() returns 0 if seeking to the end is beyond the range of unsigned integer
304                                $fseek = fseek($this->fp, 0, SEEK_END);
305                                if (($fseek < 0) || (($this->info['filesize'] != 0) && (ftell($this->fp) == 0)) ||
306                                        ($this->info['filesize'] < 0) ||
307                                        (ftell($this->fp) < 0)) {
308                                                $real_filesize = getid3_lib::getFileSizeSyscall($this->info['filenamepath']);
309
310                                                if ($real_filesize === false) {
311                                                        unset($this->info['filesize']);
312                                                        fclose($this->fp);
313                                                        throw new getid3_exception('Unable to determine actual filesize. File is most likely larger than '.round(PHP_INT_MAX / 1073741824).'GB and is not supported by PHP.');
314                                                } elseif (getid3_lib::intValueSupported($real_filesize)) {
315                                                        unset($this->info['filesize']);
316                                                        fclose($this->fp);
317                                                        throw new getid3_exception('PHP seems to think the file is larger than '.round(PHP_INT_MAX / 1073741824).'GB, but filesystem reports it as '.number_format($real_filesize, 3).'GB, please report to info@getid3.org');
318                                                }
319                                                $this->info['filesize'] = $real_filesize;
320                                                $this->warning('File is larger than '.round(PHP_INT_MAX / 1073741824).'GB (filesystem reports it as '.number_format($real_filesize, 3).'GB) and is not properly supported by PHP.');
321                                }
322                        }
323
324                        // set more parameters
325                        $this->info['avdataoffset']        = 0;
326                        $this->info['avdataend']           = $this->info['filesize'];
327                        $this->info['fileformat']          = '';                // filled in later
328                        $this->info['audio']['dataformat'] = '';                // filled in later, unset if not used
329                        $this->info['video']['dataformat'] = '';                // filled in later, unset if not used
330                        $this->info['tags']                = array();           // filled in later, unset if not used
331                        $this->info['error']               = array();           // filled in later, unset if not used
332                        $this->info['warning']             = array();           // filled in later, unset if not used
333                        $this->info['comments']            = array();           // filled in later, unset if not used
334                        $this->info['encoding']            = $this->encoding;   // required by id3v2 and iso modules - can be unset at the end if desired
335
336                        return true;
337
338                } catch (Exception $e) {
339                        $this->error($e->getMessage());
340                }
341                return false;
342        }
343
344        // public: analyze file
345        public function analyze($filename, $filesize=null, $original_filename='') {
346                try {
347                        if (!$this->openfile($filename, $filesize)) {
348                                return $this->info;
349                        }
350
351                        // Handle tags
352                        foreach (array('id3v2'=>'id3v2', 'id3v1'=>'id3v1', 'apetag'=>'ape', 'lyrics3'=>'lyrics3') as $tag_name => $tag_key) {
353                                $option_tag = 'option_tag_'.$tag_name;
354                                if ($this->$option_tag) {
355                                        $this->include_module('tag.'.$tag_name);
356                                        try {
357                                                $tag_class = 'getid3_'.$tag_name;
358                                                $tag = new $tag_class($this);
359                                                $tag->Analyze();
360                                        }
361                                        catch (getid3_exception $e) {
362                                                throw $e;
363                                        }
364                                }
365                        }
366                        if (isset($this->info['id3v2']['tag_offset_start'])) {
367                                $this->info['avdataoffset'] = max($this->info['avdataoffset'], $this->info['id3v2']['tag_offset_end']);
368                        }
369                        foreach (array('id3v1'=>'id3v1', 'apetag'=>'ape', 'lyrics3'=>'lyrics3') as $tag_name => $tag_key) {
370                                if (isset($this->info[$tag_key]['tag_offset_start'])) {
371                                        $this->info['avdataend'] = min($this->info['avdataend'], $this->info[$tag_key]['tag_offset_start']);
372                                }
373                        }
374
375                        // ID3v2 detection (NOT parsing), even if ($this->option_tag_id3v2 == false) done to make fileformat easier
376                        if (!$this->option_tag_id3v2) {
377                                fseek($this->fp, 0);
378                                $header = fread($this->fp, 10);
379                                if ((substr($header, 0, 3) == 'ID3') && (strlen($header) == 10)) {
380                                        $this->info['id3v2']['header']        = true;
381                                        $this->info['id3v2']['majorversion']  = ord($header{3});
382                                        $this->info['id3v2']['minorversion']  = ord($header{4});
383                                        $this->info['avdataoffset']          += getid3_lib::BigEndian2Int(substr($header, 6, 4), 1) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length
384                                }
385                        }
386
387                        // read 32 kb file data
388                        fseek($this->fp, $this->info['avdataoffset']);
389                        $formattest = fread($this->fp, 32774);
390
391                        // determine format
392                        $determined_format = $this->GetFileFormat($formattest, ($original_filename ? $original_filename : $filename));
393
394                        // unable to determine file format
395                        if (!$determined_format) {
396                                fclose($this->fp);
397                                return $this->error('unable to determine file format');
398                        }
399
400                        // check for illegal ID3 tags
401                        if (isset($determined_format['fail_id3']) && (in_array('id3v1', $this->info['tags']) || in_array('id3v2', $this->info['tags']))) {
402                                if ($determined_format['fail_id3'] === 'ERROR') {
403                                        fclose($this->fp);
404                                        return $this->error('ID3 tags not allowed on this file type.');
405                                } elseif ($determined_format['fail_id3'] === 'WARNING') {
406                                        $this->warning('ID3 tags not allowed on this file type.');
407                                }
408                        }
409
410                        // check for illegal APE tags
411                        if (isset($determined_format['fail_ape']) && in_array('ape', $this->info['tags'])) {
412                                if ($determined_format['fail_ape'] === 'ERROR') {
413                                        fclose($this->fp);
414                                        return $this->error('APE tags not allowed on this file type.');
415                                } elseif ($determined_format['fail_ape'] === 'WARNING') {
416                                        $this->warning('APE tags not allowed on this file type.');
417                                }
418                        }
419
420                        // set mime type
421                        $this->info['mime_type'] = $determined_format['mime_type'];
422
423                        // supported format signature pattern detected, but module deleted
424                        if (!file_exists(GETID3_INCLUDEPATH.$determined_format['include'])) {
425                                fclose($this->fp);
426                                return $this->error('Format not supported, module "'.$determined_format['include'].'" was removed.');
427                        }
428
429                        // module requires iconv support
430                        // Check encoding/iconv support
431                        if (!empty($determined_format['iconv_req']) && !function_exists('iconv') && !in_array($this->encoding, array('ISO-8859-1', 'UTF-8', 'UTF-16LE', 'UTF-16BE', 'UTF-16'))) {
432                                $errormessage = 'iconv() support is required for this module ('.$determined_format['include'].') for encodings other than ISO-8859-1, UTF-8, UTF-16LE, UTF16-BE, UTF-16. ';
433                                if (GETID3_OS_ISWINDOWS) {
434                                        $errormessage .= 'PHP does not have iconv() support. Please enable php_iconv.dll in php.ini, and copy iconv.dll from c:/php/dlls to c:/windows/system32';
435                                } else {
436                                        $errormessage .= 'PHP is not compiled with iconv() support. Please recompile with the --with-iconv switch';
437                                }
438                                return $this->error($errormessage);
439                        }
440
441                        // include module
442                        include_once(GETID3_INCLUDEPATH.$determined_format['include']);
443
444                        // instantiate module class
445                        $class_name = 'getid3_'.$determined_format['module'];
446                        if (!class_exists($class_name)) {
447                                return $this->error('Format not supported, module "'.$determined_format['include'].'" is corrupt.');
448                        }
449                        $class = new $class_name($this);
450                        $class->Analyze();
451                        unset($class);
452
453                        // close file
454                        fclose($this->fp);
455
456                        // process all tags - copy to 'tags' and convert charsets
457                        if ($this->option_tags_process) {
458                                $this->HandleAllTags();
459                        }
460
461                        // perform more calculations
462                        if ($this->option_extra_info) {
463                                $this->ChannelsBitratePlaytimeCalculations();
464                                $this->CalculateCompressionRatioVideo();
465                                $this->CalculateCompressionRatioAudio();
466                                $this->CalculateReplayGain();
467                                $this->ProcessAudioStreams();
468                        }
469
470                        // get the MD5 sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags
471                        if ($this->option_md5_data) {
472                                // do not calc md5_data if md5_data_source is present - set by flac only - future MPC/SV8 too
473                                if (!$this->option_md5_data_source || empty($this->info['md5_data_source'])) {
474                                        $this->getHashdata('md5');
475                                }
476                        }
477
478                        // get the SHA1 sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags
479                        if ($this->option_sha1_data) {
480                                $this->getHashdata('sha1');
481                        }
482
483                        // remove undesired keys
484                        $this->CleanUp();
485
486                } catch (Exception $e) {
487                        $this->error('Caught exception: '.$e->getMessage());
488                }
489
490                // return info array
491                return $this->info;
492        }
493
494
495        // private: error handling
496        public function error($message) {
497                $this->CleanUp();
498                if (!isset($this->info['error'])) {
499                        $this->info['error'] = array();
500                }
501                $this->info['error'][] = $message;
502                return $this->info;
503        }
504
505
506        // private: warning handling
507        public function warning($message) {
508                $this->info['warning'][] = $message;
509                return true;
510        }
511
512
513        // private: CleanUp
514        private function CleanUp() {
515
516                // remove possible empty keys
517                $AVpossibleEmptyKeys = array('dataformat', 'bits_per_sample', 'encoder_options', 'streams', 'bitrate');
518                foreach ($AVpossibleEmptyKeys as $dummy => $key) {
519                        if (empty($this->info['audio'][$key]) && isset($this->info['audio'][$key])) {
520                                unset($this->info['audio'][$key]);
521                        }
522                        if (empty($this->info['video'][$key]) && isset($this->info['video'][$key])) {
523                                unset($this->info['video'][$key]);
524                        }
525                }
526
527                // remove empty root keys
528                if (!empty($this->info)) {
529                        foreach ($this->info as $key => $value) {
530                                if (empty($this->info[$key]) && ($this->info[$key] !== 0) && ($this->info[$key] !== '0')) {
531                                        unset($this->info[$key]);
532                                }
533                        }
534                }
535
536                // remove meaningless entries from unknown-format files
537                if (empty($this->info['fileformat'])) {
538                        if (isset($this->info['avdataoffset'])) {
539                                unset($this->info['avdataoffset']);
540                        }
541                        if (isset($this->info['avdataend'])) {
542                                unset($this->info['avdataend']);
543                        }
544                }
545
546                // remove possible duplicated identical entries
547                if (!empty($this->info['error'])) {
548                        $this->info['error'] = array_values(array_unique($this->info['error']));
549                }
550                if (!empty($this->info['warning'])) {
551                        $this->info['warning'] = array_values(array_unique($this->info['warning']));
552                }
553
554                // remove "global variable" type keys
555                unset($this->info['php_memory_limit']);
556
557                return true;
558        }
559
560
561        // return array containing information about all supported formats
562        public function GetFileFormatArray() {
563                static $format_info = array();
564                if (empty($format_info)) {
565                        $format_info = array(
566
567                                // Audio formats
568
569                                // AC-3   - audio      - Dolby AC-3 / Dolby Digital
570                                'ac3'  => array(
571                                                        'pattern'   => '^\x0B\x77',
572                                                        'group'     => 'audio',
573                                                        'module'    => 'ac3',
574                                                        'mime_type' => 'audio/ac3',
575                                                ),
576
577                                // AAC  - audio       - Advanced Audio Coding (AAC) - ADIF format
578                                'adif' => array(
579                                                        'pattern'   => '^ADIF',
580                                                        'group'     => 'audio',
581                                                        'module'    => 'aac',
582                                                        'mime_type' => 'application/octet-stream',
583                                                        'fail_ape'  => 'WARNING',
584                                                ),
585
586/*
587                                // AA   - audio       - Audible Audiobook
588                                'aa'   => array(
589                                                        'pattern'   => '^.{4}\x57\x90\x75\x36',
590                                                        'group'     => 'audio',
591                                                        'module'    => 'aa',
592                                                        'mime_type' => 'audio/audible',
593                                                ),
594*/
595                                // AAC  - audio       - Advanced Audio Coding (AAC) - ADTS format (very similar to MP3)
596                                'adts' => array(
597                                                        'pattern'   => '^\xFF[\xF0-\xF1\xF8-\xF9]',
598                                                        'group'     => 'audio',
599                                                        'module'    => 'aac',
600                                                        'mime_type' => 'application/octet-stream',
601                                                        'fail_ape'  => 'WARNING',
602                                                ),
603
604
605                                // AU   - audio       - NeXT/Sun AUdio (AU)
606                                'au'   => array(
607                                                        'pattern'   => '^\.snd',
608                                                        'group'     => 'audio',
609                                                        'module'    => 'au',
610                                                        'mime_type' => 'audio/basic',
611                                                ),
612
613                                // AMR  - audio       - Adaptive Multi Rate
614                                'amr'  => array(
615                                                        'pattern'   => '^\x23\x21AMR\x0A', // #!AMR[0A]
616                                                        'group'     => 'audio',
617                                                        'module'    => 'amr',
618                                                        'mime_type' => 'audio/amr',
619                                                ),
620
621                                // AVR  - audio       - Audio Visual Research
622                                'avr'  => array(
623                                                        'pattern'   => '^2BIT',
624                                                        'group'     => 'audio',
625                                                        'module'    => 'avr',
626                                                        'mime_type' => 'application/octet-stream',
627                                                ),
628
629                                // BONK - audio       - Bonk v0.9+
630                                'bonk' => array(
631                                                        'pattern'   => '^\x00(BONK|INFO|META| ID3)',
632                                                        'group'     => 'audio',
633                                                        'module'    => 'bonk',
634                                                        'mime_type' => 'audio/xmms-bonk',
635                                                ),
636
637                                // DSF  - audio       - Direct Stream Digital (DSD) Storage Facility files (DSF) - https://en.wikipedia.org/wiki/Direct_Stream_Digital
638                                'dsf'  => array(
639                                                        'pattern'   => '^DSD ',  // including trailing space: 44 53 44 20
640                                                        'group'     => 'audio',
641                                                        'module'    => 'dsf',
642                                                        'mime_type' => 'audio/dsd',
643                                                ),
644
645                                // DSS  - audio       - Digital Speech Standard
646                                'dss'  => array(
647                                                        'pattern'   => '^[\x02-\x03]ds[s2]',
648                                                        'group'     => 'audio',
649                                                        'module'    => 'dss',
650                                                        'mime_type' => 'application/octet-stream',
651                                                ),
652
653                                // DTS  - audio       - Dolby Theatre System
654                                'dts'  => array(
655                                                        'pattern'   => '^\x7F\xFE\x80\x01',
656                                                        'group'     => 'audio',
657                                                        'module'    => 'dts',
658                                                        'mime_type' => 'audio/dts',
659                                                ),
660
661                                // FLAC - audio       - Free Lossless Audio Codec
662                                'flac' => array(
663                                                        'pattern'   => '^fLaC',
664                                                        'group'     => 'audio',
665                                                        'module'    => 'flac',
666                                                        'mime_type' => 'audio/x-flac',
667                                                ),
668
669                                // LA   - audio       - Lossless Audio (LA)
670                                'la'   => array(
671                                                        'pattern'   => '^LA0[2-4]',
672                                                        'group'     => 'audio',
673                                                        'module'    => 'la',
674                                                        'mime_type' => 'application/octet-stream',
675                                                ),
676
677                                // LPAC - audio       - Lossless Predictive Audio Compression (LPAC)
678                                'lpac' => array(
679                                                        'pattern'   => '^LPAC',
680                                                        'group'     => 'audio',
681                                                        'module'    => 'lpac',
682                                                        'mime_type' => 'application/octet-stream',
683                                                ),
684
685                                // MIDI - audio       - MIDI (Musical Instrument Digital Interface)
686                                'midi' => array(
687                                                        'pattern'   => '^MThd',
688                                                        'group'     => 'audio',
689                                                        'module'    => 'midi',
690                                                        'mime_type' => 'audio/midi',
691                                                ),
692
693                                // MAC  - audio       - Monkey's Audio Compressor
694                                'mac'  => array(
695                                                        'pattern'   => '^MAC ',
696                                                        'group'     => 'audio',
697                                                        'module'    => 'monkey',
698                                                        'mime_type' => 'application/octet-stream',
699                                                ),
700
701// has been known to produce false matches in random files (e.g. JPEGs), leave out until more precise matching available
702//                              // MOD  - audio       - MODule (assorted sub-formats)
703//                              'mod'  => array(
704//                                                      'pattern'   => '^.{1080}(M\\.K\\.|M!K!|FLT4|FLT8|[5-9]CHN|[1-3][0-9]CH)',
705//                                                      'group'     => 'audio',
706//                                                      'module'    => 'mod',
707//                                                      'option'    => 'mod',
708//                                                      'mime_type' => 'audio/mod',
709//                                              ),
710
711                                // MOD  - audio       - MODule (Impulse Tracker)
712                                'it'   => array(
713                                                        'pattern'   => '^IMPM',
714                                                        'group'     => 'audio',
715                                                        'module'    => 'mod',
716                                                        //'option'    => 'it',
717                                                        'mime_type' => 'audio/it',
718                                                ),
719
720                                // MOD  - audio       - MODule (eXtended Module, various sub-formats)
721                                'xm'   => array(
722                                                        'pattern'   => '^Extended Module',
723                                                        'group'     => 'audio',
724                                                        'module'    => 'mod',
725                                                        //'option'    => 'xm',
726                                                        'mime_type' => 'audio/xm',
727                                                ),
728
729                                // MOD  - audio       - MODule (ScreamTracker)
730                                's3m'  => array(
731                                                        'pattern'   => '^.{44}SCRM',
732                                                        'group'     => 'audio',
733                                                        'module'    => 'mod',
734                                                        //'option'    => 's3m',
735                                                        'mime_type' => 'audio/s3m',
736                                                ),
737
738                                // MPC  - audio       - Musepack / MPEGplus
739                                'mpc'  => array(
740                                                        'pattern'   => '^(MPCK|MP\+|[\x00\x01\x10\x11\x40\x41\x50\x51\x80\x81\x90\x91\xC0\xC1\xD0\xD1][\x20-37][\x00\x20\x40\x60\x80\xA0\xC0\xE0])',
741                                                        'group'     => 'audio',
742                                                        'module'    => 'mpc',
743                                                        'mime_type' => 'audio/x-musepack',
744                                                ),
745
746                                // MP3  - audio       - MPEG-audio Layer 3 (very similar to AAC-ADTS)
747                                'mp3'  => array(
748                                                        'pattern'   => '^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\x0B\x10-\x1B\x20-\x2B\x30-\x3B\x40-\x4B\x50-\x5B\x60-\x6B\x70-\x7B\x80-\x8B\x90-\x9B\xA0-\xAB\xB0-\xBB\xC0-\xCB\xD0-\xDB\xE0-\xEB\xF0-\xFB]',
749                                                        'group'     => 'audio',
750                                                        'module'    => 'mp3',
751                                                        'mime_type' => 'audio/mpeg',
752                                                ),
753
754                                // OFR  - audio       - OptimFROG
755                                'ofr'  => array(
756                                                        'pattern'   => '^(\*RIFF|OFR)',
757                                                        'group'     => 'audio',
758                                                        'module'    => 'optimfrog',
759                                                        'mime_type' => 'application/octet-stream',
760                                                ),
761
762                                // RKAU - audio       - RKive AUdio compressor
763                                'rkau' => array(
764                                                        'pattern'   => '^RKA',
765                                                        'group'     => 'audio',
766                                                        'module'    => 'rkau',
767                                                        'mime_type' => 'application/octet-stream',
768                                                ),
769
770                                // SHN  - audio       - Shorten
771                                'shn'  => array(
772                                                        'pattern'   => '^ajkg',
773                                                        'group'     => 'audio',
774                                                        'module'    => 'shorten',
775                                                        'mime_type' => 'audio/xmms-shn',
776                                                        'fail_id3'  => 'ERROR',
777                                                        'fail_ape'  => 'ERROR',
778                                                ),
779
780                                // TTA  - audio       - TTA Lossless Audio Compressor (http://tta.corecodec.org)
781                                'tta'  => array(
782                                                        'pattern'   => '^TTA',  // could also be '^TTA(\x01|\x02|\x03|2|1)'
783                                                        'group'     => 'audio',
784                                                        'module'    => 'tta',
785                                                        'mime_type' => 'application/octet-stream',
786                                                ),
787
788                                // VOC  - audio       - Creative Voice (VOC)
789                                'voc'  => array(
790                                                        'pattern'   => '^Creative Voice File',
791                                                        'group'     => 'audio',
792                                                        'module'    => 'voc',
793                                                        'mime_type' => 'audio/voc',
794                                                ),
795
796                                // VQF  - audio       - transform-domain weighted interleave Vector Quantization Format (VQF)
797                                'vqf'  => array(
798                                                        'pattern'   => '^TWIN',
799                                                        'group'     => 'audio',
800                                                        'module'    => 'vqf',
801                                                        'mime_type' => 'application/octet-stream',
802                                                ),
803
804                                // WV  - audio        - WavPack (v4.0+)
805                                'wv'   => array(
806                                                        'pattern'   => '^wvpk',
807                                                        'group'     => 'audio',
808                                                        'module'    => 'wavpack',
809                                                        'mime_type' => 'application/octet-stream',
810                                                ),
811
812
813                                // Audio-Video formats
814
815                                // ASF  - audio/video - Advanced Streaming Format, Windows Media Video, Windows Media Audio
816                                'asf'  => array(
817                                                        'pattern'   => '^\x30\x26\xB2\x75\x8E\x66\xCF\x11\xA6\xD9\x00\xAA\x00\x62\xCE\x6C',
818                                                        'group'     => 'audio-video',
819                                                        'module'    => 'asf',
820                                                        'mime_type' => 'video/x-ms-asf',
821                                                        'iconv_req' => false,
822                                                ),
823
824                                // BINK - audio/video - Bink / Smacker
825                                'bink' => array(
826                                                        'pattern'   => '^(BIK|SMK)',
827                                                        'group'     => 'audio-video',
828                                                        'module'    => 'bink',
829                                                        'mime_type' => 'application/octet-stream',
830                                                ),
831
832                                // FLV  - audio/video - FLash Video
833                                'flv' => array(
834                                                        'pattern'   => '^FLV\x01',
835                                                        'group'     => 'audio-video',
836                                                        'module'    => 'flv',
837                                                        'mime_type' => 'video/x-flv',
838                                                ),
839
840                                // MKAV - audio/video - Mastroka
841                                'matroska' => array(
842                                                        'pattern'   => '^\x1A\x45\xDF\xA3',
843                                                        'group'     => 'audio-video',
844                                                        'module'    => 'matroska',
845                                                        'mime_type' => 'video/x-matroska', // may also be audio/x-matroska
846                                                ),
847
848                                // MPEG - audio/video - MPEG (Moving Pictures Experts Group)
849                                'mpeg' => array(
850                                                        'pattern'   => '^\x00\x00\x01(\xBA|\xB3)',
851                                                        'group'     => 'audio-video',
852                                                        'module'    => 'mpeg',
853                                                        'mime_type' => 'video/mpeg',
854                                                ),
855
856                                // NSV  - audio/video - Nullsoft Streaming Video (NSV)
857                                'nsv'  => array(
858                                                        'pattern'   => '^NSV[sf]',
859                                                        'group'     => 'audio-video',
860                                                        'module'    => 'nsv',
861                                                        'mime_type' => 'application/octet-stream',
862                                                ),
863
864                                // Ogg  - audio/video - Ogg (Ogg-Vorbis, Ogg-FLAC, Speex, Ogg-Theora(*), Ogg-Tarkin(*))
865                                'ogg'  => array(
866                                                        'pattern'   => '^OggS',
867                                                        'group'     => 'audio',
868                                                        'module'    => 'ogg',
869                                                        'mime_type' => 'application/ogg',
870                                                        'fail_id3'  => 'WARNING',
871                                                        'fail_ape'  => 'WARNING',
872                                                ),
873
874                                // QT   - audio/video - Quicktime
875                                'quicktime' => array(
876                                                        'pattern'   => '^.{4}(cmov|free|ftyp|mdat|moov|pnot|skip|wide)',
877                                                        'group'     => 'audio-video',
878                                                        'module'    => 'quicktime',
879                                                        'mime_type' => 'video/quicktime',
880                                                ),
881
882                                // RIFF - audio/video - Resource Interchange File Format (RIFF) / WAV / AVI / CD-audio / SDSS = renamed variant used by SmartSound QuickTracks (www.smartsound.com) / FORM = Audio Interchange File Format (AIFF)
883                                'riff' => array(
884                                                        'pattern'   => '^(RIFF|SDSS|FORM)',
885                                                        'group'     => 'audio-video',
886                                                        'module'    => 'riff',
887                                                        'mime_type' => 'audio/x-wav',
888                                                        'fail_ape'  => 'WARNING',
889                                                ),
890
891                                // Real - audio/video - RealAudio, RealVideo
892                                'real' => array(
893                                                        'pattern'   => '^(\\.RMF|\\.ra)',
894                                                        'group'     => 'audio-video',
895                                                        'module'    => 'real',
896                                                        'mime_type' => 'audio/x-realaudio',
897                                                ),
898
899                                // SWF - audio/video - ShockWave Flash
900                                'swf' => array(
901                                                        'pattern'   => '^(F|C)WS',
902                                                        'group'     => 'audio-video',
903                                                        'module'    => 'swf',
904                                                        'mime_type' => 'application/x-shockwave-flash',
905                                                ),
906
907                                // TS - audio/video - MPEG-2 Transport Stream
908                                'ts' => array(
909                                                        'pattern'   => '^(\x47.{187}){10,}', // packets are 188 bytes long and start with 0x47 "G".  Check for at least 10 packets matching this pattern
910                                                        'group'     => 'audio-video',
911                                                        'module'    => 'ts',
912                                                        'mime_type' => 'video/MP2T',
913                                                ),
914
915
916                                // Still-Image formats
917
918                                // BMP  - still image - Bitmap (Windows, OS/2; uncompressed, RLE8, RLE4)
919                                'bmp'  => array(
920                                                        'pattern'   => '^BM',
921                                                        'group'     => 'graphic',
922                                                        'module'    => 'bmp',
923                                                        'mime_type' => 'image/bmp',
924                                                        'fail_id3'  => 'ERROR',
925                                                        'fail_ape'  => 'ERROR',
926                                                ),
927
928                                // GIF  - still image - Graphics Interchange Format
929                                'gif'  => array(
930                                                        'pattern'   => '^GIF',
931                                                        'group'     => 'graphic',
932                                                        'module'    => 'gif',
933                                                        'mime_type' => 'image/gif',
934                                                        'fail_id3'  => 'ERROR',
935                                                        'fail_ape'  => 'ERROR',
936                                                ),
937
938                                // JPEG - still image - Joint Photographic Experts Group (JPEG)
939                                'jpg'  => array(
940                                                        'pattern'   => '^\xFF\xD8\xFF',
941                                                        'group'     => 'graphic',
942                                                        'module'    => 'jpg',
943                                                        'mime_type' => 'image/jpeg',
944                                                        'fail_id3'  => 'ERROR',
945                                                        'fail_ape'  => 'ERROR',
946                                                ),
947
948                                // PCD  - still image - Kodak Photo CD
949                                'pcd'  => array(
950                                                        'pattern'   => '^.{2048}PCD_IPI\x00',
951                                                        'group'     => 'graphic',
952                                                        'module'    => 'pcd',
953                                                        'mime_type' => 'image/x-photo-cd',
954                                                        'fail_id3'  => 'ERROR',
955                                                        'fail_ape'  => 'ERROR',
956                                                ),
957
958
959                                // PNG  - still image - Portable Network Graphics (PNG)
960                                'png'  => array(
961                                                        'pattern'   => '^\x89\x50\x4E\x47\x0D\x0A\x1A\x0A',
962                                                        'group'     => 'graphic',
963                                                        'module'    => 'png',
964                                                        'mime_type' => 'image/png',
965                                                        'fail_id3'  => 'ERROR',
966                                                        'fail_ape'  => 'ERROR',
967                                                ),
968
969
970                                // SVG  - still image - Scalable Vector Graphics (SVG)
971                                'svg'  => array(
972                                                        'pattern'   => '(<!DOCTYPE svg PUBLIC |xmlns="http:\/\/www\.w3\.org\/2000\/svg")',
973                                                        'group'     => 'graphic',
974                                                        'module'    => 'svg',
975                                                        'mime_type' => 'image/svg+xml',
976                                                        'fail_id3'  => 'ERROR',
977                                                        'fail_ape'  => 'ERROR',
978                                                ),
979
980
981                                // TIFF - still image - Tagged Information File Format (TIFF)
982                                'tiff' => array(
983                                                        'pattern'   => '^(II\x2A\x00|MM\x00\x2A)',
984                                                        'group'     => 'graphic',
985                                                        'module'    => 'tiff',
986                                                        'mime_type' => 'image/tiff',
987                                                        'fail_id3'  => 'ERROR',
988                                                        'fail_ape'  => 'ERROR',
989                                                ),
990
991
992                                // EFAX - still image - eFax (TIFF derivative)
993                                'efax'  => array(
994                                                        'pattern'   => '^\xDC\xFE',
995                                                        'group'     => 'graphic',
996                                                        'module'    => 'efax',
997                                                        'mime_type' => 'image/efax',
998                                                        'fail_id3'  => 'ERROR',
999                                                        'fail_ape'  => 'ERROR',
1000                                                ),
1001
1002
1003                                // Data formats
1004
1005                                // ISO  - data        - International Standards Organization (ISO) CD-ROM Image
1006                                'iso'  => array(
1007                                                        'pattern'   => '^.{32769}CD001',
1008                                                        'group'     => 'misc',
1009                                                        'module'    => 'iso',
1010                                                        'mime_type' => 'application/octet-stream',
1011                                                        'fail_id3'  => 'ERROR',
1012                                                        'fail_ape'  => 'ERROR',
1013                                                        'iconv_req' => false,
1014                                                ),
1015
1016                                // RAR  - data        - RAR compressed data
1017                                'rar'  => array(
1018                                                        'pattern'   => '^Rar\!',
1019                                                        'group'     => 'archive',
1020                                                        'module'    => 'rar',
1021                                                        'mime_type' => 'application/octet-stream',
1022                                                        'fail_id3'  => 'ERROR',
1023                                                        'fail_ape'  => 'ERROR',
1024                                                ),
1025
1026                                // SZIP - audio/data  - SZIP compressed data
1027                                'szip' => array(
1028                                                        'pattern'   => '^SZ\x0A\x04',
1029                                                        'group'     => 'archive',
1030                                                        'module'    => 'szip',
1031                                                        'mime_type' => 'application/octet-stream',
1032                                                        'fail_id3'  => 'ERROR',
1033                                                        'fail_ape'  => 'ERROR',
1034                                                ),
1035
1036                                // TAR  - data        - TAR compressed data
1037                                'tar'  => array(
1038                                                        'pattern'   => '^.{100}[0-9\x20]{7}\x00[0-9\x20]{7}\x00[0-9\x20]{7}\x00[0-9\x20\x00]{12}[0-9\x20\x00]{12}',
1039                                                        'group'     => 'archive',
1040                                                        'module'    => 'tar',
1041                                                        'mime_type' => 'application/x-tar',
1042                                                        'fail_id3'  => 'ERROR',
1043                                                        'fail_ape'  => 'ERROR',
1044                                                ),
1045
1046                                // GZIP  - data        - GZIP compressed data
1047                                'gz'  => array(
1048                                                        'pattern'   => '^\x1F\x8B\x08',
1049                                                        'group'     => 'archive',
1050                                                        'module'    => 'gzip',
1051                                                        'mime_type' => 'application/x-gzip',
1052                                                        'fail_id3'  => 'ERROR',
1053                                                        'fail_ape'  => 'ERROR',
1054                                                ),
1055
1056                                // ZIP  - data         - ZIP compressed data
1057                                'zip'  => array(
1058                                                        'pattern'   => '^PK\x03\x04',
1059                                                        'group'     => 'archive',
1060                                                        'module'    => 'zip',
1061                                                        'mime_type' => 'application/zip',
1062                                                        'fail_id3'  => 'ERROR',
1063                                                        'fail_ape'  => 'ERROR',
1064                                                ),
1065
1066
1067                                // Misc other formats
1068
1069                                // PAR2 - data        - Parity Volume Set Specification 2.0
1070                                'par2' => array (
1071                                                        'pattern'   => '^PAR2\x00PKT',
1072                                                        'group'     => 'misc',
1073                                                        'module'    => 'par2',
1074                                                        'mime_type' => 'application/octet-stream',
1075                                                        'fail_id3'  => 'ERROR',
1076                                                        'fail_ape'  => 'ERROR',
1077                                                ),
1078
1079                                // PDF  - data        - Portable Document Format
1080                                'pdf'  => array(
1081                                                        'pattern'   => '^\x25PDF',
1082                                                        'group'     => 'misc',
1083                                                        'module'    => 'pdf',
1084                                                        'mime_type' => 'application/pdf',
1085                                                        'fail_id3'  => 'ERROR',
1086                                                        'fail_ape'  => 'ERROR',
1087                                                ),
1088
1089                                // MSOFFICE  - data   - ZIP compressed data
1090                                'msoffice' => array(
1091                                                        'pattern'   => '^\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1', // D0CF11E == DOCFILE == Microsoft Office Document
1092                                                        'group'     => 'misc',
1093                                                        'module'    => 'msoffice',
1094                                                        'mime_type' => 'application/octet-stream',
1095                                                        'fail_id3'  => 'ERROR',
1096                                                        'fail_ape'  => 'ERROR',
1097                                                ),
1098
1099                                 // CUE  - data       - CUEsheet (index to single-file disc images)
1100                                 'cue' => array(
1101                                                        'pattern'   => '', // empty pattern means cannot be automatically detected, will fall through all other formats and match based on filename and very basic file contents
1102                                                        'group'     => 'misc',
1103                                                        'module'    => 'cue',
1104                                                        'mime_type' => 'application/octet-stream',
1105                                                   ),
1106
1107                        );
1108                }
1109
1110                return $format_info;
1111        }
1112
1113
1114
1115        public function GetFileFormat(&$filedata, $filename='') {
1116                // this function will determine the format of a file based on usually
1117                // the first 2-4 bytes of the file (8 bytes for PNG, 16 bytes for JPG,
1118                // and in the case of ISO CD image, 6 bytes offset 32kb from the start
1119                // of the file).
1120
1121                // Identify file format - loop through $format_info and detect with reg expr
1122                foreach ($this->GetFileFormatArray() as $format_name => $info) {
1123                        // The /s switch on preg_match() forces preg_match() NOT to treat
1124                        // newline (0x0A) characters as special chars but do a binary match
1125                        if (!empty($info['pattern']) && preg_match('#'.$info['pattern'].'#s', $filedata)) {
1126                                $info['include'] = 'module.'.$info['group'].'.'.$info['module'].'.php';
1127                                return $info;
1128                        }
1129                }
1130
1131
1132                if (preg_match('#\.mp[123a]$#i', $filename)) {
1133                        // Too many mp3 encoders on the market put gabage in front of mpeg files
1134                        // use assume format on these if format detection failed
1135                        $GetFileFormatArray = $this->GetFileFormatArray();
1136                        $info = $GetFileFormatArray['mp3'];
1137                        $info['include'] = 'module.'.$info['group'].'.'.$info['module'].'.php';
1138                        return $info;
1139                } elseif (preg_match('/\.cue$/i', $filename) && preg_match('#FILE "[^"]+" (BINARY|MOTOROLA|AIFF|WAVE|MP3)#', $filedata)) {
1140                        // there's not really a useful consistent "magic" at the beginning of .cue files to identify them
1141                        // so until I think of something better, just go by filename if all other format checks fail
1142                        // and verify there's at least one instance of "TRACK xx AUDIO" in the file
1143                        $GetFileFormatArray = $this->GetFileFormatArray();
1144                        $info = $GetFileFormatArray['cue'];
1145                        $info['include']   = 'module.'.$info['group'].'.'.$info['module'].'.php';
1146                        return $info;
1147                }
1148
1149                return false;
1150        }
1151
1152
1153        // converts array to $encoding charset from $this->encoding
1154        public function CharConvert(&$array, $encoding) {
1155
1156                // identical encoding - end here
1157                if ($encoding == $this->encoding) {
1158                        return;
1159                }
1160
1161                // loop thru array
1162                foreach ($array as $key => $value) {
1163
1164                        // go recursive
1165                        if (is_array($value)) {
1166                                $this->CharConvert($array[$key], $encoding);
1167                        }
1168
1169                        // convert string
1170                        elseif (is_string($value)) {
1171                                $array[$key] = trim(getid3_lib::iconv_fallback($encoding, $this->encoding, $value));
1172                        }
1173                }
1174        }
1175
1176
1177        public function HandleAllTags() {
1178
1179                // key name => array (tag name, character encoding)
1180                static $tags;
1181                if (empty($tags)) {
1182                        $tags = array(
1183                                'asf'       => array('asf'           , 'UTF-16LE'),
1184                                'midi'      => array('midi'          , 'ISO-8859-1'),
1185                                'nsv'       => array('nsv'           , 'ISO-8859-1'),
1186                                'ogg'       => array('vorbiscomment' , 'UTF-8'),
1187                                'png'       => array('png'           , 'UTF-8'),
1188                                'tiff'      => array('tiff'          , 'ISO-8859-1'),
1189                                'quicktime' => array('quicktime'     , 'UTF-8'),
1190                                'real'      => array('real'          , 'ISO-8859-1'),
1191                                'vqf'       => array('vqf'           , 'ISO-8859-1'),
1192                                'zip'       => array('zip'           , 'ISO-8859-1'),
1193                                'riff'      => array('riff'          , 'ISO-8859-1'),
1194                                'lyrics3'   => array('lyrics3'       , 'ISO-8859-1'),
1195                                'id3v1'     => array('id3v1'         , $this->encoding_id3v1),
1196                                'id3v2'     => array('id3v2'         , 'UTF-8'), // not according to the specs (every frame can have a different encoding), but getID3() force-converts all encodings to UTF-8
1197                                'ape'       => array('ape'           , 'UTF-8'),
1198                                'cue'       => array('cue'           , 'ISO-8859-1'),
1199                                'matroska'  => array('matroska'      , 'UTF-8'),
1200                                'flac'      => array('vorbiscomment' , 'UTF-8'),
1201                                'divxtag'   => array('divx'          , 'ISO-8859-1'),
1202                                'iptc'      => array('iptc'          , 'ISO-8859-1'),
1203                        );
1204                }
1205
1206                // loop through comments array
1207                foreach ($tags as $comment_name => $tagname_encoding_array) {
1208                        list($tag_name, $encoding) = $tagname_encoding_array;
1209
1210                        // fill in default encoding type if not already present
1211                        if (isset($this->info[$comment_name]) && !isset($this->info[$comment_name]['encoding'])) {
1212                                $this->info[$comment_name]['encoding'] = $encoding;
1213                        }
1214
1215                        // copy comments if key name set
1216                        if (!empty($this->info[$comment_name]['comments'])) {
1217                                foreach ($this->info[$comment_name]['comments'] as $tag_key => $valuearray) {
1218                                        foreach ($valuearray as $key => $value) {
1219                                                if (is_string($value)) {
1220                                                        $value = trim($value, " \r\n\t"); // do not trim nulls from $value!! Unicode characters will get mangled if trailing nulls are removed!
1221                                                }
1222                                                if ($value) {
1223                                                        if (!is_numeric($key)) {
1224                                                                $this->info['tags'][trim($tag_name)][trim($tag_key)][$key] = $value;
1225                                                        } else {
1226                                                                $this->info['tags'][trim($tag_name)][trim($tag_key)][]     = $value;
1227                                                        }
1228                                                }
1229                                        }
1230                                        if ($tag_key == 'picture') {
1231                                                unset($this->info[$comment_name]['comments'][$tag_key]);
1232                                        }
1233                                }
1234
1235                                if (!isset($this->info['tags'][$tag_name])) {
1236                                        // comments are set but contain nothing but empty strings, so skip
1237                                        continue;
1238                                }
1239
1240                                if ($this->option_tags_html) {
1241                                        foreach ($this->info['tags'][$tag_name] as $tag_key => $valuearray) {
1242                                                $this->info['tags_html'][$tag_name][$tag_key] = getid3_lib::recursiveMultiByteCharString2HTML($valuearray, $encoding);
1243                                        }
1244                                }
1245
1246                                // ID3v1 encoding detection hack start
1247                                // ID3v1 is defined as always using ISO-8859-1 encoding, but it is not uncommon to find files tagged with ID3v1 using Windows-1251 or other character sets
1248                                // Since ID3v1 has no concept of character sets there is no certain way to know we have the correct non-ISO-8859-1 character set, but we can guess
1249                                if ($comment_name == 'id3v1') {
1250                                        if ($encoding == 'ISO-8859-1') {
1251                                                if (function_exists('iconv')) {
1252                                                        foreach ($this->info['tags'][$tag_name] as $tag_key => $valuearray) {
1253                                                                foreach ($valuearray as $key => $value) {
1254                                                                        if (preg_match('#^[\\x80-\\xFF]+$#', $value)) {
1255                                                                                foreach (array('windows-1251', 'KOI8-R') as $id3v1_bad_encoding) {
1256                                                                                        if (@iconv($id3v1_bad_encoding, $id3v1_bad_encoding, $value) === $value) {
1257                                                                                                $encoding = $id3v1_bad_encoding;
1258                                                                                                break 3;
1259                                                                                        }
1260                                                                                }
1261                                                                        }
1262                                                                }
1263                                                        }
1264                                                }
1265                                        }
1266                                }
1267                                // ID3v1 encoding detection hack end
1268
1269                                $this->CharConvert($this->info['tags'][$tag_name], $encoding);           // only copy gets converted!
1270                        }
1271
1272                }
1273
1274                // pictures can take up a lot of space, and we don't need multiple copies of them
1275                // let there be a single copy in [comments][picture], and not elsewhere
1276                if (!empty($this->info['tags'])) {
1277                        $unset_keys = array('tags', 'tags_html');
1278                        foreach ($this->info['tags'] as $tagtype => $tagarray) {
1279                                foreach ($tagarray as $tagname => $tagdata) {
1280                                        if ($tagname == 'picture') {
1281                                                foreach ($tagdata as $key => $tagarray) {
1282                                                        $this->info['comments']['picture'][] = $tagarray;
1283                                                        if (isset($tagarray['data']) && isset($tagarray['image_mime'])) {
1284                                                                if (isset($this->info['tags'][$tagtype][$tagname][$key])) {
1285                                                                        unset($this->info['tags'][$tagtype][$tagname][$key]);
1286                                                                }
1287                                                                if (isset($this->info['tags_html'][$tagtype][$tagname][$key])) {
1288                                                                        unset($this->info['tags_html'][$tagtype][$tagname][$key]);
1289                                                                }
1290                                                        }
1291                                                }
1292                                        }
1293                                }
1294                                foreach ($unset_keys as $unset_key) {
1295                                        // remove possible empty keys from (e.g. [tags][id3v2][picture])
1296                                        if (empty($this->info[$unset_key][$tagtype]['picture'])) {
1297                                                unset($this->info[$unset_key][$tagtype]['picture']);
1298                                        }
1299                                        if (empty($this->info[$unset_key][$tagtype])) {
1300                                                unset($this->info[$unset_key][$tagtype]);
1301                                        }
1302                                        if (empty($this->info[$unset_key])) {
1303                                                unset($this->info[$unset_key]);
1304                                        }
1305                                }
1306                                // remove duplicate copy of picture data from (e.g. [id3v2][comments][picture])
1307                                if (isset($this->info[$tagtype]['comments']['picture'])) {
1308                                        unset($this->info[$tagtype]['comments']['picture']);
1309                                }
1310                                if (empty($this->info[$tagtype]['comments'])) {
1311                                        unset($this->info[$tagtype]['comments']);
1312                                }
1313                                if (empty($this->info[$tagtype])) {
1314                                        unset($this->info[$tagtype]);
1315                                }
1316                        }
1317                }
1318                return true;
1319        }
1320
1321        public function getHashdata($algorithm) {
1322                switch ($algorithm) {
1323                        case 'md5':
1324                        case 'sha1':
1325                                break;
1326
1327                        default:
1328                                return $this->error('bad algorithm "'.$algorithm.'" in getHashdata()');
1329                                break;
1330                }
1331
1332                if (!empty($this->info['fileformat']) && !empty($this->info['dataformat']) && ($this->info['fileformat'] == 'ogg') && ($this->info['audio']['dataformat'] == 'vorbis')) {
1333
1334                        // We cannot get an identical md5_data value for Ogg files where the comments
1335                        // span more than 1 Ogg page (compared to the same audio data with smaller
1336                        // comments) using the normal getID3() method of MD5'ing the data between the
1337                        // end of the comments and the end of the file (minus any trailing tags),
1338                        // because the page sequence numbers of the pages that the audio data is on
1339                        // do not match. Under normal circumstances, where comments are smaller than
1340                        // the nominal 4-8kB page size, then this is not a problem, but if there are
1341                        // very large comments, the only way around it is to strip off the comment
1342                        // tags with vorbiscomment and MD5 that file.
1343                        // This procedure must be applied to ALL Ogg files, not just the ones with
1344                        // comments larger than 1 page, because the below method simply MD5's the
1345                        // whole file with the comments stripped, not just the portion after the
1346                        // comments block (which is the standard getID3() method.
1347
1348                        // The above-mentioned problem of comments spanning multiple pages and changing
1349                        // page sequence numbers likely happens for OggSpeex and OggFLAC as well, but
1350                        // currently vorbiscomment only works on OggVorbis files.
1351
1352                        if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
1353
1354                                $this->warning('Failed making system call to vorbiscomment.exe - '.$algorithm.'_data is incorrect - error returned: PHP running in Safe Mode (backtick operator not available)');
1355                                $this->info[$algorithm.'_data'] = false;
1356
1357                        } else {
1358
1359                                // Prevent user from aborting script
1360                                $old_abort = ignore_user_abort(true);
1361
1362                                // Create empty file
1363                                $empty = tempnam(GETID3_TEMP_DIR, 'getID3');
1364                                touch($empty);
1365
1366                                // Use vorbiscomment to make temp file without comments
1367                                $temp = tempnam(GETID3_TEMP_DIR, 'getID3');
1368                                $file = $this->info['filenamepath'];
1369
1370                                if (GETID3_OS_ISWINDOWS) {
1371
1372                                        if (file_exists(GETID3_HELPERAPPSDIR.'vorbiscomment.exe')) {
1373
1374                                                $commandline = '"'.GETID3_HELPERAPPSDIR.'vorbiscomment.exe" -w -c "'.$empty.'" "'.$file.'" "'.$temp.'"';
1375                                                $VorbisCommentError = `$commandline`;
1376
1377                                        } else {
1378
1379                                                $VorbisCommentError = 'vorbiscomment.exe not found in '.GETID3_HELPERAPPSDIR;
1380
1381                                        }
1382
1383                                } else {
1384
1385                                        $commandline = 'vorbiscomment -w -c "'.$empty.'" "'.$file.'" "'.$temp.'" 2>&1';
1386                                        $commandline = 'vorbiscomment -w -c '.escapeshellarg($empty).' '.escapeshellarg($file).' '.escapeshellarg($temp).' 2>&1';
1387                                        $VorbisCommentError = `$commandline`;
1388
1389                                }
1390
1391                                if (!empty($VorbisCommentError)) {
1392
1393                                        $this->info['warning'][]         = 'Failed making system call to vorbiscomment(.exe) - '.$algorithm.'_data will be incorrect. If vorbiscomment is unavailable, please download from http://www.vorbis.com/download.psp and put in the getID3() directory. Error returned: '.$VorbisCommentError;
1394                                        $this->info[$algorithm.'_data']  = false;
1395
1396                                } else {
1397
1398                                        // Get hash of newly created file
1399                                        switch ($algorithm) {
1400                                                case 'md5':
1401                                                        $this->info[$algorithm.'_data'] = md5_file($temp);
1402                                                        break;
1403
1404                                                case 'sha1':
1405                                                        $this->info[$algorithm.'_data'] = sha1_file($temp);
1406                                                        break;
1407                                        }
1408                                }
1409
1410                                // Clean up
1411                                unlink($empty);
1412                                unlink($temp);
1413
1414                                // Reset abort setting
1415                                ignore_user_abort($old_abort);
1416
1417                        }
1418
1419                } else {
1420
1421                        if (!empty($this->info['avdataoffset']) || (isset($this->info['avdataend']) && ($this->info['avdataend'] < $this->info['filesize']))) {
1422
1423                                // get hash from part of file
1424                                $this->info[$algorithm.'_data'] = getid3_lib::hash_data($this->info['filenamepath'], $this->info['avdataoffset'], $this->info['avdataend'], $algorithm);
1425
1426                        } else {
1427
1428                                // get hash from whole file
1429                                switch ($algorithm) {
1430                                        case 'md5':
1431                                                $this->info[$algorithm.'_data'] = md5_file($this->info['filenamepath']);
1432                                                break;
1433
1434                                        case 'sha1':
1435                                                $this->info[$algorithm.'_data'] = sha1_file($this->info['filenamepath']);
1436                                                break;
1437                                }
1438                        }
1439
1440                }
1441                return true;
1442        }
1443
1444
1445        public function ChannelsBitratePlaytimeCalculations() {
1446
1447                // set channelmode on audio
1448                if (!empty($this->info['audio']['channelmode']) || !isset($this->info['audio']['channels'])) {
1449                        // ignore
1450                } elseif ($this->info['audio']['channels'] == 1) {
1451                        $this->info['audio']['channelmode'] = 'mono';
1452                } elseif ($this->info['audio']['channels'] == 2) {
1453                        $this->info['audio']['channelmode'] = 'stereo';
1454                }
1455
1456                // Calculate combined bitrate - audio + video
1457                $CombinedBitrate  = 0;
1458                $CombinedBitrate += (isset($this->info['audio']['bitrate']) ? $this->info['audio']['bitrate'] : 0);
1459                $CombinedBitrate += (isset($this->info['video']['bitrate']) ? $this->info['video']['bitrate'] : 0);
1460                if (($CombinedBitrate > 0) && empty($this->info['bitrate'])) {
1461                        $this->info['bitrate'] = $CombinedBitrate;
1462                }
1463                //if ((isset($this->info['video']) && !isset($this->info['video']['bitrate'])) || (isset($this->info['audio']) && !isset($this->info['audio']['bitrate']))) {
1464                //      // for example, VBR MPEG video files cannot determine video bitrate:
1465                //      // should not set overall bitrate and playtime from audio bitrate only
1466                //      unset($this->info['bitrate']);
1467                //}
1468
1469                // video bitrate undetermined, but calculable
1470                if (isset($this->info['video']['dataformat']) && $this->info['video']['dataformat'] && (!isset($this->info['video']['bitrate']) || ($this->info['video']['bitrate'] == 0))) {
1471                        // if video bitrate not set
1472                        if (isset($this->info['audio']['bitrate']) && ($this->info['audio']['bitrate'] > 0) && ($this->info['audio']['bitrate'] == $this->info['bitrate'])) {
1473                                // AND if audio bitrate is set to same as overall bitrate
1474                                if (isset($this->info['playtime_seconds']) && ($this->info['playtime_seconds'] > 0)) {
1475                                        // AND if playtime is set
1476                                        if (isset($this->info['avdataend']) && isset($this->info['avdataoffset'])) {
1477                                                // AND if AV data offset start/end is known
1478                                                // THEN we can calculate the video bitrate
1479                                                $this->info['bitrate'] = round((($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['playtime_seconds']);
1480                                                $this->info['video']['bitrate'] = $this->info['bitrate'] - $this->info['audio']['bitrate'];
1481                                        }
1482                                }
1483                        }
1484                }
1485
1486                if ((!isset($this->info['playtime_seconds']) || ($this->info['playtime_seconds'] <= 0)) && !empty($this->info['bitrate'])) {
1487                        $this->info['playtime_seconds'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['bitrate'];
1488                }
1489
1490                if (!isset($this->info['bitrate']) && !empty($this->info['playtime_seconds'])) {
1491                        $this->info['bitrate'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['playtime_seconds'];
1492                }
1493                if (isset($this->info['bitrate']) && empty($this->info['audio']['bitrate']) && empty($this->info['video']['bitrate'])) {
1494                        if (isset($this->info['audio']['dataformat']) && empty($this->info['video']['resolution_x'])) {
1495                                // audio only
1496                                $this->info['audio']['bitrate'] = $this->info['bitrate'];
1497                        } elseif (isset($this->info['video']['resolution_x']) && empty($this->info['audio']['dataformat'])) {
1498                                // video only
1499                                $this->info['video']['bitrate'] = $this->info['bitrate'];
1500                        }
1501                }
1502
1503                // Set playtime string
1504                if (!empty($this->info['playtime_seconds']) && empty($this->info['playtime_string'])) {
1505                        $this->info['playtime_string'] = getid3_lib::PlaytimeString($this->info['playtime_seconds']);
1506                }
1507        }
1508
1509
1510        public function CalculateCompressionRatioVideo() {
1511                if (empty($this->info['video'])) {
1512                        return false;
1513                }
1514                if (empty($this->info['video']['resolution_x']) || empty($this->info['video']['resolution_y'])) {
1515                        return false;
1516                }
1517                if (empty($this->info['video']['bits_per_sample'])) {
1518                        return false;
1519                }
1520
1521                switch ($this->info['video']['dataformat']) {
1522                        case 'bmp':
1523                        case 'gif':
1524                        case 'jpeg':
1525                        case 'jpg':
1526                        case 'png':
1527                        case 'tiff':
1528                                $FrameRate = 1;
1529                                $PlaytimeSeconds = 1;
1530                                $BitrateCompressed = $this->info['filesize'] * 8;
1531                                break;
1532
1533                        default:
1534                                if (!empty($this->info['video']['frame_rate'])) {
1535                                        $FrameRate = $this->info['video']['frame_rate'];
1536                                } else {
1537                                        return false;
1538                                }
1539                                if (!empty($this->info['playtime_seconds'])) {
1540                                        $PlaytimeSeconds = $this->info['playtime_seconds'];
1541                                } else {
1542                                        return false;
1543                                }
1544                                if (!empty($this->info['video']['bitrate'])) {
1545                                        $BitrateCompressed = $this->info['video']['bitrate'];
1546                                } else {
1547                                        return false;
1548                                }
1549                                break;
1550                }
1551                $BitrateUncompressed = $this->info['video']['resolution_x'] * $this->info['video']['resolution_y'] * $this->info['video']['bits_per_sample'] * $FrameRate;
1552
1553                $this->info['video']['compression_ratio'] = $BitrateCompressed / $BitrateUncompressed;
1554                return true;
1555        }
1556
1557
1558        public function CalculateCompressionRatioAudio() {
1559                if (empty($this->info['audio']['bitrate']) || empty($this->info['audio']['channels']) || empty($this->info['audio']['sample_rate']) || !is_numeric($this->info['audio']['sample_rate'])) {
1560                        return false;
1561                }
1562                $this->info['audio']['compression_ratio'] = $this->info['audio']['bitrate'] / ($this->info['audio']['channels'] * $this->info['audio']['sample_rate'] * (!empty($this->info['audio']['bits_per_sample']) ? $this->info['audio']['bits_per_sample'] : 16));
1563
1564                if (!empty($this->info['audio']['streams'])) {
1565                        foreach ($this->info['audio']['streams'] as $streamnumber => $streamdata) {
1566                                if (!empty($streamdata['bitrate']) && !empty($streamdata['channels']) && !empty($streamdata['sample_rate'])) {
1567                                        $this->info['audio']['streams'][$streamnumber]['compression_ratio'] = $streamdata['bitrate'] / ($streamdata['channels'] * $streamdata['sample_rate'] * (!empty($streamdata['bits_per_sample']) ? $streamdata['bits_per_sample'] : 16));
1568                                }
1569                        }
1570                }
1571                return true;
1572        }
1573
1574
1575        public function CalculateReplayGain() {
1576                if (isset($this->info['replay_gain'])) {
1577                        if (!isset($this->info['replay_gain']['reference_volume'])) {
1578                                $this->info['replay_gain']['reference_volume'] = (double) 89.0;
1579                        }
1580                        if (isset($this->info['replay_gain']['track']['adjustment'])) {
1581                                $this->info['replay_gain']['track']['volume'] = $this->info['replay_gain']['reference_volume'] - $this->info['replay_gain']['track']['adjustment'];
1582                        }
1583                        if (isset($this->info['replay_gain']['album']['adjustment'])) {
1584                                $this->info['replay_gain']['album']['volume'] = $this->info['replay_gain']['reference_volume'] - $this->info['replay_gain']['album']['adjustment'];
1585                        }
1586
1587                        if (isset($this->info['replay_gain']['track']['peak'])) {
1588                                $this->info['replay_gain']['track']['max_noclip_gain'] = 0 - getid3_lib::RGADamplitude2dB($this->info['replay_gain']['track']['peak']);
1589                        }
1590                        if (isset($this->info['replay_gain']['album']['peak'])) {
1591                                $this->info['replay_gain']['album']['max_noclip_gain'] = 0 - getid3_lib::RGADamplitude2dB($this->info['replay_gain']['album']['peak']);
1592                        }
1593                }
1594                return true;
1595        }
1596
1597        public function ProcessAudioStreams() {
1598                if (!empty($this->info['audio']['bitrate']) || !empty($this->info['audio']['channels']) || !empty($this->info['audio']['sample_rate'])) {
1599                        if (!isset($this->info['audio']['streams'])) {
1600                                foreach ($this->info['audio'] as $key => $value) {
1601                                        if ($key != 'streams') {
1602                                                $this->info['audio']['streams'][0][$key] = $value;
1603                                        }
1604                                }
1605                        }
1606                }
1607                return true;
1608        }
1609
1610        public function getid3_tempnam() {
1611                return tempnam($this->tempdir, 'gI3');
1612        }
1613
1614        public function include_module($name) {
1615                //if (!file_exists($this->include_path.'module.'.$name.'.php')) {
1616                if (!file_exists(GETID3_INCLUDEPATH.'module.'.$name.'.php')) {
1617                        throw new getid3_exception('Required module.'.$name.'.php is missing.');
1618                }
1619                include_once(GETID3_INCLUDEPATH.'module.'.$name.'.php');
1620                return true;
1621        }
1622
1623}
1624
1625
1626abstract class getid3_handler {
1627
1628        /**
1629        * @var getID3
1630        */
1631        protected $getid3;                       // pointer
1632
1633        protected $data_string_flag     = false; // analyzing filepointer or string
1634        protected $data_string          = '';    // string to analyze
1635        protected $data_string_position = 0;     // seek position in string
1636        protected $data_string_length   = 0;     // string length
1637
1638        private $dependency_to = null;
1639
1640
1641        public function __construct(getID3 $getid3, $call_module=null) {
1642                $this->getid3 = $getid3;
1643
1644                if ($call_module) {
1645                        $this->dependency_to = str_replace('getid3_', '', $call_module);
1646                }
1647        }
1648
1649
1650        // Analyze from file pointer
1651        abstract public function Analyze();
1652
1653
1654        // Analyze from string instead
1655        public function AnalyzeString($string) {
1656                // Enter string mode
1657                $this->setStringMode($string);
1658
1659                // Save info
1660                $saved_avdataoffset = $this->getid3->info['avdataoffset'];
1661                $saved_avdataend    = $this->getid3->info['avdataend'];
1662                $saved_filesize     = (isset($this->getid3->info['filesize']) ? $this->getid3->info['filesize'] : null); // may be not set if called as dependency without openfile() call
1663
1664                // Reset some info
1665                $this->getid3->info['avdataoffset'] = 0;
1666                $this->getid3->info['avdataend']    = $this->getid3->info['filesize'] = $this->data_string_length;
1667
1668                // Analyze
1669                $this->Analyze();
1670
1671                // Restore some info
1672                $this->getid3->info['avdataoffset'] = $saved_avdataoffset;
1673                $this->getid3->info['avdataend']    = $saved_avdataend;
1674                $this->getid3->info['filesize']     = $saved_filesize;
1675
1676                // Exit string mode
1677                $this->data_string_flag = false;
1678        }
1679
1680        public function setStringMode($string) {
1681                $this->data_string_flag   = true;
1682                $this->data_string        = $string;
1683                $this->data_string_length = strlen($string);
1684        }
1685
1686        protected function ftell() {
1687                if ($this->data_string_flag) {
1688                        return $this->data_string_position;
1689                }
1690                return ftell($this->getid3->fp);
1691        }
1692
1693        protected function fread($bytes) {
1694                if ($this->data_string_flag) {
1695                        $this->data_string_position += $bytes;
1696                        return substr($this->data_string, $this->data_string_position - $bytes, $bytes);
1697                }
1698                $pos = $this->ftell() + $bytes;
1699                if (!getid3_lib::intValueSupported($pos)) {
1700                        throw new getid3_exception('cannot fread('.$bytes.' from '.$this->ftell().') because beyond PHP filesystem limit', 10);
1701                }
1702                return fread($this->getid3->fp, $bytes);
1703        }
1704
1705        protected function fseek($bytes, $whence=SEEK_SET) {
1706                if ($this->data_string_flag) {
1707                        switch ($whence) {
1708                                case SEEK_SET:
1709                                        $this->data_string_position = $bytes;
1710                                        break;
1711
1712                                case SEEK_CUR:
1713                                        $this->data_string_position += $bytes;
1714                                        break;
1715
1716                                case SEEK_END:
1717                                        $this->data_string_position = $this->data_string_length + $bytes;
1718                                        break;
1719                        }
1720                        return 0;
1721                } else {
1722                        $pos = $bytes;
1723                        if ($whence == SEEK_CUR) {
1724                                $pos = $this->ftell() + $bytes;
1725                        } elseif ($whence == SEEK_END) {
1726                                $pos = $this->getid3->info['filesize'] + $bytes;
1727                        }
1728                        if (!getid3_lib::intValueSupported($pos)) {
1729                                throw new getid3_exception('cannot fseek('.$pos.') because beyond PHP filesystem limit', 10);
1730                        }
1731                }
1732                return fseek($this->getid3->fp, $bytes, $whence);
1733        }
1734
1735        protected function feof() {
1736                if ($this->data_string_flag) {
1737                        return $this->data_string_position >= $this->data_string_length;
1738                }
1739                return feof($this->getid3->fp);
1740        }
1741
1742        final protected function isDependencyFor($module) {
1743                return $this->dependency_to == $module;
1744        }
1745
1746        protected function error($text) {
1747                $this->getid3->info['error'][] = $text;
1748
1749                return false;
1750        }
1751
1752        protected function warning($text) {
1753                return $this->getid3->warning($text);
1754        }
1755
1756        protected function notice($text) {
1757                // does nothing for now
1758        }
1759
1760        public function saveAttachment($name, $offset, $length, $image_mime=null) {
1761                try {
1762
1763                        // do not extract at all
1764                        if ($this->getid3->option_save_attachments === getID3::ATTACHMENTS_NONE) {
1765
1766                                $attachment = null; // do not set any
1767
1768                        // extract to return array
1769                        } elseif ($this->getid3->option_save_attachments === getID3::ATTACHMENTS_INLINE) {
1770
1771                                $this->fseek($offset);
1772                                $attachment = $this->fread($length); // get whole data in one pass, till it is anyway stored in memory
1773                                if ($attachment === false || strlen($attachment) != $length) {
1774                                        throw new Exception('failed to read attachment data');
1775                                }
1776
1777                        // assume directory path is given
1778                        } else {
1779
1780                                // set up destination path
1781                                $dir = rtrim(str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $this->getid3->option_save_attachments), DIRECTORY_SEPARATOR);
1782                                if (!is_dir($dir) || !is_writable($dir)) { // check supplied directory
1783                                        throw new Exception('supplied path ('.$dir.') does not exist, or is not writable');
1784                                }
1785                                $dest = $dir.DIRECTORY_SEPARATOR.$name.($image_mime ? '.'.getid3_lib::ImageExtFromMime($image_mime) : '');
1786
1787                                // create dest file
1788                                if (($fp_dest = fopen($dest, 'wb')) == false) {
1789                                        throw new Exception('failed to create file '.$dest);
1790                                }
1791
1792                                // copy data
1793                                $this->fseek($offset);
1794                                $buffersize = ($this->data_string_flag ? $length : $this->getid3->fread_buffer_size());
1795                                $bytesleft = $length;
1796                                while ($bytesleft > 0) {
1797                                        if (($buffer = $this->fread(min($buffersize, $bytesleft))) === false || ($byteswritten = fwrite($fp_dest, $buffer)) === false || ($byteswritten === 0)) {
1798                                                throw new Exception($buffer === false ? 'not enough data to read' : 'failed to write to destination file, may be not enough disk space');
1799                                        }
1800                                        $bytesleft -= $byteswritten;
1801                                }
1802
1803                                fclose($fp_dest);
1804                                $attachment = $dest;
1805
1806                        }
1807
1808                } catch (Exception $e) {
1809
1810                        // close and remove dest file if created
1811                        if (isset($fp_dest) && is_resource($fp_dest)) {
1812                                fclose($fp_dest);
1813                                unlink($dest);
1814                        }
1815
1816                        // do not set any is case of error
1817                        $attachment = null;
1818                        $this->warning('Failed to extract attachment '.$name.': '.$e->getMessage());
1819
1820                }
1821
1822                // seek to the end of attachment
1823                $this->fseek($offset + $length);
1824
1825                return $attachment;
1826        }
1827
1828}
1829
1830
1831class getid3_exception extends Exception
1832{
1833        public $message;
1834}
Note: See TracBrowser for help on using the repository browser.