getID3 Class Reference
Inheritance diagram for getID3:
Collaboration diagram for getID3:
Public Member Functions | |
| __construct () | |
| version () | |
| fread_buffer_size () | |
| setOption ($optArray) | |
| openfile ($filename, $filesize=null) | |
| analyze ($filename, $filesize=null, $original_filename='') | |
| error ($message) | |
| warning ($message) | |
| GetFileFormatArray () | |
| GetFileFormat (&$filedata, $filename='') | |
| CharConvert (&$array, $encoding) | |
| HandleAllTags () | |
| getHashdata ($algorithm) | |
| ChannelsBitratePlaytimeCalculations () | |
| CalculateCompressionRatioVideo () | |
| CalculateCompressionRatioAudio () | |
| CalculateReplayGain () | |
| ProcessAudioStreams () | |
| getid3_tempnam () | |
| include_module ($name) | |
Data Fields | |
| $encoding = 'UTF-8' | |
| $encoding_id3v1 = 'ISO-8859-1' | |
| $option_tag_id3v1 = true | |
| $option_tag_id3v2 = true | |
| $option_tag_lyrics3 = true | |
| $option_tag_apetag = true | |
| $option_tags_process = true | |
| $option_tags_html = true | |
| $option_extra_info = true | |
| $option_save_attachments = true | |
| $option_md5_data = false | |
| $option_md5_data_source = false | |
| $option_sha1_data = false | |
| $option_max_2gb_check = null | |
| $option_fread_buffer_size = 32768 | |
| $filename | |
| $fp | |
| $info | |
| $tempdir = GETID3_TEMP_DIR | |
| $memory_limit = 0 | |
| const | VERSION = '1.9.14-201703261440' |
| const | FREAD_BUFFER_SIZE = 32768 |
| const | ATTACHMENTS_NONE = false |
| const | ATTACHMENTS_INLINE = true |
Protected Attributes | |
| $startup_error = '' | |
| $startup_warning = '' | |
Private Member Functions | |
| CleanUp () | |
Detailed Description
Definition at line 75 of file getid3.php.
Constructor & Destructor Documentation
◆ __construct()
| getID3::__construct | ( | ) |
Definition at line 122 of file getid3.php.
122 {
123
124 // Check for PHP version
125 $required_php_version = '5.3.0';
126 if (version_compare(PHP_VERSION, $required_php_version, '<')) {
127 $this->startup_error .= 'getID3() requires PHP v'.$required_php_version.' or higher - you are running v'.PHP_VERSION."\n";
128 return false;
129 }
130
131 // Check memory
132 $this->memory_limit = ini_get('memory_limit');
133 if (preg_match('#([0-9]+)M#i', $this->memory_limit, $matches)) {
134 // could be stored as "16M" rather than 16777216 for example
135 $this->memory_limit = $matches[1] * 1048576;
136 } elseif (preg_match('#([0-9]+)G#i', $this->memory_limit, $matches)) { // The 'G' modifier is available since PHP 5.1.0
137 // could be stored as "2G" rather than 2147483648 for example
138 $this->memory_limit = $matches[1] * 1073741824;
139 }
140 if ($this->memory_limit <= 0) {
141 // memory limits probably disabled
142 } elseif ($this->memory_limit <= 4194304) {
143 $this->startup_error .= 'PHP has less than 4MB available memory and will very likely run out. Increase memory_limit in php.ini'."\n";
144 } elseif ($this->memory_limit <= 12582912) {
145 $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'."\n";
146 }
147
148 // Check safe_mode off
149 if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
150 $this->warning('WARNING: Safe mode is on, shorten support disabled, md5data/sha1data for ogg vorbis disabled, ogg vorbos/flac tag writing disabled.');
151 }
152
153 if (($mbstring_func_overload = ini_get('mbstring.func_overload')) && ($mbstring_func_overload & 0x02)) {
154 // http://php.net/manual/en/mbstring.overload.php
155 // "mbstring.func_overload in php.ini is a positive value that represents a combination of bitmasks specifying the categories of functions to be overloaded. It should be set to 1 to overload the mail() function. 2 for string functions, 4 for regular expression functions"
156 // getID3 cannot run when string functions are overloaded. It doesn't matter if mail() or ereg* functions are overloaded since getID3 does not use those.
157 $this->startup_error .= 'WARNING: php.ini contains "mbstring.func_overload = '.ini_get('mbstring.func_overload').'", getID3 cannot run with this setting (bitmask 2 (string functions) cannot be set). Recommended to disable entirely.'."\n";
158 }
159
160 // Check for magic_quotes_runtime
161 if (function_exists('get_magic_quotes_runtime')) {
162 if (get_magic_quotes_runtime()) {
163 $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).'."\n";
164 }
165 }
166
167 // Check for magic_quotes_gpc
168 if (function_exists('magic_quotes_gpc')) {
169 if (get_magic_quotes_gpc()) {
170 $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).'."\n";
171 }
172 }
173
174 // Load support library
175 if (!include_once(GETID3_INCLUDEPATH.'getid3.lib.php')) {
176 $this->startup_error .= 'getid3.lib.php is missing or corrupt'."\n";
177 }
178
179 if ($this->option_max_2gb_check === null) {
180 $this->option_max_2gb_check = (PHP_INT_MAX <= 2147483647);
181 }
182
183
184 // Needed for Windows only:
185 // Define locations of helper applications for Shorten, VorbisComment, MetaFLAC
186 // as well as other helper functions such as head, tail, md5sum, etc
187 // This path cannot contain spaces, but the below code will attempt to get the
188 // 8.3-equivalent path automatically
189 // IMPORTANT: This path must include the trailing slash
190 if (GETID3_OS_ISWINDOWS && !defined('GETID3_HELPERAPPSDIR')) {
191
192 $helperappsdir = GETID3_INCLUDEPATH.'..'.DIRECTORY_SEPARATOR.'helperapps'; // must not have any space in this path
193
194 if (!is_dir($helperappsdir)) {
195 $this->startup_warning .= '"'.$helperappsdir.'" cannot be defined as GETID3_HELPERAPPSDIR because it does not exist'."\n";
196 } elseif (strpos(realpath($helperappsdir), ' ') !== false) {
197 $DirPieces = explode(DIRECTORY_SEPARATOR, realpath($helperappsdir));
198 $path_so_far = array();
200 if (strpos($value, ' ') !== false) {
201 if (!empty($path_so_far)) {
202 $commandline = 'dir /x '.escapeshellarg(implode(DIRECTORY_SEPARATOR, $path_so_far));
203 $dir_listing = `$commandline`;
204 $lines = explode("\n", $dir_listing);
205 foreach ($lines as $line) {
206 $line = trim($line);
207 if (preg_match('#^([0-9/]{10}) +([0-9:]{4,5}( [AP]M)?) +(<DIR>|[0-9,]+) +([^ ]{0,11}) +(.+)$#', $line, $matches)) {
210 $value = $shortname;
211 }
212 }
213 }
214 } else {
215 $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.'."\n";
216 }
217 }
218 $path_so_far[] = $value;
219 }
220 $helperappsdir = implode(DIRECTORY_SEPARATOR, $path_so_far);
221 }
222 define('GETID3_HELPERAPPSDIR', $helperappsdir.DIRECTORY_SEPARATOR);
223 }
224
225 if (!empty($this->startup_error)) {
226 echo $this->startup_error;
228 }
229
230 return true;
231 }
Definition: getid3.php:1838
References $filename, $key, $startup_error, $time, and warning().
Here is the call graph for this function:
Member Function Documentation
◆ analyze()
| getID3::analyze | ( | $filename, | |
$filesize = null, |
|||
$original_filename = '' |
|||
| ) |
Reimplemented in getID3_cached_mysql, getID3_cached_mysqli, and getID3_cached_sqlite3.
Definition at line 357 of file getid3.php.
357 {
358 try {
361 }
362
363 // Handle tags
364 foreach (array('id3v2'=>'id3v2', 'id3v1'=>'id3v1', 'apetag'=>'ape', 'lyrics3'=>'lyrics3') as $tag_name => $tag_key) {
365 $option_tag = 'option_tag_'.$tag_name;
366 if ($this->$option_tag) {
368 try {
369 $tag_class = 'getid3_'.$tag_name;
371 $tag->Analyze();
372 }
374 throw $e;
375 }
376 }
377 }
379 $this->info['avdataoffset'] = max($this->info['avdataoffset'], $this->info['id3v2']['tag_offset_end']);
380 }
381 foreach (array('id3v1'=>'id3v1', 'apetag'=>'ape', 'lyrics3'=>'lyrics3') as $tag_name => $tag_key) {
383 $this->info['avdataend'] = min($this->info['avdataend'], $this->info[$tag_key]['tag_offset_start']);
384 }
385 }
386
387 // ID3v2 detection (NOT parsing), even if ($this->option_tag_id3v2 == false) done to make fileformat easier
388 if (!$this->option_tag_id3v2) {
389 fseek($this->fp, 0);
390 $header = fread($this->fp, 10);
395 $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
396 }
397 }
398
399 // read 32 kb file data
400 fseek($this->fp, $this->info['avdataoffset']);
401 $formattest = fread($this->fp, 32774);
402
403 // determine format
404 $determined_format = $this->GetFileFormat($formattest, ($original_filename ? $original_filename : $filename));
405
406 // unable to determine file format
407 if (!$determined_format) {
408 fclose($this->fp);
410 }
411
412 // check for illegal ID3 tags
413 if (isset($determined_format['fail_id3']) && (in_array('id3v1', $this->info['tags']) || in_array('id3v2', $this->info['tags']))) {
414 if ($determined_format['fail_id3'] === 'ERROR') {
415 fclose($this->fp);
417 } elseif ($determined_format['fail_id3'] === 'WARNING') {
419 }
420 }
421
422 // check for illegal APE tags
423 if (isset($determined_format['fail_ape']) && in_array('ape', $this->info['tags'])) {
424 if ($determined_format['fail_ape'] === 'ERROR') {
425 fclose($this->fp);
427 } elseif ($determined_format['fail_ape'] === 'WARNING') {
429 }
430 }
431
432 // set mime type
433 $this->info['mime_type'] = $determined_format['mime_type'];
434
435 // supported format signature pattern detected, but module deleted
436 if (!file_exists(GETID3_INCLUDEPATH.$determined_format['include'])) {
437 fclose($this->fp);
438 return $this->error('Format not supported, module "'.$determined_format['include'].'" was removed.');
439 }
440
441 // module requires mb_convert_encoding/iconv support
442 // Check encoding/iconv support
443 if (!empty($determined_format['iconv_req']) && !function_exists('mb_convert_encoding') && !function_exists('iconv') && !in_array($this->encoding, array('ISO-8859-1', 'UTF-8', 'UTF-16LE', 'UTF-16BE', 'UTF-16'))) {
444 $errormessage = 'mb_convert_encoding() or 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. ';
445 if (GETID3_OS_ISWINDOWS) {
446 $errormessage .= 'PHP does not have mb_convert_encoding() or iconv() support. Please enable php_mbstring.dll / php_iconv.dll in php.ini, and copy php_mbstring.dll / iconv.dll from c:/php/dlls to c:/windows/system32';
447 } else {
448 $errormessage .= 'PHP is not compiled with mb_convert_encoding() or iconv() support. Please recompile with the --enable-mbstring / --with-iconv switch';
449 }
451 }
452
453 // include module
454 include_once(GETID3_INCLUDEPATH.$determined_format['include']);
455
456 // instantiate module class
457 $class_name = 'getid3_'.$determined_format['module'];
458 if (!class_exists($class_name)) {
459 return $this->error('Format not supported, module "'.$determined_format['include'].'" is corrupt.');
460 }
461 $class = new $class_name($this);
462 $class->Analyze();
463 unset($class);
464
465 // close file
466 fclose($this->fp);
467
468 // process all tags - copy to 'tags' and convert charsets
469 if ($this->option_tags_process) {
470 $this->HandleAllTags();
471 }
472
473 // perform more calculations
474 if ($this->option_extra_info) {
475 $this->ChannelsBitratePlaytimeCalculations();
476 $this->CalculateCompressionRatioVideo();
477 $this->CalculateCompressionRatioAudio();
478 $this->CalculateReplayGain();
479 $this->ProcessAudioStreams();
480 }
481
482 // get the MD5 sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags
483 if ($this->option_md5_data) {
484 // do not calc md5_data if md5_data_source is present - set by flac only - future MPC/SV8 too
485 if (!$this->option_md5_data_source || empty($this->info['md5_data_source'])) {
487 }
488 }
489
490 // get the SHA1 sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags
491 if ($this->option_sha1_data) {
493 }
494
495 // remove undesired keys
496 $this->CleanUp();
497
498 } catch (Exception $e) {
500 }
501
502 // return info array
504 }
ChannelsBitratePlaytimeCalculations()
Definition: getid3.php:1435
static BigEndian2Int($byteword, $synchsafe=false, $signed=false)
Definition: getid3.lib.php:263
if(function_exists( 'posix_getuid') &&posix_getuid()===0) if(!array_key_exists('t', $options)) $tag
Definition: cron.php:35
References $filename, $header, $info, $tag, getid3_lib\BigEndian2Int(), CalculateCompressionRatioAudio(), CalculateCompressionRatioVideo(), CalculateReplayGain(), ChannelsBitratePlaytimeCalculations(), CleanUp(), error(), GetFileFormat(), getHashdata(), HandleAllTags(), include_module(), info(), openfile(), ProcessAudioStreams(), and warning().
Referenced by getid3_write_apetag\DeleteAPEtag(), getid3_write_lyrics3\DeleteLyrics3(), getid3_write_id3v1\FixID3v1Padding(), getid3_write_id3v2\RemoveID3v2(), getid3_write_real\RemoveReal(), getid3_write_id3v1\setRealFileSize(), getid3_write_apetag\WriteAPEtag(), getid3_write_id3v2\WriteID3v2(), and getid3_write_real\WriteReal().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ CalculateCompressionRatioAudio()
| getID3::CalculateCompressionRatioAudio | ( | ) |
Definition at line 1548 of file getid3.php.
1548 {
1549 if (empty($this->info['audio']['bitrate']) || empty($this->info['audio']['channels']) || empty($this->info['audio']['sample_rate']) || !is_numeric($this->info['audio']['sample_rate'])) {
1550 return false;
1551 }
1552 $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));
1553
1556 if (!empty($streamdata['bitrate']) && !empty($streamdata['channels']) && !empty($streamdata['sample_rate'])) {
1557 $this->info['audio']['streams'][$streamnumber]['compression_ratio'] = $streamdata['bitrate'] / ($streamdata['channels'] * $streamdata['sample_rate'] * (!empty($streamdata['bits_per_sample']) ? $streamdata['bits_per_sample'] : 16));
1558 }
1559 }
1560 }
1561 return true;
1562 }
References info().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ CalculateCompressionRatioVideo()
| getID3::CalculateCompressionRatioVideo | ( | ) |
Definition at line 1500 of file getid3.php.
1500 {
1502 return false;
1503 }
1504 if (empty($this->info['video']['resolution_x']) || empty($this->info['video']['resolution_y'])) {
1505 return false;
1506 }
1508 return false;
1509 }
1510
1512 case 'bmp':
1513 case 'gif':
1514 case 'jpeg':
1515 case 'jpg':
1516 case 'png':
1517 case 'tiff':
1518 $FrameRate = 1;
1519 $PlaytimeSeconds = 1;
1521 break;
1522
1523 default:
1526 } else {
1527 return false;
1528 }
1531 } else {
1532 return false;
1533 }
1536 } else {
1537 return false;
1538 }
1539 break;
1540 }
1541 $BitrateUncompressed = $this->info['video']['resolution_x'] * $this->info['video']['resolution_y'] * $this->info['video']['bits_per_sample'] * $FrameRate;
1542
1544 return true;
1545 }
References info().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ CalculateReplayGain()
| getID3::CalculateReplayGain | ( | ) |
Definition at line 1565 of file getid3.php.
1565 {
1569 }
1571 $this->info['replay_gain']['track']['volume'] = $this->info['replay_gain']['reference_volume'] - $this->info['replay_gain']['track']['adjustment'];
1572 }
1574 $this->info['replay_gain']['album']['volume'] = $this->info['replay_gain']['reference_volume'] - $this->info['replay_gain']['album']['adjustment'];
1575 }
1576
1578 $this->info['replay_gain']['track']['max_noclip_gain'] = 0 - getid3_lib::RGADamplitude2dB($this->info['replay_gain']['track']['peak']);
1579 }
1581 $this->info['replay_gain']['album']['max_noclip_gain'] = 0 - getid3_lib::RGADamplitude2dB($this->info['replay_gain']['album']['peak']);
1582 }
1583 }
1584 return true;
1585 }
References info(), and getid3_lib\RGADamplitude2dB().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ ChannelsBitratePlaytimeCalculations()
| getID3::ChannelsBitratePlaytimeCalculations | ( | ) |
Definition at line 1435 of file getid3.php.
1435 {
1436
1437 // set channelmode on audio
1439 // ignore
1444 }
1445
1446 // Calculate combined bitrate - audio + video
1447 $CombinedBitrate = 0;
1448 $CombinedBitrate += (isset($this->info['audio']['bitrate']) ? $this->info['audio']['bitrate'] : 0);
1449 $CombinedBitrate += (isset($this->info['video']['bitrate']) ? $this->info['video']['bitrate'] : 0);
1452 }
1453 //if ((isset($this->info['video']) && !isset($this->info['video']['bitrate'])) || (isset($this->info['audio']) && !isset($this->info['audio']['bitrate']))) {
1454 // // for example, VBR MPEG video files cannot determine video bitrate:
1455 // // should not set overall bitrate and playtime from audio bitrate only
1456 // unset($this->info['bitrate']);
1457 //}
1458
1459 // video bitrate undetermined, but calculable
1460 if (isset($this->info['video']['dataformat']) && $this->info['video']['dataformat'] && (!isset($this->info['video']['bitrate']) || ($this->info['video']['bitrate'] == 0))) {
1461 // if video bitrate not set
1462 if (isset($this->info['audio']['bitrate']) && ($this->info['audio']['bitrate'] > 0) && ($this->info['audio']['bitrate'] == $this->info['bitrate'])) {
1463 // AND if audio bitrate is set to same as overall bitrate
1465 // AND if playtime is set
1467 // AND if AV data offset start/end is known
1468 // THEN we can calculate the video bitrate
1469 $this->info['bitrate'] = round((($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['playtime_seconds']);
1471 }
1472 }
1473 }
1474 }
1475
1476 if ((!isset($this->info['playtime_seconds']) || ($this->info['playtime_seconds'] <= 0)) && !empty($this->info['bitrate'])) {
1477 $this->info['playtime_seconds'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['bitrate'];
1478 }
1479
1481 $this->info['bitrate'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['playtime_seconds'];
1482 }
1483 if (isset($this->info['bitrate']) && empty($this->info['audio']['bitrate']) && empty($this->info['video']['bitrate'])) {
1484 if (isset($this->info['audio']['dataformat']) && empty($this->info['video']['resolution_x'])) {
1485 // audio only
1487 } elseif (isset($this->info['video']['resolution_x']) && empty($this->info['audio']['dataformat'])) {
1488 // video only
1490 }
1491 }
1492
1493 // Set playtime string
1496 }
1497 }
References info(), and getid3_lib\PlaytimeString().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ CharConvert()
| getID3::CharConvert | ( | & | $array, |
| $encoding | |||
| ) |
Definition at line 1166 of file getid3.php.
1166 {
1167
1168 // identical encoding - end here
1170 return;
1171 }
1172
1173 // loop thru array
1175
1176 // go recursive
1177 if (is_array($value)) {
1179 }
1180
1181 // convert string
1182 elseif (is_string($value)) {
1184 }
1185 }
1186 }
static iconv_fallback($in_charset, $out_charset, $string)
Definition: getid3.lib.php:957
References $encoding, $key, CharConvert(), and getid3_lib\iconv_fallback().
Referenced by CharConvert(), and HandleAllTags().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ CleanUp()
|
private |
Definition at line 526 of file getid3.php.
526 {
527
528 // remove possible empty keys
529 $AVpossibleEmptyKeys = array('dataformat', 'bits_per_sample', 'encoder_options', 'streams', 'bitrate');
533 }
536 }
537 }
538
539 // remove empty root keys
543 unset($this->info[$key]);
544 }
545 }
546 }
547
548 // remove meaningless entries from unknown-format files
552 }
555 }
556 }
557
558 // remove possible duplicated identical entries
561 }
564 }
565
566 // remove "global variable" type keys
568
569 return true;
570 }
Referenced by analyze(), and error().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ error()
| getID3::error | ( | $message | ) |
Definition at line 508 of file getid3.php.
References $info, $message, CleanUp(), and info().
Referenced by analyze(), getHashdata(), and openfile().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ fread_buffer_size()
| getID3::fread_buffer_size | ( | ) |
◆ GetFileFormat()
| getID3::GetFileFormat | ( | & | $filedata, |
$filename = '' |
|||
| ) |
Definition at line 1127 of file getid3.php.
1127 {
1128 // this function will determine the format of a file based on usually
1129 // the first 2-4 bytes of the file (8 bytes for PNG, 16 bytes for JPG,
1130 // and in the case of ISO CD image, 6 bytes offset 32kb from the start
1131 // of the file).
1132
1133 // Identify file format - loop through $format_info and detect with reg expr
1135 // The /s switch on preg_match() forces preg_match() NOT to treat
1136 // newline (0x0A) characters as special chars but do a binary match
1140 }
1141 }
1142
1143
1145 // Too many mp3 encoders on the market put gabage in front of mpeg files
1146 // use assume format on these if format detection failed
1147 $GetFileFormatArray = $this->GetFileFormatArray();
1151 } elseif (preg_match('#\\.cue$#i', $filename) && preg_match('#FILE "[^"]+" (BINARY|MOTOROLA|AIFF|WAVE|MP3)#', $filedata)) {
1152 // there's not really a useful consistent "magic" at the beginning of .cue files to identify them
1153 // so until I think of something better, just go by filename if all other format checks fail
1154 // and verify there's at least one instance of "TRACK xx AUDIO" in the file
1155 $GetFileFormatArray = $this->GetFileFormatArray();
1159 }
1160
1161 return false;
1162 }
References $filename, $info, and GetFileFormatArray().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ GetFileFormatArray()
| getID3::GetFileFormatArray | ( | ) |
Definition at line 574 of file getid3.php.
574 {
575 static $format_info = array();
576 if (empty($format_info)) {
577 $format_info = array(
578
579 // Audio formats
580
581 // AC-3 - audio - Dolby AC-3 / Dolby Digital
582 'ac3' => array(
583 'pattern' => '^\\x0B\\x77',
584 'group' => 'audio',
585 'module' => 'ac3',
586 'mime_type' => 'audio/ac3',
587 ),
588
589 // AAC - audio - Advanced Audio Coding (AAC) - ADIF format
590 'adif' => array(
591 'pattern' => '^ADIF',
592 'group' => 'audio',
593 'module' => 'aac',
594 'mime_type' => 'application/octet-stream',
595 'fail_ape' => 'WARNING',
596 ),
597
598/*
599 // AA - audio - Audible Audiobook
600 'aa' => array(
601 'pattern' => '^.{4}\\x57\\x90\\x75\\x36',
602 'group' => 'audio',
603 'module' => 'aa',
604 'mime_type' => 'audio/audible',
605 ),
606*/
607 // AAC - audio - Advanced Audio Coding (AAC) - ADTS format (very similar to MP3)
608 'adts' => array(
609 'pattern' => '^\\xFF[\\xF0-\\xF1\\xF8-\\xF9]',
610 'group' => 'audio',
611 'module' => 'aac',
612 'mime_type' => 'application/octet-stream',
613 'fail_ape' => 'WARNING',
614 ),
615
616
617 // AU - audio - NeXT/Sun AUdio (AU)
618 'au' => array(
619 'pattern' => '^\\.snd',
620 'group' => 'audio',
621 'module' => 'au',
622 'mime_type' => 'audio/basic',
623 ),
624
625 // AMR - audio - Adaptive Multi Rate
626 'amr' => array(
627 'pattern' => '^\\x23\\x21AMR\\x0A', // #!AMR[0A]
628 'group' => 'audio',
629 'module' => 'amr',
630 'mime_type' => 'audio/amr',
631 ),
632
633 // AVR - audio - Audio Visual Research
634 'avr' => array(
635 'pattern' => '^2BIT',
636 'group' => 'audio',
637 'module' => 'avr',
638 'mime_type' => 'application/octet-stream',
639 ),
640
641 // BONK - audio - Bonk v0.9+
642 'bonk' => array(
643 'pattern' => '^\\x00(BONK|INFO|META| ID3)',
644 'group' => 'audio',
645 'module' => 'bonk',
646 'mime_type' => 'audio/xmms-bonk',
647 ),
648
649 // DSF - audio - Direct Stream Digital (DSD) Storage Facility files (DSF) - https://en.wikipedia.org/wiki/Direct_Stream_Digital
650 'dsf' => array(
651 'pattern' => '^DSD ', // including trailing space: 44 53 44 20
652 'group' => 'audio',
653 'module' => 'dsf',
654 'mime_type' => 'audio/dsd',
655 ),
656
657 // DSS - audio - Digital Speech Standard
658 'dss' => array(
659 'pattern' => '^[\\x02-\\x06]ds[s2]',
660 'group' => 'audio',
661 'module' => 'dss',
662 'mime_type' => 'application/octet-stream',
663 ),
664
665 // DTS - audio - Dolby Theatre System
666 'dts' => array(
667 'pattern' => '^\\x7F\\xFE\\x80\\x01',
668 'group' => 'audio',
669 'module' => 'dts',
670 'mime_type' => 'audio/dts',
671 ),
672
673 // FLAC - audio - Free Lossless Audio Codec
674 'flac' => array(
675 'pattern' => '^fLaC',
676 'group' => 'audio',
677 'module' => 'flac',
678 'mime_type' => 'audio/x-flac',
679 ),
680
681 // LA - audio - Lossless Audio (LA)
682 'la' => array(
683 'pattern' => '^LA0[2-4]',
684 'group' => 'audio',
685 'module' => 'la',
686 'mime_type' => 'application/octet-stream',
687 ),
688
689 // LPAC - audio - Lossless Predictive Audio Compression (LPAC)
690 'lpac' => array(
691 'pattern' => '^LPAC',
692 'group' => 'audio',
693 'module' => 'lpac',
694 'mime_type' => 'application/octet-stream',
695 ),
696
697 // MIDI - audio - MIDI (Musical Instrument Digital Interface)
698 'midi' => array(
699 'pattern' => '^MThd',
700 'group' => 'audio',
701 'module' => 'midi',
702 'mime_type' => 'audio/midi',
703 ),
704
705 // MAC - audio - Monkey's Audio Compressor
706 'mac' => array(
707 'pattern' => '^MAC ',
708 'group' => 'audio',
709 'module' => 'monkey',
710 'mime_type' => 'application/octet-stream',
711 ),
712
713// has been known to produce false matches in random files (e.g. JPEGs), leave out until more precise matching available
714// // MOD - audio - MODule (assorted sub-formats)
715// 'mod' => array(
716// 'pattern' => '^.{1080}(M\\.K\\.|M!K!|FLT4|FLT8|[5-9]CHN|[1-3][0-9]CH)',
717// 'group' => 'audio',
718// 'module' => 'mod',
719// 'option' => 'mod',
720// 'mime_type' => 'audio/mod',
721// ),
722
723 // MOD - audio - MODule (Impulse Tracker)
724 'it' => array(
725 'pattern' => '^IMPM',
726 'group' => 'audio',
727 'module' => 'mod',
728 //'option' => 'it',
729 'mime_type' => 'audio/it',
730 ),
731
732 // MOD - audio - MODule (eXtended Module, various sub-formats)
733 'xm' => array(
734 'pattern' => '^Extended Module',
735 'group' => 'audio',
736 'module' => 'mod',
737 //'option' => 'xm',
738 'mime_type' => 'audio/xm',
739 ),
740
741 // MOD - audio - MODule (ScreamTracker)
742 's3m' => array(
743 'pattern' => '^.{44}SCRM',
744 'group' => 'audio',
745 'module' => 'mod',
746 //'option' => 's3m',
747 'mime_type' => 'audio/s3m',
748 ),
749
750 // MPC - audio - Musepack / MPEGplus
751 'mpc' => array(
752 'pattern' => '^(MPCK|MP\\+|[\\x00\\x01\\x10\\x11\\x40\\x41\\x50\\x51\\x80\\x81\\x90\\x91\\xC0\\xC1\\xD0\\xD1][\\x20-\\x37][\\x00\\x20\\x40\\x60\\x80\\xA0\\xC0\\xE0])',
753 'group' => 'audio',
754 'module' => 'mpc',
755 'mime_type' => 'audio/x-musepack',
756 ),
757
758 // MP3 - audio - MPEG-audio Layer 3 (very similar to AAC-ADTS)
759 'mp3' => array(
760 '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]',
761 'group' => 'audio',
762 'module' => 'mp3',
763 'mime_type' => 'audio/mpeg',
764 ),
765
766 // OFR - audio - OptimFROG
767 'ofr' => array(
768 'pattern' => '^(\\*RIFF|OFR)',
769 'group' => 'audio',
770 'module' => 'optimfrog',
771 'mime_type' => 'application/octet-stream',
772 ),
773
774 // RKAU - audio - RKive AUdio compressor
775 'rkau' => array(
776 'pattern' => '^RKA',
777 'group' => 'audio',
778 'module' => 'rkau',
779 'mime_type' => 'application/octet-stream',
780 ),
781
782 // SHN - audio - Shorten
783 'shn' => array(
784 'pattern' => '^ajkg',
785 'group' => 'audio',
786 'module' => 'shorten',
787 'mime_type' => 'audio/xmms-shn',
788 'fail_id3' => 'ERROR',
789 'fail_ape' => 'ERROR',
790 ),
791
792 // TTA - audio - TTA Lossless Audio Compressor (http://tta.corecodec.org)
793 'tta' => array(
794 'pattern' => '^TTA', // could also be '^TTA(\\x01|\\x02|\\x03|2|1)'
795 'group' => 'audio',
796 'module' => 'tta',
797 'mime_type' => 'application/octet-stream',
798 ),
799
800 // VOC - audio - Creative Voice (VOC)
801 'voc' => array(
802 'pattern' => '^Creative Voice File',
803 'group' => 'audio',
804 'module' => 'voc',
805 'mime_type' => 'audio/voc',
806 ),
807
808 // VQF - audio - transform-domain weighted interleave Vector Quantization Format (VQF)
809 'vqf' => array(
810 'pattern' => '^TWIN',
811 'group' => 'audio',
812 'module' => 'vqf',
813 'mime_type' => 'application/octet-stream',
814 ),
815
816 // WV - audio - WavPack (v4.0+)
817 'wv' => array(
818 'pattern' => '^wvpk',
819 'group' => 'audio',
820 'module' => 'wavpack',
821 'mime_type' => 'application/octet-stream',
822 ),
823
824
825 // Audio-Video formats
826
827 // ASF - audio/video - Advanced Streaming Format, Windows Media Video, Windows Media Audio
828 'asf' => array(
829 'pattern' => '^\\x30\\x26\\xB2\\x75\\x8E\\x66\\xCF\\x11\\xA6\\xD9\\x00\\xAA\\x00\\x62\\xCE\\x6C',
830 'group' => 'audio-video',
831 'module' => 'asf',
832 'mime_type' => 'video/x-ms-asf',
833 'iconv_req' => false,
834 ),
835
836 // BINK - audio/video - Bink / Smacker
837 'bink' => array(
838 'pattern' => '^(BIK|SMK)',
839 'group' => 'audio-video',
840 'module' => 'bink',
841 'mime_type' => 'application/octet-stream',
842 ),
843
844 // FLV - audio/video - FLash Video
845 'flv' => array(
846 'pattern' => '^FLV[\\x01]',
847 'group' => 'audio-video',
848 'module' => 'flv',
849 'mime_type' => 'video/x-flv',
850 ),
851
852 // MKAV - audio/video - Mastroka
853 'matroska' => array(
854 'pattern' => '^\\x1A\\x45\\xDF\\xA3',
855 'group' => 'audio-video',
856 'module' => 'matroska',
857 'mime_type' => 'video/x-matroska', // may also be audio/x-matroska
858 ),
859
860 // MPEG - audio/video - MPEG (Moving Pictures Experts Group)
861 'mpeg' => array(
862 'pattern' => '^\\x00\\x00\\x01[\\xB3\\xBA]',
863 'group' => 'audio-video',
864 'module' => 'mpeg',
865 'mime_type' => 'video/mpeg',
866 ),
867
868 // NSV - audio/video - Nullsoft Streaming Video (NSV)
869 'nsv' => array(
870 'pattern' => '^NSV[sf]',
871 'group' => 'audio-video',
872 'module' => 'nsv',
873 'mime_type' => 'application/octet-stream',
874 ),
875
876 // Ogg - audio/video - Ogg (Ogg-Vorbis, Ogg-FLAC, Speex, Ogg-Theora(*), Ogg-Tarkin(*))
877 'ogg' => array(
878 'pattern' => '^OggS',
879 'group' => 'audio',
880 'module' => 'ogg',
881 'mime_type' => 'application/ogg',
882 'fail_id3' => 'WARNING',
883 'fail_ape' => 'WARNING',
884 ),
885
886 // QT - audio/video - Quicktime
887 'quicktime' => array(
888 'pattern' => '^.{4}(cmov|free|ftyp|mdat|moov|pnot|skip|wide)',
889 'group' => 'audio-video',
890 'module' => 'quicktime',
891 'mime_type' => 'video/quicktime',
892 ),
893
894 // 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)
895 'riff' => array(
896 'pattern' => '^(RIFF|SDSS|FORM)',
897 'group' => 'audio-video',
898 'module' => 'riff',
899 'mime_type' => 'audio/x-wav',
900 'fail_ape' => 'WARNING',
901 ),
902
903 // Real - audio/video - RealAudio, RealVideo
904 'real' => array(
905 'pattern' => '^\\.(RMF|ra)',
906 'group' => 'audio-video',
907 'module' => 'real',
908 'mime_type' => 'audio/x-realaudio',
909 ),
910
911 // SWF - audio/video - ShockWave Flash
912 'swf' => array(
913 'pattern' => '^(F|C)WS',
914 'group' => 'audio-video',
915 'module' => 'swf',
916 'mime_type' => 'application/x-shockwave-flash',
917 ),
918
919 // TS - audio/video - MPEG-2 Transport Stream
920 'ts' => array(
921 'pattern' => '^(\\x47.{187}){10,}', // packets are 188 bytes long and start with 0x47 "G". Check for at least 10 packets matching this pattern
922 'group' => 'audio-video',
923 'module' => 'ts',
924 'mime_type' => 'video/MP2T',
925 ),
926
927
928 // Still-Image formats
929
930 // BMP - still image - Bitmap (Windows, OS/2; uncompressed, RLE8, RLE4)
931 'bmp' => array(
932 'pattern' => '^BM',
933 'group' => 'graphic',
934 'module' => 'bmp',
935 'mime_type' => 'image/bmp',
936 'fail_id3' => 'ERROR',
937 'fail_ape' => 'ERROR',
938 ),
939
940 // GIF - still image - Graphics Interchange Format
941 'gif' => array(
942 'pattern' => '^GIF',
943 'group' => 'graphic',
944 'module' => 'gif',
945 'mime_type' => 'image/gif',
946 'fail_id3' => 'ERROR',
947 'fail_ape' => 'ERROR',
948 ),
949
950 // JPEG - still image - Joint Photographic Experts Group (JPEG)
951 'jpg' => array(
952 'pattern' => '^\\xFF\\xD8\\xFF',
953 'group' => 'graphic',
954 'module' => 'jpg',
955 'mime_type' => 'image/jpeg',
956 'fail_id3' => 'ERROR',
957 'fail_ape' => 'ERROR',
958 ),
959
960 // PCD - still image - Kodak Photo CD
961 'pcd' => array(
962 'pattern' => '^.{2048}PCD_IPI\\x00',
963 'group' => 'graphic',
964 'module' => 'pcd',
965 'mime_type' => 'image/x-photo-cd',
966 'fail_id3' => 'ERROR',
967 'fail_ape' => 'ERROR',
968 ),
969
970
971 // PNG - still image - Portable Network Graphics (PNG)
972 'png' => array(
973 'pattern' => '^\\x89\\x50\\x4E\\x47\\x0D\\x0A\\x1A\\x0A',
974 'group' => 'graphic',
975 'module' => 'png',
976 'mime_type' => 'image/png',
977 'fail_id3' => 'ERROR',
978 'fail_ape' => 'ERROR',
979 ),
980
981
982 // SVG - still image - Scalable Vector Graphics (SVG)
983 'svg' => array(
984 'pattern' => '(<!DOCTYPE svg PUBLIC |xmlns="http://www\\.w3\\.org/2000/svg")',
985 'group' => 'graphic',
986 'module' => 'svg',
987 'mime_type' => 'image/svg+xml',
988 'fail_id3' => 'ERROR',
989 'fail_ape' => 'ERROR',
990 ),
991
992
993 // TIFF - still image - Tagged Information File Format (TIFF)
994 'tiff' => array(
995 'pattern' => '^(II\\x2A\\x00|MM\\x00\\x2A)',
996 'group' => 'graphic',
997 'module' => 'tiff',
998 'mime_type' => 'image/tiff',
999 'fail_id3' => 'ERROR',
1000 'fail_ape' => 'ERROR',
1001 ),
1002
1003
1004 // EFAX - still image - eFax (TIFF derivative)
1005 'efax' => array(
1006 'pattern' => '^\\xDC\\xFE',
1007 'group' => 'graphic',
1008 'module' => 'efax',
1009 'mime_type' => 'image/efax',
1010 'fail_id3' => 'ERROR',
1011 'fail_ape' => 'ERROR',
1012 ),
1013
1014
1015 // Data formats
1016
1017 // ISO - data - International Standards Organization (ISO) CD-ROM Image
1018 'iso' => array(
1019 'pattern' => '^.{32769}CD001',
1020 'group' => 'misc',
1021 'module' => 'iso',
1022 'mime_type' => 'application/octet-stream',
1023 'fail_id3' => 'ERROR',
1024 'fail_ape' => 'ERROR',
1025 'iconv_req' => false,
1026 ),
1027
1028 // RAR - data - RAR compressed data
1029 'rar' => array(
1030 'pattern' => '^Rar\\!',
1031 'group' => 'archive',
1032 'module' => 'rar',
1033 'mime_type' => 'application/octet-stream',
1034 'fail_id3' => 'ERROR',
1035 'fail_ape' => 'ERROR',
1036 ),
1037
1038 // SZIP - audio/data - SZIP compressed data
1039 'szip' => array(
1040 'pattern' => '^SZ\\x0A\\x04',
1041 'group' => 'archive',
1042 'module' => 'szip',
1043 'mime_type' => 'application/octet-stream',
1044 'fail_id3' => 'ERROR',
1045 'fail_ape' => 'ERROR',
1046 ),
1047
1048 // TAR - data - TAR compressed data
1049 'tar' => array(
1050 '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}',
1051 'group' => 'archive',
1052 'module' => 'tar',
1053 'mime_type' => 'application/x-tar',
1054 'fail_id3' => 'ERROR',
1055 'fail_ape' => 'ERROR',
1056 ),
1057
1058 // GZIP - data - GZIP compressed data
1059 'gz' => array(
1060 'pattern' => '^\\x1F\\x8B\\x08',
1061 'group' => 'archive',
1062 'module' => 'gzip',
1063 'mime_type' => 'application/x-gzip',
1064 'fail_id3' => 'ERROR',
1065 'fail_ape' => 'ERROR',
1066 ),
1067
1068 // ZIP - data - ZIP compressed data
1069 'zip' => array(
1070 'pattern' => '^PK\\x03\\x04',
1071 'group' => 'archive',
1072 'module' => 'zip',
1073 'mime_type' => 'application/zip',
1074 'fail_id3' => 'ERROR',
1075 'fail_ape' => 'ERROR',
1076 ),
1077
1078
1079 // Misc other formats
1080
1081 // PAR2 - data - Parity Volume Set Specification 2.0
1082 'par2' => array (
1083 'pattern' => '^PAR2\\x00PKT',
1084 'group' => 'misc',
1085 'module' => 'par2',
1086 'mime_type' => 'application/octet-stream',
1087 'fail_id3' => 'ERROR',
1088 'fail_ape' => 'ERROR',
1089 ),
1090
1091 // PDF - data - Portable Document Format
1092 'pdf' => array(
1093 'pattern' => '^\\x25PDF',
1094 'group' => 'misc',
1095 'module' => 'pdf',
1096 'mime_type' => 'application/pdf',
1097 'fail_id3' => 'ERROR',
1098 'fail_ape' => 'ERROR',
1099 ),
1100
1101 // MSOFFICE - data - ZIP compressed data
1102 'msoffice' => array(
1103 'pattern' => '^\\xD0\\xCF\\x11\\xE0\\xA1\\xB1\\x1A\\xE1', // D0CF11E == DOCFILE == Microsoft Office Document
1104 'group' => 'misc',
1105 'module' => 'msoffice',
1106 'mime_type' => 'application/octet-stream',
1107 'fail_id3' => 'ERROR',
1108 'fail_ape' => 'ERROR',
1109 ),
1110
1111 // CUE - data - CUEsheet (index to single-file disc images)
1112 'cue' => array(
1113 'pattern' => '', // empty pattern means cannot be automatically detected, will fall through all other formats and match based on filename and very basic file contents
1114 'group' => 'misc',
1115 'module' => 'cue',
1116 'mime_type' => 'application/octet-stream',
1117 ),
1118
1119 );
1120 }
1121
1122 return $format_info;
1123 }
Referenced by GetFileFormat().
Here is the caller graph for this function:
◆ getHashdata()
| getID3::getHashdata | ( | $algorithm | ) |
Definition at line 1311 of file getid3.php.
1311 {
1312 switch ($algorithm) {
1313 case 'md5':
1314 case 'sha1':
1315 break;
1316
1317 default:
1319 break;
1320 }
1321
1322 if (!empty($this->info['fileformat']) && !empty($this->info['dataformat']) && ($this->info['fileformat'] == 'ogg') && ($this->info['audio']['dataformat'] == 'vorbis')) {
1323
1324 // We cannot get an identical md5_data value for Ogg files where the comments
1325 // span more than 1 Ogg page (compared to the same audio data with smaller
1326 // comments) using the normal getID3() method of MD5'ing the data between the
1327 // end of the comments and the end of the file (minus any trailing tags),
1328 // because the page sequence numbers of the pages that the audio data is on
1329 // do not match. Under normal circumstances, where comments are smaller than
1330 // the nominal 4-8kB page size, then this is not a problem, but if there are
1331 // very large comments, the only way around it is to strip off the comment
1332 // tags with vorbiscomment and MD5 that file.
1333 // This procedure must be applied to ALL Ogg files, not just the ones with
1334 // comments larger than 1 page, because the below method simply MD5's the
1335 // whole file with the comments stripped, not just the portion after the
1336 // comments block (which is the standard getID3() method.
1337
1338 // The above-mentioned problem of comments spanning multiple pages and changing
1339 // page sequence numbers likely happens for OggSpeex and OggFLAC as well, but
1340 // currently vorbiscomment only works on OggVorbis files.
1341
1342 if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
1343
1344 $this->warning('Failed making system call to vorbiscomment.exe - '.$algorithm.'_data is incorrect - error returned: PHP running in Safe Mode (backtick operator not available)');
1346
1347 } else {
1348
1349 // Prevent user from aborting script
1350 $old_abort = ignore_user_abort(true);
1351
1352 // Create empty file
1353 $empty = tempnam(GETID3_TEMP_DIR, 'getID3');
1354 touch($empty);
1355
1356 // Use vorbiscomment to make temp file without comments
1357 $temp = tempnam(GETID3_TEMP_DIR, 'getID3');
1359
1360 if (GETID3_OS_ISWINDOWS) {
1361
1362 if (file_exists(GETID3_HELPERAPPSDIR.'vorbiscomment.exe')) {
1363
1364 $commandline = '"'.GETID3_HELPERAPPSDIR.'vorbiscomment.exe" -w -c "'.$empty.'" "'.$file.'" "'.$temp.'"';
1365 $VorbisCommentError = `$commandline`;
1366
1367 } else {
1368
1369 $VorbisCommentError = 'vorbiscomment.exe not found in '.GETID3_HELPERAPPSDIR;
1370
1371 }
1372
1373 } else {
1374
1375 $commandline = 'vorbiscomment -w -c "'.$empty.'" "'.$file.'" "'.$temp.'" 2>&1';
1376 $commandline = 'vorbiscomment -w -c '.escapeshellarg($empty).' '.escapeshellarg($file).' '.escapeshellarg($temp).' 2>&1';
1377 $VorbisCommentError = `$commandline`;
1378
1379 }
1380
1381 if (!empty($VorbisCommentError)) {
1382
1383 $this->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);
1385
1386 } else {
1387
1388 // Get hash of newly created file
1389 switch ($algorithm) {
1390 case 'md5':
1392 break;
1393
1394 case 'sha1':
1396 break;
1397 }
1398 }
1399
1400 // Clean up
1401 unlink($empty);
1402 unlink($temp);
1403
1404 // Reset abort setting
1405 ignore_user_abort($old_abort);
1406
1407 }
1408
1409 } else {
1410
1411 if (!empty($this->info['avdataoffset']) || (isset($this->info['avdataend']) && ($this->info['avdataend'] < $this->info['filesize']))) {
1412
1413 // get hash from part of file
1414 $this->info[$algorithm.'_data'] = getid3_lib::hash_data($this->info['filenamepath'], $this->info['avdataoffset'], $this->info['avdataend'], $algorithm);
1415
1416 } else {
1417
1418 // get hash from whole file
1419 switch ($algorithm) {
1420 case 'md5':
1422 break;
1423
1424 case 'sha1':
1426 break;
1427 }
1428 }
1429
1430 }
1431 return true;
1432 }
static hash_data($file, $offset, $end, $algorithm)
Definition: getid3.lib.php:562
References error(), getid3_lib\hash_data(), info(), and warning().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getid3_tempnam()
| getID3::getid3_tempnam | ( | ) |
Definition at line 1600 of file getid3.php.
1600 {
1601 return tempnam($this->tempdir, 'gI3');
1602 }
◆ HandleAllTags()
| getID3::HandleAllTags | ( | ) |
Definition at line 1189 of file getid3.php.
1189 {
1190
1191 // key name => array (tag name, character encoding)
1194 $tags = array(
1195 'asf' => array('asf' , 'UTF-16LE'),
1196 'midi' => array('midi' , 'ISO-8859-1'),
1197 'nsv' => array('nsv' , 'ISO-8859-1'),
1198 'ogg' => array('vorbiscomment' , 'UTF-8'),
1199 'png' => array('png' , 'UTF-8'),
1200 'tiff' => array('tiff' , 'ISO-8859-1'),
1201 'quicktime' => array('quicktime' , 'UTF-8'),
1202 'real' => array('real' , 'ISO-8859-1'),
1203 'vqf' => array('vqf' , 'ISO-8859-1'),
1204 'zip' => array('zip' , 'ISO-8859-1'),
1205 'riff' => array('riff' , 'ISO-8859-1'),
1206 'lyrics3' => array('lyrics3' , 'ISO-8859-1'),
1207 'id3v1' => array('id3v1' , $this->encoding_id3v1),
1208 '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
1209 'ape' => array('ape' , 'UTF-8'),
1210 'cue' => array('cue' , 'ISO-8859-1'),
1211 'matroska' => array('matroska' , 'UTF-8'),
1212 'flac' => array('vorbiscomment' , 'UTF-8'),
1213 'divxtag' => array('divx' , 'ISO-8859-1'),
1214 'iptc' => array('iptc' , 'ISO-8859-1'),
1215 );
1216 }
1217
1218 // loop through comments array
1220 list($tag_name, $encoding) = $tagname_encoding_array;
1221
1222 // fill in default encoding type if not already present
1225 }
1226
1227 // copy comments if key name set
1231 if (is_string($value)) {
1232 $value = trim($value, " \r\n\t"); // do not trim nulls from $value!! Unicode characters will get mangled if trailing nulls are removed!
1233 }
1234 if ($value) {
1237 } else {
1239 }
1240 }
1241 }
1242 if ($tag_key == 'picture') {
1244 }
1245 }
1246
1248 // comments are set but contain nothing but empty strings, so skip
1249 continue;
1250 }
1251
1252 $this->CharConvert($this->info['tags'][$tag_name], $this->info[$comment_name]['encoding']); // only copy gets converted!
1253
1254 if ($this->option_tags_html) {
1256 $this->info['tags_html'][$tag_name][$tag_key] = getid3_lib::recursiveMultiByteCharString2HTML($valuearray, $this->info[$comment_name]['encoding']);
1257 }
1258 }
1259
1260 }
1261
1262 }
1263
1264 // pictures can take up a lot of space, and we don't need multiple copies of them
1265 // let there be a single copy in [comments][picture], and not elsewhere
1267 $unset_keys = array('tags', 'tags_html');
1269 foreach ($tagarray as $tagname => $tagdata) {
1270 if ($tagname == 'picture') {
1273 if (isset($tagarray['data']) && isset($tagarray['image_mime'])) {
1276 }
1279 }
1280 }
1281 }
1282 }
1283 }
1284 foreach ($unset_keys as $unset_key) {
1285 // remove possible empty keys from (e.g. [tags][id3v2][picture])
1288 }
1290 unset($this->info[$unset_key][$tagtype]);
1291 }
1293 unset($this->info[$unset_key]);
1294 }
1295 }
1296 // remove duplicate copy of picture data from (e.g. [id3v2][comments][picture])
1299 }
1302 }
1304 unset($this->info[$tagtype]);
1305 }
1306 }
1307 }
1308 return true;
1309 }
static recursiveMultiByteCharString2HTML($data, $charset='ISO-8859-1')
Definition: getid3.lib.php:1017
References $encoding, $key, $tags, CharConvert(), info(), and getid3_lib\recursiveMultiByteCharString2HTML().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ include_module()
| getID3::include_module | ( | $name | ) |
Definition at line 1604 of file getid3.php.
1604 {
1605 //if (!file_exists($this->include_path.'module.'.$name.'.php')) {
1608 }
1610 return true;
1611 }
References $name.
Referenced by analyze().
Here is the caller graph for this function:
◆ openfile()
| getID3::openfile | ( | $filename, | |
$filesize = null |
|||
| ) |
Definition at line 257 of file getid3.php.
257 {
258 try {
259 if (!empty($this->startup_error)) {
261 }
262 if (!empty($this->startup_warning)) {
264 $this->warning($startup_warning);
265 }
266 }
267
268 // init result array and set parameters
269 $this->filename = $filename;
270 $this->info = array();
273
274 // remote files not supported
276 throw new getid3_exception('Remote files are not supported - please copy the file locally first');
277 }
278
280 $filename = preg_replace('#(.+)'.preg_quote(DIRECTORY_SEPARATOR).'{2,}#U', '\1'.DIRECTORY_SEPARATOR, $filename);
281
282 // open local file
283 //if (is_readable($filename) && is_file($filename) && ($this->fp = fopen($filename, 'rb'))) { // see http://www.getid3.org/phpBB3/viewtopic.php?t=1720
284 if ((is_readable($filename) || file_exists($filename)) && is_file($filename) && ($this->fp = fopen($filename, 'rb'))) {
285 // great
286 } else {
287 $errormessagelist = array();
289 $errormessagelist[] = '!is_readable';
290 }
292 $errormessagelist[] = '!is_file';
293 }
295 $errormessagelist[] = '!file_exists';
296 }
297 if (empty($errormessagelist)) {
298 $errormessagelist[] = 'fopen failed';
299 }
300 throw new getid3_exception('Could not open "'.$filename.'" ('.implode('; ', $errormessagelist).')');
301 }
302
304 // set redundant parameters - might be needed in some include file
305 // filenames / filepaths in getID3 are always expressed with forward slashes (unix-style) for both Windows and other to try and minimize confusion
310
311 // set more parameters
321 $this->info['encoding'] = $this->encoding; // required by id3v2 and iso modules - can be unset at the end if desired
322
323 // option_max_2gb_check
324 if ($this->option_max_2gb_check) {
325 // PHP (32-bit all, and 64-bit Windows) doesn't support integers larger than 2^31 (~2GB)
326 // filesize() simply returns (filesize % (pow(2, 32)), no matter the actual filesize
327 // ftell() returns 0 if seeking to the end is beyond the range of unsigned integer
328 $fseek = fseek($this->fp, 0, SEEK_END);
331 (ftell($this->fp) < 0)) {
333
334 if ($real_filesize === false) {
336 fclose($this->fp);
337 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.');
338 } elseif (getid3_lib::intValueSupported($real_filesize)) {
340 fclose($this->fp);
341 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');
342 }
344 $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.');
345 }
346 }
347
348 return true;
349
350 } catch (Exception $e) {
351 $this->error($e->getMessage());
352 }
353 return false;
354 }
static mb_basename($path, $suffix=null)
Workaround for Bug #37268 (https://bugs.php.net/bug.php?id=37268)
Definition: getid3.lib.php:1428
References $encoding, $filename, $startup_warning, error(), getid3_lib\getFileSizeSyscall(), info(), getid3_lib\intValueSupported(), getid3_lib\mb_basename(), version(), and warning().
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ ProcessAudioStreams()
| getID3::ProcessAudioStreams | ( | ) |
Definition at line 1587 of file getid3.php.
1587 {
1588 if (!empty($this->info['audio']['bitrate']) || !empty($this->info['audio']['channels']) || !empty($this->info['audio']['sample_rate'])) {
1593 }
1594 }
1595 }
1596 }
1597 return true;
1598 }
Referenced by analyze().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ setOption()
| getID3::setOption | ( | $optArray | ) |
Definition at line 243 of file getid3.php.
243 {
244 if (!is_array($optArray) || empty($optArray)) {
245 return false;
246 }
247 foreach ($optArray as $opt => $val) {
248 if (isset($this->$opt) === false) {
249 continue;
250 }
251 $this->$opt = $val;
252 }
253 return true;
254 }
◆ version()
| getID3::version | ( | ) |
Definition at line 233 of file getid3.php.
References VERSION.
Referenced by openfile().
Here is the caller graph for this function:
◆ warning()
| getID3::warning | ( | $message | ) |
Definition at line 519 of file getid3.php.
References $message, and info().
Referenced by __construct(), analyze(), getHashdata(), and openfile().
Here is the call graph for this function:
Here is the caller graph for this function:
Field Documentation
◆ $encoding
| getID3::$encoding = 'UTF-8' |
Definition at line 78 of file getid3.php.
Referenced by CharConvert(), HandleAllTags(), and openfile().
◆ $encoding_id3v1
| getID3::$encoding_id3v1 = 'ISO-8859-1' |
Definition at line 79 of file getid3.php.
◆ $filename
| getID3::$filename |
Definition at line 105 of file getid3.php.
Referenced by __construct(), getID3_cached_dbm\analyze(), getID3_cached_sqlite3\analyze(), analyze(), GetFileFormat(), and openfile().
◆ $fp
| getID3::$fp |
Definition at line 106 of file getid3.php.
◆ $info
| getID3::$info |
Definition at line 107 of file getid3.php.
Referenced by analyze(), error(), and GetFileFormat().
◆ $memory_limit
| getID3::$memory_limit = 0 |
Definition at line 109 of file getid3.php.
◆ $option_extra_info
| getID3::$option_extra_info = true |
Definition at line 90 of file getid3.php.
◆ $option_fread_buffer_size
| getID3::$option_fread_buffer_size = 32768 |
Definition at line 102 of file getid3.php.
Referenced by fread_buffer_size().
◆ $option_max_2gb_check
| getID3::$option_max_2gb_check = null |
Definition at line 99 of file getid3.php.
◆ $option_md5_data
| getID3::$option_md5_data = false |
Definition at line 96 of file getid3.php.
◆ $option_md5_data_source
| getID3::$option_md5_data_source = false |
Definition at line 97 of file getid3.php.
◆ $option_save_attachments
| getID3::$option_save_attachments = true |
Definition at line 93 of file getid3.php.
◆ $option_sha1_data
| getID3::$option_sha1_data = false |
Definition at line 98 of file getid3.php.
◆ $option_tag_apetag
| getID3::$option_tag_apetag = true |
Definition at line 85 of file getid3.php.
◆ $option_tag_id3v1
| getID3::$option_tag_id3v1 = true |
Definition at line 82 of file getid3.php.
◆ $option_tag_id3v2
| getID3::$option_tag_id3v2 = true |
Definition at line 83 of file getid3.php.
◆ $option_tag_lyrics3
| getID3::$option_tag_lyrics3 = true |
Definition at line 84 of file getid3.php.
◆ $option_tags_html
| getID3::$option_tags_html = true |
Definition at line 87 of file getid3.php.
◆ $option_tags_process
| getID3::$option_tags_process = true |
Definition at line 86 of file getid3.php.
◆ $startup_error
|
protected |
Definition at line 112 of file getid3.php.
Referenced by __construct().
◆ $startup_warning
|
protected |
Definition at line 113 of file getid3.php.
Referenced by openfile().
◆ $tempdir
| getID3::$tempdir = GETID3_TEMP_DIR |
Definition at line 108 of file getid3.php.
◆ ATTACHMENTS_INLINE
| const getID3::ATTACHMENTS_INLINE = true |
Definition at line 119 of file getid3.php.
Referenced by getid3_handler\saveAttachment().
◆ ATTACHMENTS_NONE
| const getID3::ATTACHMENTS_NONE = false |
Definition at line 118 of file getid3.php.
Referenced by getid3_matroska\Analyze(), getid3_flac\parseMETAdata(), and getid3_handler\saveAttachment().
◆ FREAD_BUFFER_SIZE
| const getID3::FREAD_BUFFER_SIZE = 32768 |
Definition at line 116 of file getid3.php.
Referenced by getid3_lib\CopyFileParts().
◆ VERSION
| const getID3::VERSION = '1.9.14-201703261440' |
Definition at line 115 of file getid3.php.
Referenced by getID3_cached_dbm\__construct(), getID3_cached_mysql\__construct(), getID3_cached_mysqli\__construct(), getID3_cached_sqlite3\__construct(), getID3_cached_dbm\clear_cache(), getID3_cached_sqlite3\clear_cache(), and version().
The documentation for this class was generated from the following file:
- libs/composer/vendor/james-heinrich/getid3/getid3/getid3.php
