| [ Index ] |
PHP Cross Reference of Unnamed Project |
[Summary view] [Print] [Text view]
1 <?php 2 // -------------------------------------------------------------------------------- 3 // PhpConcept Library - Zip Module 2.8.2 4 // -------------------------------------------------------------------------------- 5 // License GNU/LGPL - Vincent Blavet - August 2009 6 // http://www.phpconcept.net 7 // -------------------------------------------------------------------------------- 8 // 9 // Presentation : 10 // PclZip is a PHP library that manage ZIP archives. 11 // So far tests show that archives generated by PclZip are readable by 12 // WinZip application and other tools. 13 // 14 // Description : 15 // See readme.txt and http://www.phpconcept.net 16 // 17 // Warning : 18 // This library and the associated files are non commercial, non professional 19 // work. 20 // It should not have unexpected results. However if any damage is caused by 21 // this software the author can not be responsible. 22 // The use of this software is at the risk of the user. 23 // 24 // -------------------------------------------------------------------------------- 25 // $Id: pclzip.lib.php,v 1.60 2009/09/30 21:01:04 vblavet Exp $ 26 // -------------------------------------------------------------------------------- 27 28 // ----- Constants 29 if (!defined('PCLZIP_READ_BLOCK_SIZE')) { 30 define( 'PCLZIP_READ_BLOCK_SIZE', 2048 ); 31 } 32 33 // ----- File list separator 34 // In version 1.x of PclZip, the separator for file list is a space 35 // (which is not a very smart choice, specifically for windows paths !). 36 // A better separator should be a comma (,). This constant gives you the 37 // abilty to change that. 38 // However notice that changing this value, may have impact on existing 39 // scripts, using space separated filenames. 40 // Recommanded values for compatibility with older versions : 41 //define( 'PCLZIP_SEPARATOR', ' ' ); 42 // Recommanded values for smart separation of filenames. 43 if (!defined('PCLZIP_SEPARATOR')) { 44 define( 'PCLZIP_SEPARATOR', ',' ); 45 } 46 47 // ----- Error configuration 48 // 0 : PclZip Class integrated error handling 49 // 1 : PclError external library error handling. By enabling this 50 // you must ensure that you have included PclError library. 51 // [2,...] : reserved for futur use 52 if (!defined('PCLZIP_ERROR_EXTERNAL')) { 53 define( 'PCLZIP_ERROR_EXTERNAL', 0 ); 54 } 55 56 // ----- Optional static temporary directory 57 // By default temporary files are generated in the script current 58 // path. 59 // If defined : 60 // - MUST BE terminated by a '/'. 61 // - MUST be a valid, already created directory 62 // Samples : 63 // define( 'PCLZIP_TEMPORARY_DIR', '/temp/' ); 64 // define( 'PCLZIP_TEMPORARY_DIR', 'C:/Temp/' ); 65 if (!defined('PCLZIP_TEMPORARY_DIR')) { 66 define( 'PCLZIP_TEMPORARY_DIR', '' ); 67 } 68 69 // ----- Optional threshold ratio for use of temporary files 70 // Pclzip sense the size of the file to add/extract and decide to 71 // use or not temporary file. The algorythm is looking for 72 // memory_limit of PHP and apply a ratio. 73 // threshold = memory_limit * ratio. 74 // Recommended values are under 0.5. Default 0.47. 75 // Samples : 76 // define( 'PCLZIP_TEMPORARY_FILE_RATIO', 0.5 ); 77 if (!defined('PCLZIP_TEMPORARY_FILE_RATIO')) { 78 define( 'PCLZIP_TEMPORARY_FILE_RATIO', 0.47 ); 79 } 80 81 // -------------------------------------------------------------------------------- 82 // ***** UNDER THIS LINE NOTHING NEEDS TO BE MODIFIED ***** 83 // -------------------------------------------------------------------------------- 84 85 // ----- Global variables 86 $g_pclzip_version = "2.8.2"; 87 88 // ----- Error codes 89 // -1 : Unable to open file in binary write mode 90 // -2 : Unable to open file in binary read mode 91 // -3 : Invalid parameters 92 // -4 : File does not exist 93 // -5 : Filename is too long (max. 255) 94 // -6 : Not a valid zip file 95 // -7 : Invalid extracted file size 96 // -8 : Unable to create directory 97 // -9 : Invalid archive extension 98 // -10 : Invalid archive format 99 // -11 : Unable to delete file (unlink) 100 // -12 : Unable to rename file (rename) 101 // -13 : Invalid header checksum 102 // -14 : Invalid archive size 103 define( 'PCLZIP_ERR_USER_ABORTED', 2 ); 104 define( 'PCLZIP_ERR_NO_ERROR', 0 ); 105 define( 'PCLZIP_ERR_WRITE_OPEN_FAIL', -1 ); 106 define( 'PCLZIP_ERR_READ_OPEN_FAIL', -2 ); 107 define( 'PCLZIP_ERR_INVALID_PARAMETER', -3 ); 108 define( 'PCLZIP_ERR_MISSING_FILE', -4 ); 109 define( 'PCLZIP_ERR_FILENAME_TOO_LONG', -5 ); 110 define( 'PCLZIP_ERR_INVALID_ZIP', -6 ); 111 define( 'PCLZIP_ERR_BAD_EXTRACTED_FILE', -7 ); 112 define( 'PCLZIP_ERR_DIR_CREATE_FAIL', -8 ); 113 define( 'PCLZIP_ERR_BAD_EXTENSION', -9 ); 114 define( 'PCLZIP_ERR_BAD_FORMAT', -10 ); 115 define( 'PCLZIP_ERR_DELETE_FILE_FAIL', -11 ); 116 define( 'PCLZIP_ERR_RENAME_FILE_FAIL', -12 ); 117 define( 'PCLZIP_ERR_BAD_CHECKSUM', -13 ); 118 define( 'PCLZIP_ERR_INVALID_ARCHIVE_ZIP', -14 ); 119 define( 'PCLZIP_ERR_MISSING_OPTION_VALUE', -15 ); 120 define( 'PCLZIP_ERR_INVALID_OPTION_VALUE', -16 ); 121 define( 'PCLZIP_ERR_ALREADY_A_DIRECTORY', -17 ); 122 define( 'PCLZIP_ERR_UNSUPPORTED_COMPRESSION', -18 ); 123 define( 'PCLZIP_ERR_UNSUPPORTED_ENCRYPTION', -19 ); 124 define( 'PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE', -20 ); 125 define( 'PCLZIP_ERR_DIRECTORY_RESTRICTION', -21 ); 126 127 // ----- Options values 128 define( 'PCLZIP_OPT_PATH', 77001 ); 129 define( 'PCLZIP_OPT_ADD_PATH', 77002 ); 130 define( 'PCLZIP_OPT_REMOVE_PATH', 77003 ); 131 define( 'PCLZIP_OPT_REMOVE_ALL_PATH', 77004 ); 132 define( 'PCLZIP_OPT_SET_CHMOD', 77005 ); 133 define( 'PCLZIP_OPT_EXTRACT_AS_STRING', 77006 ); 134 define( 'PCLZIP_OPT_NO_COMPRESSION', 77007 ); 135 define( 'PCLZIP_OPT_BY_NAME', 77008 ); 136 define( 'PCLZIP_OPT_BY_INDEX', 77009 ); 137 define( 'PCLZIP_OPT_BY_EREG', 77010 ); 138 define( 'PCLZIP_OPT_BY_PREG', 77011 ); 139 define( 'PCLZIP_OPT_COMMENT', 77012 ); 140 define( 'PCLZIP_OPT_ADD_COMMENT', 77013 ); 141 define( 'PCLZIP_OPT_PREPEND_COMMENT', 77014 ); 142 define( 'PCLZIP_OPT_EXTRACT_IN_OUTPUT', 77015 ); 143 define( 'PCLZIP_OPT_REPLACE_NEWER', 77016 ); 144 define( 'PCLZIP_OPT_STOP_ON_ERROR', 77017 ); 145 // Having big trouble with crypt. Need to multiply 2 long int 146 // which is not correctly supported by PHP ... 147 //define( 'PCLZIP_OPT_CRYPT', 77018 ); 148 define( 'PCLZIP_OPT_EXTRACT_DIR_RESTRICTION', 77019 ); 149 define( 'PCLZIP_OPT_TEMP_FILE_THRESHOLD', 77020 ); 150 define( 'PCLZIP_OPT_ADD_TEMP_FILE_THRESHOLD', 77020 ); // alias 151 define( 'PCLZIP_OPT_TEMP_FILE_ON', 77021 ); 152 define( 'PCLZIP_OPT_ADD_TEMP_FILE_ON', 77021 ); // alias 153 define( 'PCLZIP_OPT_TEMP_FILE_OFF', 77022 ); 154 define( 'PCLZIP_OPT_ADD_TEMP_FILE_OFF', 77022 ); // alias 155 156 // ----- File description attributes 157 define( 'PCLZIP_ATT_FILE_NAME', 79001 ); 158 define( 'PCLZIP_ATT_FILE_NEW_SHORT_NAME', 79002 ); 159 define( 'PCLZIP_ATT_FILE_NEW_FULL_NAME', 79003 ); 160 define( 'PCLZIP_ATT_FILE_MTIME', 79004 ); 161 define( 'PCLZIP_ATT_FILE_CONTENT', 79005 ); 162 define( 'PCLZIP_ATT_FILE_COMMENT', 79006 ); 163 164 // ----- Call backs values 165 define( 'PCLZIP_CB_PRE_EXTRACT', 78001 ); 166 define( 'PCLZIP_CB_POST_EXTRACT', 78002 ); 167 define( 'PCLZIP_CB_PRE_ADD', 78003 ); 168 define( 'PCLZIP_CB_POST_ADD', 78004 ); 169 /* For futur use 170 define( 'PCLZIP_CB_PRE_LIST', 78005 ); 171 define( 'PCLZIP_CB_POST_LIST', 78006 ); 172 define( 'PCLZIP_CB_PRE_DELETE', 78007 ); 173 define( 'PCLZIP_CB_POST_DELETE', 78008 ); 174 */ 175 176 // -------------------------------------------------------------------------------- 177 // Class : PclZip 178 // Description : 179 // PclZip is the class that represent a Zip archive. 180 // The public methods allow the manipulation of the archive. 181 // Attributes : 182 // Attributes must not be accessed directly. 183 // Methods : 184 // PclZip() : Object creator 185 // create() : Creates the Zip archive 186 // listContent() : List the content of the Zip archive 187 // extract() : Extract the content of the archive 188 // properties() : List the properties of the archive 189 // -------------------------------------------------------------------------------- 190 class PclZip 191 { 192 // ----- Filename of the zip file 193 var $zipname = ''; 194 195 // ----- File descriptor of the zip file 196 var $zip_fd = 0; 197 198 // ----- Internal error handling 199 var $error_code = 1; 200 var $error_string = ''; 201 202 // ----- Current status of the magic_quotes_runtime 203 // This value store the php configuration for magic_quotes 204 // The class can then disable the magic_quotes and reset it after 205 var $magic_quotes_status; 206 207 // -------------------------------------------------------------------------------- 208 // Function : PclZip() 209 // Description : 210 // Creates a PclZip object and set the name of the associated Zip archive 211 // filename. 212 // Note that no real action is taken, if the archive does not exist it is not 213 // created. Use create() for that. 214 // -------------------------------------------------------------------------------- 215 function PclZip($p_zipname) 216 { 217 218 // ----- Tests the zlib 219 if (!function_exists('gzopen')) 220 { 221 die('Abort '.basename(__FILE__).' : Missing zlib extensions'); 222 } 223 224 // ----- Set the attributes 225 $this->zipname = $p_zipname; 226 $this->zip_fd = 0; 227 $this->magic_quotes_status = -1; 228 229 // ----- Return 230 return; 231 } 232 // -------------------------------------------------------------------------------- 233 234 // -------------------------------------------------------------------------------- 235 // Function : 236 // create($p_filelist, $p_add_dir="", $p_remove_dir="") 237 // create($p_filelist, $p_option, $p_option_value, ...) 238 // Description : 239 // This method supports two different synopsis. The first one is historical. 240 // This method creates a Zip Archive. The Zip file is created in the 241 // filesystem. The files and directories indicated in $p_filelist 242 // are added in the archive. See the parameters description for the 243 // supported format of $p_filelist. 244 // When a directory is in the list, the directory and its content is added 245 // in the archive. 246 // In this synopsis, the function takes an optional variable list of 247 // options. See bellow the supported options. 248 // Parameters : 249 // $p_filelist : An array containing file or directory names, or 250 // a string containing one filename or one directory name, or 251 // a string containing a list of filenames and/or directory 252 // names separated by spaces. 253 // $p_add_dir : A path to add before the real path of the archived file, 254 // in order to have it memorized in the archive. 255 // $p_remove_dir : A path to remove from the real path of the file to archive, 256 // in order to have a shorter path memorized in the archive. 257 // When $p_add_dir and $p_remove_dir are set, $p_remove_dir 258 // is removed first, before $p_add_dir is added. 259 // Options : 260 // PCLZIP_OPT_ADD_PATH : 261 // PCLZIP_OPT_REMOVE_PATH : 262 // PCLZIP_OPT_REMOVE_ALL_PATH : 263 // PCLZIP_OPT_COMMENT : 264 // PCLZIP_CB_PRE_ADD : 265 // PCLZIP_CB_POST_ADD : 266 // Return Values : 267 // 0 on failure, 268 // The list of the added files, with a status of the add action. 269 // (see PclZip::listContent() for list entry format) 270 // -------------------------------------------------------------------------------- 271 function create($p_filelist) 272 { 273 $v_result=1; 274 275 // ----- Reset the error handler 276 $this->privErrorReset(); 277 278 // ----- Set default values 279 $v_options = array(); 280 $v_options[PCLZIP_OPT_NO_COMPRESSION] = FALSE; 281 282 // ----- Look for variable options arguments 283 $v_size = func_num_args(); 284 285 // ----- Look for arguments 286 if ($v_size > 1) { 287 // ----- Get the arguments 288 $v_arg_list = func_get_args(); 289 290 // ----- Remove from the options list the first argument 291 array_shift($v_arg_list); 292 $v_size--; 293 294 // ----- Look for first arg 295 if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) { 296 297 // ----- Parse the options 298 $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, 299 array (PCLZIP_OPT_REMOVE_PATH => 'optional', 300 PCLZIP_OPT_REMOVE_ALL_PATH => 'optional', 301 PCLZIP_OPT_ADD_PATH => 'optional', 302 PCLZIP_CB_PRE_ADD => 'optional', 303 PCLZIP_CB_POST_ADD => 'optional', 304 PCLZIP_OPT_NO_COMPRESSION => 'optional', 305 PCLZIP_OPT_COMMENT => 'optional', 306 PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional', 307 PCLZIP_OPT_TEMP_FILE_ON => 'optional', 308 PCLZIP_OPT_TEMP_FILE_OFF => 'optional' 309 //, PCLZIP_OPT_CRYPT => 'optional' 310 )); 311 if ($v_result != 1) { 312 return 0; 313 } 314 } 315 316 // ----- Look for 2 args 317 // Here we need to support the first historic synopsis of the 318 // method. 319 else { 320 321 // ----- Get the first argument 322 $v_options[PCLZIP_OPT_ADD_PATH] = $v_arg_list[0]; 323 324 // ----- Look for the optional second argument 325 if ($v_size == 2) { 326 $v_options[PCLZIP_OPT_REMOVE_PATH] = $v_arg_list[1]; 327 } 328 else if ($v_size > 2) { 329 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, 330 "Invalid number / type of arguments"); 331 return 0; 332 } 333 } 334 } 335 336 // ----- Look for default option values 337 $this->privOptionDefaultThreshold($v_options); 338 339 // ----- Init 340 $v_string_list = array(); 341 $v_att_list = array(); 342 $v_filedescr_list = array(); 343 $p_result_list = array(); 344 345 // ----- Look if the $p_filelist is really an array 346 if (is_array($p_filelist)) { 347 348 // ----- Look if the first element is also an array 349 // This will mean that this is a file description entry 350 if (isset($p_filelist[0]) && is_array($p_filelist[0])) { 351 $v_att_list = $p_filelist; 352 } 353 354 // ----- The list is a list of string names 355 else { 356 $v_string_list = $p_filelist; 357 } 358 } 359 360 // ----- Look if the $p_filelist is a string 361 else if (is_string($p_filelist)) { 362 // ----- Create a list from the string 363 $v_string_list = explode(PCLZIP_SEPARATOR, $p_filelist); 364 } 365 366 // ----- Invalid variable type for $p_filelist 367 else { 368 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type p_filelist"); 369 return 0; 370 } 371 372 // ----- Reformat the string list 373 if (sizeof($v_string_list) != 0) { 374 foreach ($v_string_list as $v_string) { 375 if ($v_string != '') { 376 $v_att_list[][PCLZIP_ATT_FILE_NAME] = $v_string; 377 } 378 else { 379 } 380 } 381 } 382 383 // ----- For each file in the list check the attributes 384 $v_supported_attributes 385 = array ( PCLZIP_ATT_FILE_NAME => 'mandatory' 386 ,PCLZIP_ATT_FILE_NEW_SHORT_NAME => 'optional' 387 ,PCLZIP_ATT_FILE_NEW_FULL_NAME => 'optional' 388 ,PCLZIP_ATT_FILE_MTIME => 'optional' 389 ,PCLZIP_ATT_FILE_CONTENT => 'optional' 390 ,PCLZIP_ATT_FILE_COMMENT => 'optional' 391 ); 392 foreach ($v_att_list as $v_entry) { 393 $v_result = $this->privFileDescrParseAtt($v_entry, 394 $v_filedescr_list[], 395 $v_options, 396 $v_supported_attributes); 397 if ($v_result != 1) { 398 return 0; 399 } 400 } 401 402 // ----- Expand the filelist (expand directories) 403 $v_result = $this->privFileDescrExpand($v_filedescr_list, $v_options); 404 if ($v_result != 1) { 405 return 0; 406 } 407 408 // ----- Call the create fct 409 $v_result = $this->privCreate($v_filedescr_list, $p_result_list, $v_options); 410 if ($v_result != 1) { 411 return 0; 412 } 413 414 // ----- Return 415 return $p_result_list; 416 } 417 // -------------------------------------------------------------------------------- 418 419 // -------------------------------------------------------------------------------- 420 // Function : 421 // add($p_filelist, $p_add_dir="", $p_remove_dir="") 422 // add($p_filelist, $p_option, $p_option_value, ...) 423 // Description : 424 // This method supports two synopsis. The first one is historical. 425 // This methods add the list of files in an existing archive. 426 // If a file with the same name already exists, it is added at the end of the 427 // archive, the first one is still present. 428 // If the archive does not exist, it is created. 429 // Parameters : 430 // $p_filelist : An array containing file or directory names, or 431 // a string containing one filename or one directory name, or 432 // a string containing a list of filenames and/or directory 433 // names separated by spaces. 434 // $p_add_dir : A path to add before the real path of the archived file, 435 // in order to have it memorized in the archive. 436 // $p_remove_dir : A path to remove from the real path of the file to archive, 437 // in order to have a shorter path memorized in the archive. 438 // When $p_add_dir and $p_remove_dir are set, $p_remove_dir 439 // is removed first, before $p_add_dir is added. 440 // Options : 441 // PCLZIP_OPT_ADD_PATH : 442 // PCLZIP_OPT_REMOVE_PATH : 443 // PCLZIP_OPT_REMOVE_ALL_PATH : 444 // PCLZIP_OPT_COMMENT : 445 // PCLZIP_OPT_ADD_COMMENT : 446 // PCLZIP_OPT_PREPEND_COMMENT : 447 // PCLZIP_CB_PRE_ADD : 448 // PCLZIP_CB_POST_ADD : 449 // Return Values : 450 // 0 on failure, 451 // The list of the added files, with a status of the add action. 452 // (see PclZip::listContent() for list entry format) 453 // -------------------------------------------------------------------------------- 454 function add($p_filelist) 455 { 456 $v_result=1; 457 458 // ----- Reset the error handler 459 $this->privErrorReset(); 460 461 // ----- Set default values 462 $v_options = array(); 463 $v_options[PCLZIP_OPT_NO_COMPRESSION] = FALSE; 464 465 // ----- Look for variable options arguments 466 $v_size = func_num_args(); 467 468 // ----- Look for arguments 469 if ($v_size > 1) { 470 // ----- Get the arguments 471 $v_arg_list = func_get_args(); 472 473 // ----- Remove form the options list the first argument 474 array_shift($v_arg_list); 475 $v_size--; 476 477 // ----- Look for first arg 478 if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) { 479 480 // ----- Parse the options 481 $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, 482 array (PCLZIP_OPT_REMOVE_PATH => 'optional', 483 PCLZIP_OPT_REMOVE_ALL_PATH => 'optional', 484 PCLZIP_OPT_ADD_PATH => 'optional', 485 PCLZIP_CB_PRE_ADD => 'optional', 486 PCLZIP_CB_POST_ADD => 'optional', 487 PCLZIP_OPT_NO_COMPRESSION => 'optional', 488 PCLZIP_OPT_COMMENT => 'optional', 489 PCLZIP_OPT_ADD_COMMENT => 'optional', 490 PCLZIP_OPT_PREPEND_COMMENT => 'optional', 491 PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional', 492 PCLZIP_OPT_TEMP_FILE_ON => 'optional', 493 PCLZIP_OPT_TEMP_FILE_OFF => 'optional' 494 //, PCLZIP_OPT_CRYPT => 'optional' 495 )); 496 if ($v_result != 1) { 497 return 0; 498 } 499 } 500 501 // ----- Look for 2 args 502 // Here we need to support the first historic synopsis of the 503 // method. 504 else { 505 506 // ----- Get the first argument 507 $v_options[PCLZIP_OPT_ADD_PATH] = $v_add_path = $v_arg_list[0]; 508 509 // ----- Look for the optional second argument 510 if ($v_size == 2) { 511 $v_options[PCLZIP_OPT_REMOVE_PATH] = $v_arg_list[1]; 512 } 513 else if ($v_size > 2) { 514 // ----- Error log 515 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments"); 516 517 // ----- Return 518 return 0; 519 } 520 } 521 } 522 523 // ----- Look for default option values 524 $this->privOptionDefaultThreshold($v_options); 525 526 // ----- Init 527 $v_string_list = array(); 528 $v_att_list = array(); 529 $v_filedescr_list = array(); 530 $p_result_list = array(); 531 532 // ----- Look if the $p_filelist is really an array 533 if (is_array($p_filelist)) { 534 535 // ----- Look if the first element is also an array 536 // This will mean that this is a file description entry 537 if (isset($p_filelist[0]) && is_array($p_filelist[0])) { 538 $v_att_list = $p_filelist; 539 } 540 541 // ----- The list is a list of string names 542 else { 543 $v_string_list = $p_filelist; 544 } 545 } 546 547 // ----- Look if the $p_filelist is a string 548 else if (is_string($p_filelist)) { 549 // ----- Create a list from the string 550 $v_string_list = explode(PCLZIP_SEPARATOR, $p_filelist); 551 } 552 553 // ----- Invalid variable type for $p_filelist 554 else { 555 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type '".gettype($p_filelist)."' for p_filelist"); 556 return 0; 557 } 558 559 // ----- Reformat the string list 560 if (sizeof($v_string_list) != 0) { 561 foreach ($v_string_list as $v_string) { 562 $v_att_list[][PCLZIP_ATT_FILE_NAME] = $v_string; 563 } 564 } 565 566 // ----- For each file in the list check the attributes 567 $v_supported_attributes 568 = array ( PCLZIP_ATT_FILE_NAME => 'mandatory' 569 ,PCLZIP_ATT_FILE_NEW_SHORT_NAME => 'optional' 570 ,PCLZIP_ATT_FILE_NEW_FULL_NAME => 'optional' 571 ,PCLZIP_ATT_FILE_MTIME => 'optional' 572 ,PCLZIP_ATT_FILE_CONTENT => 'optional' 573 ,PCLZIP_ATT_FILE_COMMENT => 'optional' 574 ); 575 foreach ($v_att_list as $v_entry) { 576 $v_result = $this->privFileDescrParseAtt($v_entry, 577 $v_filedescr_list[], 578 $v_options, 579 $v_supported_attributes); 580 if ($v_result != 1) { 581 return 0; 582 } 583 } 584 585 // ----- Expand the filelist (expand directories) 586 $v_result = $this->privFileDescrExpand($v_filedescr_list, $v_options); 587 if ($v_result != 1) { 588 return 0; 589 } 590 591 // ----- Call the create fct 592 $v_result = $this->privAdd($v_filedescr_list, $p_result_list, $v_options); 593 if ($v_result != 1) { 594 return 0; 595 } 596 597 // ----- Return 598 return $p_result_list; 599 } 600 // -------------------------------------------------------------------------------- 601 602 // -------------------------------------------------------------------------------- 603 // Function : listContent() 604 // Description : 605 // This public method, gives the list of the files and directories, with their 606 // properties. 607 // The properties of each entries in the list are (used also in other functions) : 608 // filename : Name of the file. For a create or add action it is the filename 609 // given by the user. For an extract function it is the filename 610 // of the extracted file. 611 // stored_filename : Name of the file / directory stored in the archive. 612 // size : Size of the stored file. 613 // compressed_size : Size of the file's data compressed in the archive 614 // (without the headers overhead) 615 // mtime : Last known modification date of the file (UNIX timestamp) 616 // comment : Comment associated with the file 617 // folder : true | false 618 // index : index of the file in the archive 619 // status : status of the action (depending of the action) : 620 // Values are : 621 // ok : OK ! 622 // filtered : the file / dir is not extracted (filtered by user) 623 // already_a_directory : the file can not be extracted because a 624 // directory with the same name already exists 625 // write_protected : the file can not be extracted because a file 626 // with the same name already exists and is 627 // write protected 628 // newer_exist : the file was not extracted because a newer file exists 629 // path_creation_fail : the file is not extracted because the folder 630 // does not exist and can not be created 631 // write_error : the file was not extracted because there was a 632 // error while writing the file 633 // read_error : the file was not extracted because there was a error 634 // while reading the file 635 // invalid_header : the file was not extracted because of an archive 636 // format error (bad file header) 637 // Note that each time a method can continue operating when there 638 // is an action error on a file, the error is only logged in the file status. 639 // Return Values : 640 // 0 on an unrecoverable failure, 641 // The list of the files in the archive. 642 // -------------------------------------------------------------------------------- 643 function listContent() 644 { 645 $v_result=1; 646 647 // ----- Reset the error handler 648 $this->privErrorReset(); 649 650 // ----- Check archive 651 if (!$this->privCheckFormat()) { 652 return(0); 653 } 654 655 // ----- Call the extracting fct 656 $p_list = array(); 657 if (($v_result = $this->privList($p_list)) != 1) 658 { 659 unset($p_list); 660 return(0); 661 } 662 663 // ----- Return 664 return $p_list; 665 } 666 // -------------------------------------------------------------------------------- 667 668 // -------------------------------------------------------------------------------- 669 // Function : 670 // extract($p_path="./", $p_remove_path="") 671 // extract([$p_option, $p_option_value, ...]) 672 // Description : 673 // This method supports two synopsis. The first one is historical. 674 // This method extract all the files / directories from the archive to the 675 // folder indicated in $p_path. 676 // If you want to ignore the 'root' part of path of the memorized files 677 // you can indicate this in the optional $p_remove_path parameter. 678 // By default, if a newer file with the same name already exists, the 679 // file is not extracted. 680 // 681 // If both PCLZIP_OPT_PATH and PCLZIP_OPT_ADD_PATH aoptions 682 // are used, the path indicated in PCLZIP_OPT_ADD_PATH is append 683 // at the end of the path value of PCLZIP_OPT_PATH. 684 // Parameters : 685 // $p_path : Path where the files and directories are to be extracted 686 // $p_remove_path : First part ('root' part) of the memorized path 687 // (if any similar) to remove while extracting. 688 // Options : 689 // PCLZIP_OPT_PATH : 690 // PCLZIP_OPT_ADD_PATH : 691 // PCLZIP_OPT_REMOVE_PATH : 692 // PCLZIP_OPT_REMOVE_ALL_PATH : 693 // PCLZIP_CB_PRE_EXTRACT : 694 // PCLZIP_CB_POST_EXTRACT : 695 // Return Values : 696 // 0 or a negative value on failure, 697 // The list of the extracted files, with a status of the action. 698 // (see PclZip::listContent() for list entry format) 699 // -------------------------------------------------------------------------------- 700 function extract() 701 { 702 $v_result=1; 703 704 // ----- Reset the error handler 705 $this->privErrorReset(); 706 707 // ----- Check archive 708 if (!$this->privCheckFormat()) { 709 return(0); 710 } 711 712 // ----- Set default values 713 $v_options = array(); 714 // $v_path = "./"; 715 $v_path = ''; 716 $v_remove_path = ""; 717 $v_remove_all_path = false; 718 719 // ----- Look for variable options arguments 720 $v_size = func_num_args(); 721 722 // ----- Default values for option 723 $v_options[PCLZIP_OPT_EXTRACT_AS_STRING] = FALSE; 724 725 // ----- Look for arguments 726 if ($v_size > 0) { 727 // ----- Get the arguments 728 $v_arg_list = func_get_args(); 729 730 // ----- Look for first arg 731 if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) { 732 733 // ----- Parse the options 734 $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, 735 array (PCLZIP_OPT_PATH => 'optional', 736 PCLZIP_OPT_REMOVE_PATH => 'optional', 737 PCLZIP_OPT_REMOVE_ALL_PATH => 'optional', 738 PCLZIP_OPT_ADD_PATH => 'optional', 739 PCLZIP_CB_PRE_EXTRACT => 'optional', 740 PCLZIP_CB_POST_EXTRACT => 'optional', 741 PCLZIP_OPT_SET_CHMOD => 'optional', 742 PCLZIP_OPT_BY_NAME => 'optional', 743 PCLZIP_OPT_BY_EREG => 'optional', 744 PCLZIP_OPT_BY_PREG => 'optional', 745 PCLZIP_OPT_BY_INDEX => 'optional', 746 PCLZIP_OPT_EXTRACT_AS_STRING => 'optional', 747 PCLZIP_OPT_EXTRACT_IN_OUTPUT => 'optional', 748 PCLZIP_OPT_REPLACE_NEWER => 'optional' 749 ,PCLZIP_OPT_STOP_ON_ERROR => 'optional' 750 ,PCLZIP_OPT_EXTRACT_DIR_RESTRICTION => 'optional', 751 PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional', 752 PCLZIP_OPT_TEMP_FILE_ON => 'optional', 753 PCLZIP_OPT_TEMP_FILE_OFF => 'optional' 754 )); 755 if ($v_result != 1) { 756 return 0; 757 } 758 759 // ----- Set the arguments 760 if (isset($v_options[PCLZIP_OPT_PATH])) { 761 $v_path = $v_options[PCLZIP_OPT_PATH]; 762 } 763 if (isset($v_options[PCLZIP_OPT_REMOVE_PATH])) { 764 $v_remove_path = $v_options[PCLZIP_OPT_REMOVE_PATH]; 765 } 766 if (isset($v_options[PCLZIP_OPT_REMOVE_ALL_PATH])) { 767 $v_remove_all_path = $v_options[PCLZIP_OPT_REMOVE_ALL_PATH]; 768 } 769 if (isset($v_options[PCLZIP_OPT_ADD_PATH])) { 770 // ----- Check for '/' in last path char 771 if ((strlen($v_path) > 0) && (substr($v_path, -1) != '/')) { 772 $v_path .= '/'; 773 } 774 $v_path .= $v_options[PCLZIP_OPT_ADD_PATH]; 775 } 776 } 777 778 // ----- Look for 2 args 779 // Here we need to support the first historic synopsis of the 780 // method. 781 else { 782 783 // ----- Get the first argument 784 $v_path = $v_arg_list[0]; 785 786 // ----- Look for the optional second argument 787 if ($v_size == 2) { 788 $v_remove_path = $v_arg_list[1]; 789 } 790 else if ($v_size > 2) { 791 // ----- Error log 792 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments"); 793 794 // ----- Return 795 return 0; 796 } 797 } 798 } 799 800 // ----- Look for default option values 801 $this->privOptionDefaultThreshold($v_options); 802 803 // ----- Trace 804 805 // ----- Call the extracting fct 806 $p_list = array(); 807 $v_result = $this->privExtractByRule($p_list, $v_path, $v_remove_path, 808 $v_remove_all_path, $v_options); 809 if ($v_result < 1) { 810 unset($p_list); 811 return(0); 812 } 813 814 // ----- Return 815 return $p_list; 816 } 817 // -------------------------------------------------------------------------------- 818 819 820 // -------------------------------------------------------------------------------- 821 // Function : 822 // extractByIndex($p_index, $p_path="./", $p_remove_path="") 823 // extractByIndex($p_index, [$p_option, $p_option_value, ...]) 824 // Description : 825 // This method supports two synopsis. The first one is historical. 826 // This method is doing a partial extract of the archive. 827 // The extracted files or folders are identified by their index in the 828 // archive (from 0 to n). 829 // Note that if the index identify a folder, only the folder entry is 830 // extracted, not all the files included in the archive. 831 // Parameters : 832 // $p_index : A single index (integer) or a string of indexes of files to 833 // extract. The form of the string is "0,4-6,8-12" with only numbers 834 // and '-' for range or ',' to separate ranges. No spaces or ';' 835 // are allowed. 836 // $p_path : Path where the files and directories are to be extracted 837 // $p_remove_path : First part ('root' part) of the memorized path 838 // (if any similar) to remove while extracting. 839 // Options : 840 // PCLZIP_OPT_PATH : 841 // PCLZIP_OPT_ADD_PATH : 842 // PCLZIP_OPT_REMOVE_PATH : 843 // PCLZIP_OPT_REMOVE_ALL_PATH : 844 // PCLZIP_OPT_EXTRACT_AS_STRING : The files are extracted as strings and 845 // not as files. 846 // The resulting content is in a new field 'content' in the file 847 // structure. 848 // This option must be used alone (any other options are ignored). 849 // PCLZIP_CB_PRE_EXTRACT : 850 // PCLZIP_CB_POST_EXTRACT : 851 // Return Values : 852 // 0 on failure, 853 // The list of the extracted files, with a status of the action. 854 // (see PclZip::listContent() for list entry format) 855 // -------------------------------------------------------------------------------- 856 //function extractByIndex($p_index, options...) 857 function extractByIndex($p_index) 858 { 859 $v_result=1; 860 861 // ----- Reset the error handler 862 $this->privErrorReset(); 863 864 // ----- Check archive 865 if (!$this->privCheckFormat()) { 866 return(0); 867 } 868 869 // ----- Set default values 870 $v_options = array(); 871 // $v_path = "./"; 872 $v_path = ''; 873 $v_remove_path = ""; 874 $v_remove_all_path = false; 875 876 // ----- Look for variable options arguments 877 $v_size = func_num_args(); 878 879 // ----- Default values for option 880 $v_options[PCLZIP_OPT_EXTRACT_AS_STRING] = FALSE; 881 882 // ----- Look for arguments 883 if ($v_size > 1) { 884 // ----- Get the arguments 885 $v_arg_list = func_get_args(); 886 887 // ----- Remove form the options list the first argument 888 array_shift($v_arg_list); 889 $v_size--; 890 891 // ----- Look for first arg 892 if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) { 893 894 // ----- Parse the options 895 $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, 896 array (PCLZIP_OPT_PATH => 'optional', 897 PCLZIP_OPT_REMOVE_PATH => 'optional', 898 PCLZIP_OPT_REMOVE_ALL_PATH => 'optional', 899 PCLZIP_OPT_EXTRACT_AS_STRING => 'optional', 900 PCLZIP_OPT_ADD_PATH => 'optional', 901 PCLZIP_CB_PRE_EXTRACT => 'optional', 902 PCLZIP_CB_POST_EXTRACT => 'optional', 903 PCLZIP_OPT_SET_CHMOD => 'optional', 904 PCLZIP_OPT_REPLACE_NEWER => 'optional' 905 ,PCLZIP_OPT_STOP_ON_ERROR => 'optional' 906 ,PCLZIP_OPT_EXTRACT_DIR_RESTRICTION => 'optional', 907 PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional', 908 PCLZIP_OPT_TEMP_FILE_ON => 'optional', 909 PCLZIP_OPT_TEMP_FILE_OFF => 'optional' 910 )); 911 if ($v_result != 1) { 912 return 0; 913 } 914 915 // ----- Set the arguments 916 if (isset($v_options[PCLZIP_OPT_PATH])) { 917 $v_path = $v_options[PCLZIP_OPT_PATH]; 918 } 919 if (isset($v_options[PCLZIP_OPT_REMOVE_PATH])) { 920 $v_remove_path = $v_options[PCLZIP_OPT_REMOVE_PATH]; 921 } 922 if (isset($v_options[PCLZIP_OPT_REMOVE_ALL_PATH])) { 923 $v_remove_all_path = $v_options[PCLZIP_OPT_REMOVE_ALL_PATH]; 924 } 925 if (isset($v_options[PCLZIP_OPT_ADD_PATH])) { 926 // ----- Check for '/' in last path char 927 if ((strlen($v_path) > 0) && (substr($v_path, -1) != '/')) { 928 $v_path .= '/'; 929 } 930 $v_path .= $v_options[PCLZIP_OPT_ADD_PATH]; 931 } 932 if (!isset($v_options[PCLZIP_OPT_EXTRACT_AS_STRING])) { 933 $v_options[PCLZIP_OPT_EXTRACT_AS_STRING] = FALSE; 934 } 935 else { 936 } 937 } 938 939 // ----- Look for 2 args 940 // Here we need to support the first historic synopsis of the 941 // method. 942 else { 943 944 // ----- Get the first argument 945 $v_path = $v_arg_list[0]; 946 947 // ----- Look for the optional second argument 948 if ($v_size == 2) { 949 $v_remove_path = $v_arg_list[1]; 950 } 951 else if ($v_size > 2) { 952 // ----- Error log 953 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments"); 954 955 // ----- Return 956 return 0; 957 } 958 } 959 } 960 961 // ----- Trace 962 963 // ----- Trick 964 // Here I want to reuse extractByRule(), so I need to parse the $p_index 965 // with privParseOptions() 966 $v_arg_trick = array (PCLZIP_OPT_BY_INDEX, $p_index); 967 $v_options_trick = array(); 968 $v_result = $this->privParseOptions($v_arg_trick, sizeof($v_arg_trick), $v_options_trick, 969 array (PCLZIP_OPT_BY_INDEX => 'optional' )); 970 if ($v_result != 1) { 971 return 0; 972 } 973 $v_options[PCLZIP_OPT_BY_INDEX] = $v_options_trick[PCLZIP_OPT_BY_INDEX]; 974 975 // ----- Look for default option values 976 $this->privOptionDefaultThreshold($v_options); 977 978 // ----- Call the extracting fct 979 if (($v_result = $this->privExtractByRule($p_list, $v_path, $v_remove_path, $v_remove_all_path, $v_options)) < 1) { 980 return(0); 981 } 982 983 // ----- Return 984 return $p_list; 985 } 986 // -------------------------------------------------------------------------------- 987 988 // -------------------------------------------------------------------------------- 989 // Function : 990 // delete([$p_option, $p_option_value, ...]) 991 // Description : 992 // This method removes files from the archive. 993 // If no parameters are given, then all the archive is emptied. 994 // Parameters : 995 // None or optional arguments. 996 // Options : 997 // PCLZIP_OPT_BY_INDEX : 998 // PCLZIP_OPT_BY_NAME : 999 // PCLZIP_OPT_BY_EREG : 1000 // PCLZIP_OPT_BY_PREG : 1001 // Return Values : 1002 // 0 on failure, 1003 // The list of the files which are still present in the archive. 1004 // (see PclZip::listContent() for list entry format) 1005 // -------------------------------------------------------------------------------- 1006 function delete() 1007 { 1008 $v_result=1; 1009 1010 // ----- Reset the error handler 1011 $this->privErrorReset(); 1012 1013 // ----- Check archive 1014 if (!$this->privCheckFormat()) { 1015 return(0); 1016 } 1017 1018 // ----- Set default values 1019 $v_options = array(); 1020 1021 // ----- Look for variable options arguments 1022 $v_size = func_num_args(); 1023 1024 // ----- Look for arguments 1025 if ($v_size > 0) { 1026 // ----- Get the arguments 1027 $v_arg_list = func_get_args(); 1028 1029 // ----- Parse the options 1030 $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, 1031 array (PCLZIP_OPT_BY_NAME => 'optional', 1032 PCLZIP_OPT_BY_EREG => 'optional', 1033 PCLZIP_OPT_BY_PREG => 'optional', 1034 PCLZIP_OPT_BY_INDEX => 'optional' )); 1035 if ($v_result != 1) { 1036 return 0; 1037 } 1038 } 1039 1040 // ----- Magic quotes trick 1041 $this->privDisableMagicQuotes(); 1042 1043 // ----- Call the delete fct 1044 $v_list = array(); 1045 if (($v_result = $this->privDeleteByRule($v_list, $v_options)) != 1) { 1046 $this->privSwapBackMagicQuotes(); 1047 unset($v_list); 1048 return(0); 1049 } 1050 1051 // ----- Magic quotes trick 1052 $this->privSwapBackMagicQuotes(); 1053 1054 // ----- Return 1055 return $v_list; 1056 } 1057 // -------------------------------------------------------------------------------- 1058 1059 // -------------------------------------------------------------------------------- 1060 // Function : deleteByIndex() 1061 // Description : 1062 // ***** Deprecated ***** 1063 // delete(PCLZIP_OPT_BY_INDEX, $p_index) should be prefered. 1064 // -------------------------------------------------------------------------------- 1065 function deleteByIndex($p_index) 1066 { 1067 1068 $p_list = $this->delete(PCLZIP_OPT_BY_INDEX, $p_index); 1069 1070 // ----- Return 1071 return $p_list; 1072 } 1073 // -------------------------------------------------------------------------------- 1074 1075 // -------------------------------------------------------------------------------- 1076 // Function : properties() 1077 // Description : 1078 // This method gives the properties of the archive. 1079 // The properties are : 1080 // nb : Number of files in the archive 1081 // comment : Comment associated with the archive file 1082 // status : not_exist, ok 1083 // Parameters : 1084 // None 1085 // Return Values : 1086 // 0 on failure, 1087 // An array with the archive properties. 1088 // -------------------------------------------------------------------------------- 1089 function properties() 1090 { 1091 1092 // ----- Reset the error handler 1093 $this->privErrorReset(); 1094 1095 // ----- Magic quotes trick 1096 $this->privDisableMagicQuotes(); 1097 1098 // ----- Check archive 1099 if (!$this->privCheckFormat()) { 1100 $this->privSwapBackMagicQuotes(); 1101 return(0); 1102 } 1103 1104 // ----- Default properties 1105 $v_prop = array(); 1106 $v_prop['comment'] = ''; 1107 $v_prop['nb'] = 0; 1108 $v_prop['status'] = 'not_exist'; 1109 1110 // ----- Look if file exists 1111 if (@is_file($this->zipname)) 1112 { 1113 // ----- Open the zip file 1114 if (($this->zip_fd = @fopen($this->zipname, 'rb')) == 0) 1115 { 1116 $this->privSwapBackMagicQuotes(); 1117 1118 // ----- Error log 1119 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive \''.$this->zipname.'\' in binary read mode'); 1120 1121 // ----- Return 1122 return 0; 1123 } 1124 1125 // ----- Read the central directory informations 1126 $v_central_dir = array(); 1127 if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) 1128 { 1129 $this->privSwapBackMagicQuotes(); 1130 return 0; 1131 } 1132 1133 // ----- Close the zip file 1134 $this->privCloseFd(); 1135 1136 // ----- Set the user attributes 1137 $v_prop['comment'] = $v_central_dir['comment']; 1138 $v_prop['nb'] = $v_central_dir['entries']; 1139 $v_prop['status'] = 'ok'; 1140 } 1141 1142 // ----- Magic quotes trick 1143 $this->privSwapBackMagicQuotes(); 1144 1145 // ----- Return 1146 return $v_prop; 1147 } 1148 // -------------------------------------------------------------------------------- 1149 1150 // -------------------------------------------------------------------------------- 1151 // Function : duplicate() 1152 // Description : 1153 // This method creates an archive by copying the content of an other one. If 1154 // the archive already exist, it is replaced by the new one without any warning. 1155 // Parameters : 1156 // $p_archive : The filename of a valid archive, or 1157 // a valid PclZip object. 1158 // Return Values : 1159 // 1 on success. 1160 // 0 or a negative value on error (error code). 1161 // -------------------------------------------------------------------------------- 1162 function duplicate($p_archive) 1163 { 1164 $v_result = 1; 1165 1166 // ----- Reset the error handler 1167 $this->privErrorReset(); 1168 1169 // ----- Look if the $p_archive is a PclZip object 1170 if ((is_object($p_archive)) && (get_class($p_archive) == 'pclzip')) 1171 { 1172 1173 // ----- Duplicate the archive 1174 $v_result = $this->privDuplicate($p_archive->zipname); 1175 } 1176 1177 // ----- Look if the $p_archive is a string (so a filename) 1178 else if (is_string($p_archive)) 1179 { 1180 1181 // ----- Check that $p_archive is a valid zip file 1182 // TBC : Should also check the archive format 1183 if (!is_file($p_archive)) { 1184 // ----- Error log 1185 PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "No file with filename '".$p_archive."'"); 1186 $v_result = PCLZIP_ERR_MISSING_FILE; 1187 } 1188 else { 1189 // ----- Duplicate the archive 1190 $v_result = $this->privDuplicate($p_archive); 1191 } 1192 } 1193 1194 // ----- Invalid variable 1195 else 1196 { 1197 // ----- Error log 1198 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type p_archive_to_add"); 1199 $v_result = PCLZIP_ERR_INVALID_PARAMETER; 1200 } 1201 1202 // ----- Return 1203 return $v_result; 1204 } 1205 // -------------------------------------------------------------------------------- 1206 1207 // -------------------------------------------------------------------------------- 1208 // Function : merge() 1209 // Description : 1210 // This method merge the $p_archive_to_add archive at the end of the current 1211 // one ($this). 1212 // If the archive ($this) does not exist, the merge becomes a duplicate. 1213 // If the $p_archive_to_add archive does not exist, the merge is a success. 1214 // Parameters : 1215 // $p_archive_to_add : It can be directly the filename of a valid zip archive, 1216 // or a PclZip object archive. 1217 // Return Values : 1218 // 1 on success, 1219 // 0 or negative values on error (see below). 1220 // -------------------------------------------------------------------------------- 1221 function merge($p_archive_to_add) 1222 { 1223 $v_result = 1; 1224 1225 // ----- Reset the error handler 1226 $this->privErrorReset(); 1227 1228 // ----- Check archive 1229 if (!$this->privCheckFormat()) { 1230 return(0); 1231 } 1232 1233 // ----- Look if the $p_archive_to_add is a PclZip object 1234 if ((is_object($p_archive_to_add)) && (get_class($p_archive_to_add) == 'pclzip')) 1235 { 1236 1237 // ----- Merge the archive 1238 $v_result = $this->privMerge($p_archive_to_add); 1239 } 1240 1241 // ----- Look if the $p_archive_to_add is a string (so a filename) 1242 else if (is_string($p_archive_to_add)) 1243 { 1244 1245 // ----- Create a temporary archive 1246 $v_object_archive = new PclZip($p_archive_to_add); 1247 1248 // ----- Merge the archive 1249 $v_result = $this->privMerge($v_object_archive); 1250 } 1251 1252 // ----- Invalid variable 1253 else 1254 { 1255 // ----- Error log 1256 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type p_archive_to_add"); 1257 $v_result = PCLZIP_ERR_INVALID_PARAMETER; 1258 } 1259 1260 // ----- Return 1261 return $v_result; 1262 } 1263 // -------------------------------------------------------------------------------- 1264 1265 1266 1267 // -------------------------------------------------------------------------------- 1268 // Function : errorCode() 1269 // Description : 1270 // Parameters : 1271 // -------------------------------------------------------------------------------- 1272 function errorCode() 1273 { 1274 if (PCLZIP_ERROR_EXTERNAL == 1) { 1275 return(PclErrorCode()); 1276 } 1277 else { 1278 return($this->error_code); 1279 } 1280 } 1281 // -------------------------------------------------------------------------------- 1282 1283 // -------------------------------------------------------------------------------- 1284 // Function : errorName() 1285 // Description : 1286 // Parameters : 1287 // -------------------------------------------------------------------------------- 1288 function errorName($p_with_code=false) 1289 { 1290 $v_name = array ( PCLZIP_ERR_NO_ERROR => 'PCLZIP_ERR_NO_ERROR', 1291 PCLZIP_ERR_WRITE_OPEN_FAIL => 'PCLZIP_ERR_WRITE_OPEN_FAIL', 1292 PCLZIP_ERR_READ_OPEN_FAIL => 'PCLZIP_ERR_READ_OPEN_FAIL', 1293 PCLZIP_ERR_INVALID_PARAMETER => 'PCLZIP_ERR_INVALID_PARAMETER', 1294 PCLZIP_ERR_MISSING_FILE => 'PCLZIP_ERR_MISSING_FILE', 1295 PCLZIP_ERR_FILENAME_TOO_LONG => 'PCLZIP_ERR_FILENAME_TOO_LONG', 1296 PCLZIP_ERR_INVALID_ZIP => 'PCLZIP_ERR_INVALID_ZIP', 1297 PCLZIP_ERR_BAD_EXTRACTED_FILE => 'PCLZIP_ERR_BAD_EXTRACTED_FILE', 1298 PCLZIP_ERR_DIR_CREATE_FAIL => 'PCLZIP_ERR_DIR_CREATE_FAIL', 1299 PCLZIP_ERR_BAD_EXTENSION => 'PCLZIP_ERR_BAD_EXTENSION', 1300 PCLZIP_ERR_BAD_FORMAT => 'PCLZIP_ERR_BAD_FORMAT', 1301 PCLZIP_ERR_DELETE_FILE_FAIL => 'PCLZIP_ERR_DELETE_FILE_FAIL', 1302 PCLZIP_ERR_RENAME_FILE_FAIL => 'PCLZIP_ERR_RENAME_FILE_FAIL', 1303 PCLZIP_ERR_BAD_CHECKSUM => 'PCLZIP_ERR_BAD_CHECKSUM', 1304 PCLZIP_ERR_INVALID_ARCHIVE_ZIP => 'PCLZIP_ERR_INVALID_ARCHIVE_ZIP', 1305 PCLZIP_ERR_MISSING_OPTION_VALUE => 'PCLZIP_ERR_MISSING_OPTION_VALUE', 1306 PCLZIP_ERR_INVALID_OPTION_VALUE => 'PCLZIP_ERR_INVALID_OPTION_VALUE', 1307 PCLZIP_ERR_UNSUPPORTED_COMPRESSION => 'PCLZIP_ERR_UNSUPPORTED_COMPRESSION', 1308 PCLZIP_ERR_UNSUPPORTED_ENCRYPTION => 'PCLZIP_ERR_UNSUPPORTED_ENCRYPTION' 1309 ,PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE => 'PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE' 1310 ,PCLZIP_ERR_DIRECTORY_RESTRICTION => 'PCLZIP_ERR_DIRECTORY_RESTRICTION' 1311 ); 1312 1313 if (isset($v_name[$this->error_code])) { 1314 $v_value = $v_name[$this->error_code]; 1315 } 1316 else { 1317 $v_value = 'NoName'; 1318 } 1319 1320 if ($p_with_code) { 1321 return($v_value.' ('.$this->error_code.')'); 1322 } 1323 else { 1324 return($v_value); 1325 } 1326 } 1327 // -------------------------------------------------------------------------------- 1328 1329 // -------------------------------------------------------------------------------- 1330 // Function : errorInfo() 1331 // Description : 1332 // Parameters : 1333 // -------------------------------------------------------------------------------- 1334 function errorInfo($p_full=false) 1335 { 1336 if (PCLZIP_ERROR_EXTERNAL == 1) { 1337 return(PclErrorString()); 1338 } 1339 else { 1340 if ($p_full) { 1341 return($this->errorName(true)." : ".$this->error_string); 1342 } 1343 else { 1344 return($this->error_string." [code ".$this->error_code."]"); 1345 } 1346 } 1347 } 1348 // -------------------------------------------------------------------------------- 1349 1350 1351 // -------------------------------------------------------------------------------- 1352 // ***** UNDER THIS LINE ARE DEFINED PRIVATE INTERNAL FUNCTIONS ***** 1353 // ***** ***** 1354 // ***** THESES FUNCTIONS MUST NOT BE USED DIRECTLY ***** 1355 // -------------------------------------------------------------------------------- 1356 1357 1358 1359 // -------------------------------------------------------------------------------- 1360 // Function : privCheckFormat() 1361 // Description : 1362 // This method check that the archive exists and is a valid zip archive. 1363 // Several level of check exists. (futur) 1364 // Parameters : 1365 // $p_level : Level of check. Default 0. 1366 // 0 : Check the first bytes (magic codes) (default value)) 1367 // 1 : 0 + Check the central directory (futur) 1368 // 2 : 1 + Check each file header (futur) 1369 // Return Values : 1370 // true on success, 1371 // false on error, the error code is set. 1372 // -------------------------------------------------------------------------------- 1373 function privCheckFormat($p_level=0) 1374 { 1375 $v_result = true; 1376 1377 // ----- Reset the file system cache 1378 clearstatcache(); 1379 1380 // ----- Reset the error handler 1381 $this->privErrorReset(); 1382 1383 // ----- Look if the file exits 1384 if (!is_file($this->zipname)) { 1385 // ----- Error log 1386 PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "Missing archive file '".$this->zipname."'"); 1387 return(false); 1388 } 1389 1390 // ----- Check that the file is readeable 1391 if (!is_readable($this->zipname)) { 1392 // ----- Error log 1393 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, "Unable to read archive '".$this->zipname."'"); 1394 return(false); 1395 } 1396 1397 // ----- Check the magic code 1398 // TBC 1399 1400 // ----- Check the central header 1401 // TBC 1402 1403 // ----- Check each file header 1404 // TBC 1405 1406 // ----- Return 1407 return $v_result; 1408 } 1409 // -------------------------------------------------------------------------------- 1410 1411 // -------------------------------------------------------------------------------- 1412 // Function : privParseOptions() 1413 // Description : 1414 // This internal methods reads the variable list of arguments ($p_options_list, 1415 // $p_size) and generate an array with the options and values ($v_result_list). 1416 // $v_requested_options contains the options that can be present and those that 1417 // must be present. 1418 // $v_requested_options is an array, with the option value as key, and 'optional', 1419 // or 'mandatory' as value. 1420 // Parameters : 1421 // See above. 1422 // Return Values : 1423 // 1 on success. 1424 // 0 on failure. 1425 // -------------------------------------------------------------------------------- 1426 function privParseOptions(&$p_options_list, $p_size, &$v_result_list, $v_requested_options=false) 1427 { 1428 $v_result=1; 1429 1430 // ----- Read the options 1431 $i=0; 1432 while ($i<$p_size) { 1433 1434 // ----- Check if the option is supported 1435 if (!isset($v_requested_options[$p_options_list[$i]])) { 1436 // ----- Error log 1437 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid optional parameter '".$p_options_list[$i]."' for this method"); 1438 1439 // ----- Return 1440 return PclZip::errorCode(); 1441 } 1442 1443 // ----- Look for next option 1444 switch ($p_options_list[$i]) { 1445 // ----- Look for options that request a path value 1446 case PCLZIP_OPT_PATH : 1447 case PCLZIP_OPT_REMOVE_PATH : 1448 case PCLZIP_OPT_ADD_PATH : 1449 // ----- Check the number of parameters 1450 if (($i+1) >= $p_size) { 1451 // ----- Error log 1452 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1453 1454 // ----- Return 1455 return PclZip::errorCode(); 1456 } 1457 1458 // ----- Get the value 1459 $v_result_list[$p_options_list[$i]] = PclZipUtilTranslateWinPath($p_options_list[$i+1], FALSE); 1460 $i++; 1461 break; 1462 1463 case PCLZIP_OPT_TEMP_FILE_THRESHOLD : 1464 // ----- Check the number of parameters 1465 if (($i+1) >= $p_size) { 1466 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1467 return PclZip::errorCode(); 1468 } 1469 1470 // ----- Check for incompatible options 1471 if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_OFF])) { 1472 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '".PclZipUtilOptionText($p_options_list[$i])."' can not be used with option 'PCLZIP_OPT_TEMP_FILE_OFF'"); 1473 return PclZip::errorCode(); 1474 } 1475 1476 // ----- Check the value 1477 $v_value = $p_options_list[$i+1]; 1478 if ((!is_integer($v_value)) || ($v_value<0)) { 1479 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Integer expected for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1480 return PclZip::errorCode(); 1481 } 1482 1483 // ----- Get the value (and convert it in bytes) 1484 $v_result_list[$p_options_list[$i]] = $v_value*1048576; 1485 $i++; 1486 break; 1487 1488 case PCLZIP_OPT_TEMP_FILE_ON : 1489 // ----- Check for incompatible options 1490 if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_OFF])) { 1491 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '".PclZipUtilOptionText($p_options_list[$i])."' can not be used with option 'PCLZIP_OPT_TEMP_FILE_OFF'"); 1492 return PclZip::errorCode(); 1493 } 1494 1495 $v_result_list[$p_options_list[$i]] = true; 1496 break; 1497 1498 case PCLZIP_OPT_TEMP_FILE_OFF : 1499 // ----- Check for incompatible options 1500 if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_ON])) { 1501 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '".PclZipUtilOptionText($p_options_list[$i])."' can not be used with option 'PCLZIP_OPT_TEMP_FILE_ON'"); 1502 return PclZip::errorCode(); 1503 } 1504 // ----- Check for incompatible options 1505 if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_THRESHOLD])) { 1506 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '".PclZipUtilOptionText($p_options_list[$i])."' can not be used with option 'PCLZIP_OPT_TEMP_FILE_THRESHOLD'"); 1507 return PclZip::errorCode(); 1508 } 1509 1510 $v_result_list[$p_options_list[$i]] = true; 1511 break; 1512 1513 case PCLZIP_OPT_EXTRACT_DIR_RESTRICTION : 1514 // ----- Check the number of parameters 1515 if (($i+1) >= $p_size) { 1516 // ----- Error log 1517 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1518 1519 // ----- Return 1520 return PclZip::errorCode(); 1521 } 1522 1523 // ----- Get the value 1524 if ( is_string($p_options_list[$i+1]) 1525 && ($p_options_list[$i+1] != '')) { 1526 $v_result_list[$p_options_list[$i]] = PclZipUtilTranslateWinPath($p_options_list[$i+1], FALSE); 1527 $i++; 1528 } 1529 else { 1530 } 1531 break; 1532 1533 // ----- Look for options that request an array of string for value 1534 case PCLZIP_OPT_BY_NAME : 1535 // ----- Check the number of parameters 1536 if (($i+1) >= $p_size) { 1537 // ----- Error log 1538 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1539 1540 // ----- Return 1541 return PclZip::errorCode(); 1542 } 1543 1544 // ----- Get the value 1545 if (is_string($p_options_list[$i+1])) { 1546 $v_result_list[$p_options_list[$i]][0] = $p_options_list[$i+1]; 1547 } 1548 else if (is_array($p_options_list[$i+1])) { 1549 $v_result_list[$p_options_list[$i]] = $p_options_list[$i+1]; 1550 } 1551 else { 1552 // ----- Error log 1553 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Wrong parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1554 1555 // ----- Return 1556 return PclZip::errorCode(); 1557 } 1558 $i++; 1559 break; 1560 1561 // ----- Look for options that request an EREG or PREG expression 1562 case PCLZIP_OPT_BY_EREG : 1563 // ereg() is deprecated starting with PHP 5.3. Move PCLZIP_OPT_BY_EREG 1564 // to PCLZIP_OPT_BY_PREG 1565 $p_options_list[$i] = PCLZIP_OPT_BY_PREG; 1566 case PCLZIP_OPT_BY_PREG : 1567 //case PCLZIP_OPT_CRYPT : 1568 // ----- Check the number of parameters 1569 if (($i+1) >= $p_size) { 1570 // ----- Error log 1571 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1572 1573 // ----- Return 1574 return PclZip::errorCode(); 1575 } 1576 1577 // ----- Get the value 1578 if (is_string($p_options_list[$i+1])) { 1579 $v_result_list[$p_options_list[$i]] = $p_options_list[$i+1]; 1580 } 1581 else { 1582 // ----- Error log 1583 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Wrong parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1584 1585 // ----- Return 1586 return PclZip::errorCode(); 1587 } 1588 $i++; 1589 break; 1590 1591 // ----- Look for options that takes a string 1592 case PCLZIP_OPT_COMMENT : 1593 case PCLZIP_OPT_ADD_COMMENT : 1594 case PCLZIP_OPT_PREPEND_COMMENT : 1595 // ----- Check the number of parameters 1596 if (($i+1) >= $p_size) { 1597 // ----- Error log 1598 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, 1599 "Missing parameter value for option '" 1600 .PclZipUtilOptionText($p_options_list[$i]) 1601 ."'"); 1602 1603 // ----- Return 1604 return PclZip::errorCode(); 1605 } 1606 1607 // ----- Get the value 1608 if (is_string($p_options_list[$i+1])) { 1609 $v_result_list[$p_options_list[$i]] = $p_options_list[$i+1]; 1610 } 1611 else { 1612 // ----- Error log 1613 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, 1614 "Wrong parameter value for option '" 1615 .PclZipUtilOptionText($p_options_list[$i]) 1616 ."'"); 1617 1618 // ----- Return 1619 return PclZip::errorCode(); 1620 } 1621 $i++; 1622 break; 1623 1624 // ----- Look for options that request an array of index 1625 case PCLZIP_OPT_BY_INDEX : 1626 // ----- Check the number of parameters 1627 if (($i+1) >= $p_size) { 1628 // ----- Error log 1629 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1630 1631 // ----- Return 1632 return PclZip::errorCode(); 1633 } 1634 1635 // ----- Get the value 1636 $v_work_list = array(); 1637 if (is_string($p_options_list[$i+1])) { 1638 1639 // ----- Remove spaces 1640 $p_options_list[$i+1] = strtr($p_options_list[$i+1], ' ', ''); 1641 1642 // ----- Parse items 1643 $v_work_list = explode(",", $p_options_list[$i+1]); 1644 } 1645 else if (is_integer($p_options_list[$i+1])) { 1646 $v_work_list[0] = $p_options_list[$i+1].'-'.$p_options_list[$i+1]; 1647 } 1648 else if (is_array($p_options_list[$i+1])) { 1649 $v_work_list = $p_options_list[$i+1]; 1650 } 1651 else { 1652 // ----- Error log 1653 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Value must be integer, string or array for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1654 1655 // ----- Return 1656 return PclZip::errorCode(); 1657 } 1658 1659 // ----- Reduce the index list 1660 // each index item in the list must be a couple with a start and 1661 // an end value : [0,3], [5-5], [8-10], ... 1662 // ----- Check the format of each item 1663 $v_sort_flag=false; 1664 $v_sort_value=0; 1665 for ($j=0; $j<sizeof($v_work_list); $j++) { 1666 // ----- Explode the item 1667 $v_item_list = explode("-", $v_work_list[$j]); 1668 $v_size_item_list = sizeof($v_item_list); 1669 1670 // ----- TBC : Here we might check that each item is a 1671 // real integer ... 1672 1673 // ----- Look for single value 1674 if ($v_size_item_list == 1) { 1675 // ----- Set the option value 1676 $v_result_list[$p_options_list[$i]][$j]['start'] = $v_item_list[0]; 1677 $v_result_list[$p_options_list[$i]][$j]['end'] = $v_item_list[0]; 1678 } 1679 elseif ($v_size_item_list == 2) { 1680 // ----- Set the option value 1681 $v_result_list[$p_options_list[$i]][$j]['start'] = $v_item_list[0]; 1682 $v_result_list[$p_options_list[$i]][$j]['end'] = $v_item_list[1]; 1683 } 1684 else { 1685 // ----- Error log 1686 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Too many values in index range for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1687 1688 // ----- Return 1689 return PclZip::errorCode(); 1690 } 1691 1692 1693 // ----- Look for list sort 1694 if ($v_result_list[$p_options_list[$i]][$j]['start'] < $v_sort_value) { 1695 $v_sort_flag=true; 1696 1697 // ----- TBC : An automatic sort should be writen ... 1698 // ----- Error log 1699 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Invalid order of index range for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1700 1701 // ----- Return 1702 return PclZip::errorCode(); 1703 } 1704 $v_sort_value = $v_result_list[$p_options_list[$i]][$j]['start']; 1705 } 1706 1707 // ----- Sort the items 1708 if ($v_sort_flag) { 1709 // TBC : To Be Completed 1710 } 1711 1712 // ----- Next option 1713 $i++; 1714 break; 1715 1716 // ----- Look for options that request no value 1717 case PCLZIP_OPT_REMOVE_ALL_PATH : 1718 case PCLZIP_OPT_EXTRACT_AS_STRING : 1719 case PCLZIP_OPT_NO_COMPRESSION : 1720 case PCLZIP_OPT_EXTRACT_IN_OUTPUT : 1721 case PCLZIP_OPT_REPLACE_NEWER : 1722 case PCLZIP_OPT_STOP_ON_ERROR : 1723 $v_result_list[$p_options_list[$i]] = true; 1724 break; 1725 1726 // ----- Look for options that request an octal value 1727 case PCLZIP_OPT_SET_CHMOD : 1728 // ----- Check the number of parameters 1729 if (($i+1) >= $p_size) { 1730 // ----- Error log 1731 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1732 1733 // ----- Return 1734 return PclZip::errorCode(); 1735 } 1736 1737 // ----- Get the value 1738 $v_result_list[$p_options_list[$i]] = $p_options_list[$i+1]; 1739 $i++; 1740 break; 1741 1742 // ----- Look for options that request a call-back 1743 case PCLZIP_CB_PRE_EXTRACT : 1744 case PCLZIP_CB_POST_EXTRACT : 1745 case PCLZIP_CB_PRE_ADD : 1746 case PCLZIP_CB_POST_ADD : 1747 /* for futur use 1748 case PCLZIP_CB_PRE_DELETE : 1749 case PCLZIP_CB_POST_DELETE : 1750 case PCLZIP_CB_PRE_LIST : 1751 case PCLZIP_CB_POST_LIST : 1752 */ 1753 // ----- Check the number of parameters 1754 if (($i+1) >= $p_size) { 1755 // ----- Error log 1756 PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1757 1758 // ----- Return 1759 return PclZip::errorCode(); 1760 } 1761 1762 // ----- Get the value 1763 $v_function_name = $p_options_list[$i+1]; 1764 1765 // ----- Check that the value is a valid existing function 1766 if (!function_exists($v_function_name)) { 1767 // ----- Error log 1768 PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Function '".$v_function_name."()' is not an existing function for option '".PclZipUtilOptionText($p_options_list[$i])."'"); 1769 1770 // ----- Return 1771 return PclZip::errorCode(); 1772 } 1773 1774 // ----- Set the attribute 1775 $v_result_list[$p_options_list[$i]] = $v_function_name; 1776 $i++; 1777 break; 1778 1779 default : 1780 // ----- Error log 1781 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, 1782 "Unknown parameter '" 1783 .$p_options_list[$i]."'"); 1784 1785 // ----- Return 1786 return PclZip::errorCode(); 1787 } 1788 1789 // ----- Next options 1790 $i++; 1791 } 1792 1793 // ----- Look for mandatory options 1794 if ($v_requested_options !== false) { 1795 for ($key=reset($v_requested_options); $key=key($v_requested_options); $key=next($v_requested_options)) { 1796 // ----- Look for mandatory option 1797 if ($v_requested_options[$key] == 'mandatory') { 1798 // ----- Look if present 1799 if (!isset($v_result_list[$key])) { 1800 // ----- Error log 1801 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Missing mandatory parameter ".PclZipUtilOptionText($key)."(".$key.")"); 1802 1803 // ----- Return 1804 return PclZip::errorCode(); 1805 } 1806 } 1807 } 1808 } 1809 1810 // ----- Look for default values 1811 if (!isset($v_result_list[PCLZIP_OPT_TEMP_FILE_THRESHOLD])) { 1812 1813 } 1814 1815 // ----- Return 1816 return $v_result; 1817 } 1818 // -------------------------------------------------------------------------------- 1819 1820 // -------------------------------------------------------------------------------- 1821 // Function : privOptionDefaultThreshold() 1822 // Description : 1823 // Parameters : 1824 // Return Values : 1825 // -------------------------------------------------------------------------------- 1826 function privOptionDefaultThreshold(&$p_options) 1827 { 1828 $v_result=1; 1829 1830 if (isset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]) 1831 || isset($p_options[PCLZIP_OPT_TEMP_FILE_OFF])) { 1832 return $v_result; 1833 } 1834 1835 // ----- Get 'memory_limit' configuration value 1836 $v_memory_limit = ini_get('memory_limit'); 1837 $v_memory_limit = trim($v_memory_limit); 1838 $last = strtolower(substr($v_memory_limit, -1)); 1839 1840 if($last == 'g') 1841 //$v_memory_limit = $v_memory_limit*1024*1024*1024; 1842 $v_memory_limit = $v_memory_limit*1073741824; 1843 if($last == 'm') 1844 //$v_memory_limit = $v_memory_limit*1024*1024; 1845 $v_memory_limit = $v_memory_limit*1048576; 1846 if($last == 'k') 1847 $v_memory_limit = $v_memory_limit*1024; 1848 1849 $p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] = floor($v_memory_limit*PCLZIP_TEMPORARY_FILE_RATIO); 1850 1851 1852 // ----- Sanity check : No threshold if value lower than 1M 1853 if ($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] < 1048576) { 1854 unset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]); 1855 } 1856 1857 // ----- Return 1858 return $v_result; 1859 } 1860 // -------------------------------------------------------------------------------- 1861 1862 // -------------------------------------------------------------------------------- 1863 // Function : privFileDescrParseAtt() 1864 // Description : 1865 // Parameters : 1866 // Return Values : 1867 // 1 on success. 1868 // 0 on failure. 1869 // -------------------------------------------------------------------------------- 1870 function privFileDescrParseAtt(&$p_file_list, &$p_filedescr, $v_options, $v_requested_options=false) 1871 { 1872 $v_result=1; 1873 1874 // ----- For each file in the list check the attributes 1875 foreach ($p_file_list as $v_key => $v_value) { 1876 1877 // ----- Check if the option is supported 1878 if (!isset($v_requested_options[$v_key])) { 1879 // ----- Error log 1880 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid file attribute '".$v_key."' for this file"); 1881 1882 // ----- Return 1883 return PclZip::errorCode(); 1884 } 1885 1886 // ----- Look for attribute 1887 switch ($v_key) { 1888 case PCLZIP_ATT_FILE_NAME : 1889 if (!is_string($v_value)) { 1890 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type ".gettype($v_value).". String expected for attribute '".PclZipUtilOptionText($v_key)."'"); 1891 return PclZip::errorCode(); 1892 } 1893 1894 $p_filedescr['filename'] = PclZipUtilPathReduction($v_value); 1895 1896 if ($p_filedescr['filename'] == '') { 1897 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid empty filename for attribute '".PclZipUtilOptionText($v_key)."'"); 1898 return PclZip::errorCode(); 1899 } 1900 1901 break; 1902 1903 case PCLZIP_ATT_FILE_NEW_SHORT_NAME : 1904 if (!is_string($v_value)) { 1905 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type ".gettype($v_value).". String expected for attribute '".PclZipUtilOptionText($v_key)."'"); 1906 return PclZip::errorCode(); 1907 } 1908 1909 $p_filedescr['new_short_name'] = PclZipUtilPathReduction($v_value); 1910 1911 if ($p_filedescr['new_short_name'] == '') { 1912 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid empty short filename for attribute '".PclZipUtilOptionText($v_key)."'"); 1913 return PclZip::errorCode(); 1914 } 1915 break; 1916 1917 case PCLZIP_ATT_FILE_NEW_FULL_NAME : 1918 if (!is_string($v_value)) { 1919 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type ".gettype($v_value).". String expected for attribute '".PclZipUtilOptionText($v_key)."'"); 1920 return PclZip::errorCode(); 1921 } 1922 1923 $p_filedescr['new_full_name'] = PclZipUtilPathReduction($v_value); 1924 1925 if ($p_filedescr['new_full_name'] == '') { 1926 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid empty full filename for attribute '".PclZipUtilOptionText($v_key)."'"); 1927 return PclZip::errorCode(); 1928 } 1929 break; 1930 1931 // ----- Look for options that takes a string 1932 case PCLZIP_ATT_FILE_COMMENT : 1933 if (!is_string($v_value)) { 1934 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type ".gettype($v_value).". String expected for attribute '".PclZipUtilOptionText($v_key)."'"); 1935 return PclZip::errorCode(); 1936 } 1937 1938 $p_filedescr['comment'] = $v_value; 1939 break; 1940 1941 case PCLZIP_ATT_FILE_MTIME : 1942 if (!is_integer($v_value)) { 1943 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type ".gettype($v_value).". Integer expected for attribute '".PclZipUtilOptionText($v_key)."'"); 1944 return PclZip::errorCode(); 1945 } 1946 1947 $p_filedescr['mtime'] = $v_value; 1948 break; 1949 1950 case PCLZIP_ATT_FILE_CONTENT : 1951 $p_filedescr['content'] = $v_value; 1952 break; 1953 1954 default : 1955 // ----- Error log 1956 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, 1957 "Unknown parameter '".$v_key."'"); 1958 1959 // ----- Return 1960 return PclZip::errorCode(); 1961 } 1962 1963 // ----- Look for mandatory options 1964 if ($v_requested_options !== false) { 1965 for ($key=reset($v_requested_options); $key=key($v_requested_options); $key=next($v_requested_options)) { 1966 // ----- Look for mandatory option 1967 if ($v_requested_options[$key] == 'mandatory') { 1968 // ----- Look if present 1969 if (!isset($p_file_list[$key])) { 1970 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Missing mandatory parameter ".PclZipUtilOptionText($key)."(".$key.")"); 1971 return PclZip::errorCode(); 1972 } 1973 } 1974 } 1975 } 1976 1977 // end foreach 1978 } 1979 1980 // ----- Return 1981 return $v_result; 1982 } 1983 // -------------------------------------------------------------------------------- 1984 1985 // -------------------------------------------------------------------------------- 1986 // Function : privFileDescrExpand() 1987 // Description : 1988 // This method look for each item of the list to see if its a file, a folder 1989 // or a string to be added as file. For any other type of files (link, other) 1990 // just ignore the item. 1991 // Then prepare the information that will be stored for that file. 1992 // When its a folder, expand the folder with all the files that are in that 1993 // folder (recursively). 1994 // Parameters : 1995 // Return Values : 1996 // 1 on success. 1997 // 0 on failure. 1998 // -------------------------------------------------------------------------------- 1999 function privFileDescrExpand(&$p_filedescr_list, &$p_options) 2000 { 2001 $v_result=1; 2002 2003 // ----- Create a result list 2004 $v_result_list = array(); 2005 2006 // ----- Look each entry 2007 for ($i=0; $i<sizeof($p_filedescr_list); $i++) { 2008 2009 // ----- Get filedescr 2010 $v_descr = $p_filedescr_list[$i]; 2011 2012 // ----- Reduce the filename 2013 $v_descr['filename'] = PclZipUtilTranslateWinPath($v_descr['filename'], false); 2014 $v_descr['filename'] = PclZipUtilPathReduction($v_descr['filename']); 2015 2016 // ----- Look for real file or folder 2017 if (file_exists($v_descr['filename'])) { 2018 if (@is_file($v_descr['filename'])) { 2019 $v_descr['type'] = 'file'; 2020 } 2021 else if (@is_dir($v_descr['filename'])) { 2022 $v_descr['type'] = 'folder'; 2023 } 2024 else if (@is_link($v_descr['filename'])) { 2025 // skip 2026 continue; 2027 } 2028 else { 2029 // skip 2030 continue; 2031 } 2032 } 2033 2034 // ----- Look for string added as file 2035 else if (isset($v_descr['content'])) { 2036 $v_descr['type'] = 'virtual_file'; 2037 } 2038 2039 // ----- Missing file 2040 else { 2041 // ----- Error log 2042 PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "File '".$v_descr['filename']."' does not exist"); 2043 2044 // ----- Return 2045 return PclZip::errorCode(); 2046 } 2047 2048 // ----- Calculate the stored filename 2049 $this->privCalculateStoredFilename($v_descr, $p_options); 2050 2051 // ----- Add the descriptor in result list 2052 $v_result_list[sizeof($v_result_list)] = $v_descr; 2053 2054 // ----- Look for folder 2055 if ($v_descr['type'] == 'folder') { 2056 // ----- List of items in folder 2057 $v_dirlist_descr = array(); 2058 $v_dirlist_nb = 0; 2059 if ($v_folder_handler = @opendir($v_descr['filename'])) { 2060 while (($v_item_handler = @readdir($v_folder_handler)) !== false) { 2061 2062 // ----- Skip '.' and '..' 2063 if (($v_item_handler == '.') || ($v_item_handler == '..')) { 2064 continue; 2065 } 2066 2067 // ----- Compose the full filename 2068 $v_dirlist_descr[$v_dirlist_nb]['filename'] = $v_descr['filename'].'/'.$v_item_handler; 2069 2070 // ----- Look for different stored filename 2071 // Because the name of the folder was changed, the name of the 2072 // files/sub-folders also change 2073 if (($v_descr['stored_filename'] != $v_descr['filename']) 2074 && (!isset($p_options[PCLZIP_OPT_REMOVE_ALL_PATH]))) { 2075 if ($v_descr['stored_filename'] != '') { 2076 $v_dirlist_descr[$v_dirlist_nb]['new_full_name'] = $v_descr['stored_filename'].'/'.$v_item_handler; 2077 } 2078 else { 2079 $v_dirlist_descr[$v_dirlist_nb]['new_full_name'] = $v_item_handler; 2080 } 2081 } 2082 2083 $v_dirlist_nb++; 2084 } 2085 2086 @closedir($v_folder_handler); 2087 } 2088 else { 2089 // TBC : unable to open folder in read mode 2090 } 2091 2092 // ----- Expand each element of the list 2093 if ($v_dirlist_nb != 0) { 2094 // ----- Expand 2095 if (($v_result = $this->privFileDescrExpand($v_dirlist_descr, $p_options)) != 1) { 2096 return $v_result; 2097 } 2098 2099 // ----- Concat the resulting list 2100 $v_result_list = array_merge($v_result_list, $v_dirlist_descr); 2101 } 2102 else { 2103 } 2104 2105 // ----- Free local array 2106 unset($v_dirlist_descr); 2107 } 2108 } 2109 2110 // ----- Get the result list 2111 $p_filedescr_list = $v_result_list; 2112 2113 // ----- Return 2114 return $v_result; 2115 } 2116 // -------------------------------------------------------------------------------- 2117 2118 // -------------------------------------------------------------------------------- 2119 // Function : privCreate() 2120 // Description : 2121 // Parameters : 2122 // Return Values : 2123 // -------------------------------------------------------------------------------- 2124 function privCreate($p_filedescr_list, &$p_result_list, &$p_options) 2125 { 2126 $v_result=1; 2127 $v_list_detail = array(); 2128 2129 // ----- Magic quotes trick 2130 $this->privDisableMagicQuotes(); 2131 2132 // ----- Open the file in write mode 2133 if (($v_result = $this->privOpenFd('wb')) != 1) 2134 { 2135 // ----- Return 2136 return $v_result; 2137 } 2138 2139 // ----- Add the list of files 2140 $v_result = $this->privAddList($p_filedescr_list, $p_result_list, $p_options); 2141 2142 // ----- Close 2143 $this->privCloseFd(); 2144 2145 // ----- Magic quotes trick 2146 $this->privSwapBackMagicQuotes(); 2147 2148 // ----- Return 2149 return $v_result; 2150 } 2151 // -------------------------------------------------------------------------------- 2152 2153 // -------------------------------------------------------------------------------- 2154 // Function : privAdd() 2155 // Description : 2156 // Parameters : 2157 // Return Values : 2158 // -------------------------------------------------------------------------------- 2159 function privAdd($p_filedescr_list, &$p_result_list, &$p_options) 2160 { 2161 $v_result=1; 2162 $v_list_detail = array(); 2163 2164 // ----- Look if the archive exists or is empty 2165 if ((!is_file($this->zipname)) || (filesize($this->zipname) == 0)) 2166 { 2167 2168 // ----- Do a create 2169 $v_result = $this->privCreate($p_filedescr_list, $p_result_list, $p_options); 2170 2171 // ----- Return 2172 return $v_result; 2173 } 2174 // ----- Magic quotes trick 2175 $this->privDisableMagicQuotes(); 2176 2177 // ----- Open the zip file 2178 if (($v_result=$this->privOpenFd('rb')) != 1) 2179 { 2180 // ----- Magic quotes trick 2181 $this->privSwapBackMagicQuotes(); 2182 2183 // ----- Return 2184 return $v_result; 2185 } 2186 2187 // ----- Read the central directory informations 2188 $v_central_dir = array(); 2189 if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) 2190 { 2191 $this->privCloseFd(); 2192 $this->privSwapBackMagicQuotes(); 2193 return $v_result; 2194 } 2195 2196 // ----- Go to beginning of File 2197 @rewind($this->zip_fd); 2198 2199 // ----- Creates a temporay file 2200 $v_zip_temp_name = PCLZIP_TEMPORARY_DIR.uniqid('pclzip-').'.tmp'; 2201 2202 // ----- Open the temporary file in write mode 2203 if (($v_zip_temp_fd = @fopen($v_zip_temp_name, 'wb')) == 0) 2204 { 2205 $this->privCloseFd(); 2206 $this->privSwapBackMagicQuotes(); 2207 2208 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \''.$v_zip_temp_name.'\' in binary write mode'); 2209 2210 // ----- Return 2211 return PclZip::errorCode(); 2212 } 2213 2214 // ----- Copy the files from the archive to the temporary file 2215 // TBC : Here I should better append the file and go back to erase the central dir 2216 $v_size = $v_central_dir['offset']; 2217 while ($v_size != 0) 2218 { 2219 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 2220 $v_buffer = fread($this->zip_fd, $v_read_size); 2221 @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size); 2222 $v_size -= $v_read_size; 2223 } 2224 2225 // ----- Swap the file descriptor 2226 // Here is a trick : I swap the temporary fd with the zip fd, in order to use 2227 // the following methods on the temporary fil and not the real archive 2228 $v_swap = $this->zip_fd; 2229 $this->zip_fd = $v_zip_temp_fd; 2230 $v_zip_temp_fd = $v_swap; 2231 2232 // ----- Add the files 2233 $v_header_list = array(); 2234 if (($v_result = $this->privAddFileList($p_filedescr_list, $v_header_list, $p_options)) != 1) 2235 { 2236 fclose($v_zip_temp_fd); 2237 $this->privCloseFd(); 2238 @unlink($v_zip_temp_name); 2239 $this->privSwapBackMagicQuotes(); 2240 2241 // ----- Return 2242 return $v_result; 2243 } 2244 2245 // ----- Store the offset of the central dir 2246 $v_offset = @ftell($this->zip_fd); 2247 2248 // ----- Copy the block of file headers from the old archive 2249 $v_size = $v_central_dir['size']; 2250 while ($v_size != 0) 2251 { 2252 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 2253 $v_buffer = @fread($v_zip_temp_fd, $v_read_size); 2254 @fwrite($this->zip_fd, $v_buffer, $v_read_size); 2255 $v_size -= $v_read_size; 2256 } 2257 2258 // ----- Create the Central Dir files header 2259 for ($i=0, $v_count=0; $i<sizeof($v_header_list); $i++) 2260 { 2261 // ----- Create the file header 2262 if ($v_header_list[$i]['status'] == 'ok') { 2263 if (($v_result = $this->privWriteCentralFileHeader($v_header_list[$i])) != 1) { 2264 fclose($v_zip_temp_fd); 2265 $this->privCloseFd(); 2266 @unlink($v_zip_temp_name); 2267 $this->privSwapBackMagicQuotes(); 2268 2269 // ----- Return 2270 return $v_result; 2271 } 2272 $v_count++; 2273 } 2274 2275 // ----- Transform the header to a 'usable' info 2276 $this->privConvertHeader2FileInfo($v_header_list[$i], $p_result_list[$i]); 2277 } 2278 2279 // ----- Zip file comment 2280 $v_comment = $v_central_dir['comment']; 2281 if (isset($p_options[PCLZIP_OPT_COMMENT])) { 2282 $v_comment = $p_options[PCLZIP_OPT_COMMENT]; 2283 } 2284 if (isset($p_options[PCLZIP_OPT_ADD_COMMENT])) { 2285 $v_comment = $v_comment.$p_options[PCLZIP_OPT_ADD_COMMENT]; 2286 } 2287 if (isset($p_options[PCLZIP_OPT_PREPEND_COMMENT])) { 2288 $v_comment = $p_options[PCLZIP_OPT_PREPEND_COMMENT].$v_comment; 2289 } 2290 2291 // ----- Calculate the size of the central header 2292 $v_size = @ftell($this->zip_fd)-$v_offset; 2293 2294 // ----- Create the central dir footer 2295 if (($v_result = $this->privWriteCentralHeader($v_count+$v_central_dir['entries'], $v_size, $v_offset, $v_comment)) != 1) 2296 { 2297 // ----- Reset the file list 2298 unset($v_header_list); 2299 $this->privSwapBackMagicQuotes(); 2300 2301 // ----- Return 2302 return $v_result; 2303 } 2304 2305 // ----- Swap back the file descriptor 2306 $v_swap = $this->zip_fd; 2307 $this->zip_fd = $v_zip_temp_fd; 2308 $v_zip_temp_fd = $v_swap; 2309 2310 // ----- Close 2311 $this->privCloseFd(); 2312 2313 // ----- Close the temporary file 2314 @fclose($v_zip_temp_fd); 2315 2316 // ----- Magic quotes trick 2317 $this->privSwapBackMagicQuotes(); 2318 2319 // ----- Delete the zip file 2320 // TBC : I should test the result ... 2321 @unlink($this->zipname); 2322 2323 // ----- Rename the temporary file 2324 // TBC : I should test the result ... 2325 //@rename($v_zip_temp_name, $this->zipname); 2326 PclZipUtilRename($v_zip_temp_name, $this->zipname); 2327 2328 // ----- Return 2329 return $v_result; 2330 } 2331 // -------------------------------------------------------------------------------- 2332 2333 // -------------------------------------------------------------------------------- 2334 // Function : privOpenFd() 2335 // Description : 2336 // Parameters : 2337 // -------------------------------------------------------------------------------- 2338 function privOpenFd($p_mode) 2339 { 2340 $v_result=1; 2341 2342 // ----- Look if already open 2343 if ($this->zip_fd != 0) 2344 { 2345 // ----- Error log 2346 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Zip file \''.$this->zipname.'\' already open'); 2347 2348 // ----- Return 2349 return PclZip::errorCode(); 2350 } 2351 2352 // ----- Open the zip file 2353 if (($this->zip_fd = @fopen($this->zipname, $p_mode)) == 0) 2354 { 2355 // ----- Error log 2356 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive \''.$this->zipname.'\' in '.$p_mode.' mode'); 2357 2358 // ----- Return 2359 return PclZip::errorCode(); 2360 } 2361 2362 // ----- Return 2363 return $v_result; 2364 } 2365 // -------------------------------------------------------------------------------- 2366 2367 // -------------------------------------------------------------------------------- 2368 // Function : privCloseFd() 2369 // Description : 2370 // Parameters : 2371 // -------------------------------------------------------------------------------- 2372 function privCloseFd() 2373 { 2374 $v_result=1; 2375 2376 if ($this->zip_fd != 0) 2377 @fclose($this->zip_fd); 2378 $this->zip_fd = 0; 2379 2380 // ----- Return 2381 return $v_result; 2382 } 2383 // -------------------------------------------------------------------------------- 2384 2385 // -------------------------------------------------------------------------------- 2386 // Function : privAddList() 2387 // Description : 2388 // $p_add_dir and $p_remove_dir will give the ability to memorize a path which is 2389 // different from the real path of the file. This is usefull if you want to have PclTar 2390 // running in any directory, and memorize relative path from an other directory. 2391 // Parameters : 2392 // $p_list : An array containing the file or directory names to add in the tar 2393 // $p_result_list : list of added files with their properties (specially the status field) 2394 // $p_add_dir : Path to add in the filename path archived 2395 // $p_remove_dir : Path to remove in the filename path archived 2396 // Return Values : 2397 // -------------------------------------------------------------------------------- 2398 // function privAddList($p_list, &$p_result_list, $p_add_dir, $p_remove_dir, $p_remove_all_dir, &$p_options) 2399 function privAddList($p_filedescr_list, &$p_result_list, &$p_options) 2400 { 2401 $v_result=1; 2402 2403 // ----- Add the files 2404 $v_header_list = array(); 2405 if (($v_result = $this->privAddFileList($p_filedescr_list, $v_header_list, $p_options)) != 1) 2406 { 2407 // ----- Return 2408 return $v_result; 2409 } 2410 2411 // ----- Store the offset of the central dir 2412 $v_offset = @ftell($this->zip_fd); 2413 2414 // ----- Create the Central Dir files header 2415 for ($i=0,$v_count=0; $i<sizeof($v_header_list); $i++) 2416 { 2417 // ----- Create the file header 2418 if ($v_header_list[$i]['status'] == 'ok') { 2419 if (($v_result = $this->privWriteCentralFileHeader($v_header_list[$i])) != 1) { 2420 // ----- Return 2421 return $v_result; 2422 } 2423 $v_count++; 2424 } 2425 2426 // ----- Transform the header to a 'usable' info 2427 $this->privConvertHeader2FileInfo($v_header_list[$i], $p_result_list[$i]); 2428 } 2429 2430 // ----- Zip file comment 2431 $v_comment = ''; 2432 if (isset($p_options[PCLZIP_OPT_COMMENT])) { 2433 $v_comment = $p_options[PCLZIP_OPT_COMMENT]; 2434 } 2435 2436 // ----- Calculate the size of the central header 2437 $v_size = @ftell($this->zip_fd)-$v_offset; 2438 2439 // ----- Create the central dir footer 2440 if (($v_result = $this->privWriteCentralHeader($v_count, $v_size, $v_offset, $v_comment)) != 1) 2441 { 2442 // ----- Reset the file list 2443 unset($v_header_list); 2444 2445 // ----- Return 2446 return $v_result; 2447 } 2448 2449 // ----- Return 2450 return $v_result; 2451 } 2452 // -------------------------------------------------------------------------------- 2453 2454 // -------------------------------------------------------------------------------- 2455 // Function : privAddFileList() 2456 // Description : 2457 // Parameters : 2458 // $p_filedescr_list : An array containing the file description 2459 // or directory names to add in the zip 2460 // $p_result_list : list of added files with their properties (specially the status field) 2461 // Return Values : 2462 // -------------------------------------------------------------------------------- 2463 function privAddFileList($p_filedescr_list, &$p_result_list, &$p_options) 2464 { 2465 $v_result=1; 2466 $v_header = array(); 2467 2468 // ----- Recuperate the current number of elt in list 2469 $v_nb = sizeof($p_result_list); 2470 2471 // ----- Loop on the files 2472 for ($j=0; ($j<sizeof($p_filedescr_list)) && ($v_result==1); $j++) { 2473 // ----- Format the filename 2474 $p_filedescr_list[$j]['filename'] 2475 = PclZipUtilTranslateWinPath($p_filedescr_list[$j]['filename'], false); 2476 2477 2478 // ----- Skip empty file names 2479 // TBC : Can this be possible ? not checked in DescrParseAtt ? 2480 if ($p_filedescr_list[$j]['filename'] == "") { 2481 continue; 2482 } 2483 2484 // ----- Check the filename 2485 if ( ($p_filedescr_list[$j]['type'] != 'virtual_file') 2486 && (!file_exists($p_filedescr_list[$j]['filename']))) { 2487 PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "File '".$p_filedescr_list[$j]['filename']."' does not exist"); 2488 return PclZip::errorCode(); 2489 } 2490 2491 // ----- Look if it is a file or a dir with no all path remove option 2492 // or a dir with all its path removed 2493 // if ( (is_file($p_filedescr_list[$j]['filename'])) 2494 // || ( is_dir($p_filedescr_list[$j]['filename']) 2495 if ( ($p_filedescr_list[$j]['type'] == 'file') 2496 || ($p_filedescr_list[$j]['type'] == 'virtual_file') 2497 || ( ($p_filedescr_list[$j]['type'] == 'folder') 2498 && ( !isset($p_options[PCLZIP_OPT_REMOVE_ALL_PATH]) 2499 || !$p_options[PCLZIP_OPT_REMOVE_ALL_PATH])) 2500 ) { 2501 2502 // ----- Add the file 2503 $v_result = $this->privAddFile($p_filedescr_list[$j], $v_header, 2504 $p_options); 2505 if ($v_result != 1) { 2506 return $v_result; 2507 } 2508 2509 // ----- Store the file infos 2510 $p_result_list[$v_nb++] = $v_header; 2511 } 2512 } 2513 2514 // ----- Return 2515 return $v_result; 2516 } 2517 // -------------------------------------------------------------------------------- 2518 2519 // -------------------------------------------------------------------------------- 2520 // Function : privAddFile() 2521 // Description : 2522 // Parameters : 2523 // Return Values : 2524 // -------------------------------------------------------------------------------- 2525 function privAddFile($p_filedescr, &$p_header, &$p_options) 2526 { 2527 $v_result=1; 2528 2529 // ----- Working variable 2530 $p_filename = $p_filedescr['filename']; 2531 2532 // TBC : Already done in the fileAtt check ... ? 2533 if ($p_filename == "") { 2534 // ----- Error log 2535 PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid file list parameter (invalid or empty list)"); 2536 2537 // ----- Return 2538 return PclZip::errorCode(); 2539 } 2540 2541 // ----- Look for a stored different filename 2542 /* TBC : Removed 2543 if (isset($p_filedescr['stored_filename'])) { 2544 $v_stored_filename = $p_filedescr['stored_filename']; 2545 } 2546 else { 2547 $v_stored_filename = $p_filedescr['stored_filename']; 2548 } 2549 */ 2550 2551 // ----- Set the file properties 2552 clearstatcache(); 2553 $p_header['version'] = 20; 2554 $p_header['version_extracted'] = 10; 2555 $p_header['flag'] = 0; 2556 $p_header['compression'] = 0; 2557 $p_header['crc'] = 0; 2558 $p_header['compressed_size'] = 0; 2559 $p_header['filename_len'] = strlen($p_filename); 2560 $p_header['extra_len'] = 0; 2561 $p_header['disk'] = 0; 2562 $p_header['internal'] = 0; 2563 $p_header['offset'] = 0; 2564 $p_header['filename'] = $p_filename; 2565 // TBC : Removed $p_header['stored_filename'] = $v_stored_filename; 2566 $p_header['stored_filename'] = $p_filedescr['stored_filename']; 2567 $p_header['extra'] = ''; 2568 $p_header['status'] = 'ok'; 2569 $p_header['index'] = -1; 2570 2571 // ----- Look for regular file 2572 if ($p_filedescr['type']=='file') { 2573 $p_header['external'] = 0x00000000; 2574 $p_header['size'] = filesize($p_filename); 2575 } 2576 2577 // ----- Look for regular folder 2578 else if ($p_filedescr['type']=='folder') { 2579 $p_header['external'] = 0x00000010; 2580 $p_header['mtime'] = filemtime($p_filename); 2581 $p_header['size'] = filesize($p_filename); 2582 } 2583 2584 // ----- Look for virtual file 2585 else if ($p_filedescr['type'] == 'virtual_file') { 2586 $p_header['external'] = 0x00000000; 2587 $p_header['size'] = strlen($p_filedescr['content']); 2588 } 2589 2590 2591 // ----- Look for filetime 2592 if (isset($p_filedescr['mtime'])) { 2593 $p_header['mtime'] = $p_filedescr['mtime']; 2594 } 2595 else if ($p_filedescr['type'] == 'virtual_file') { 2596 $p_header['mtime'] = time(); 2597 } 2598 else { 2599 $p_header['mtime'] = filemtime($p_filename); 2600 } 2601 2602 // ------ Look for file comment 2603 if (isset($p_filedescr['comment'])) { 2604 $p_header['comment_len'] = strlen($p_filedescr['comment']); 2605 $p_header['comment'] = $p_filedescr['comment']; 2606 } 2607 else { 2608 $p_header['comment_len'] = 0; 2609 $p_header['comment'] = ''; 2610 } 2611 2612 // ----- Look for pre-add callback 2613 if (isset($p_options[PCLZIP_CB_PRE_ADD])) { 2614 2615 // ----- Generate a local information 2616 $v_local_header = array(); 2617 $this->privConvertHeader2FileInfo($p_header, $v_local_header); 2618 2619 // ----- Call the callback 2620 // Here I do not use call_user_func() because I need to send a reference to the 2621 // header. 2622 // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_ADD].'(PCLZIP_CB_PRE_ADD, $v_local_header);'); 2623 $v_result = $p_options[PCLZIP_CB_PRE_ADD](PCLZIP_CB_PRE_ADD, $v_local_header); 2624 if ($v_result == 0) { 2625 // ----- Change the file status 2626 $p_header['status'] = "skipped"; 2627 $v_result = 1; 2628 } 2629 2630 // ----- Update the informations 2631 // Only some fields can be modified 2632 if ($p_header['stored_filename'] != $v_local_header['stored_filename']) { 2633 $p_header['stored_filename'] = PclZipUtilPathReduction($v_local_header['stored_filename']); 2634 } 2635 } 2636 2637 // ----- Look for empty stored filename 2638 if ($p_header['stored_filename'] == "") { 2639 $p_header['status'] = "filtered"; 2640 } 2641 2642 // ----- Check the path length 2643 if (strlen($p_header['stored_filename']) > 0xFF) { 2644 $p_header['status'] = 'filename_too_long'; 2645 } 2646 2647 // ----- Look if no error, or file not skipped 2648 if ($p_header['status'] == 'ok') { 2649 2650 // ----- Look for a file 2651 if ($p_filedescr['type'] == 'file') { 2652 // ----- Look for using temporary file to zip 2653 if ( (!isset($p_options[PCLZIP_OPT_TEMP_FILE_OFF])) 2654 && (isset($p_options[PCLZIP_OPT_TEMP_FILE_ON]) 2655 || (isset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]) 2656 && ($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] <= $p_header['size'])) ) ) { 2657 $v_result = $this->privAddFileUsingTempFile($p_filedescr, $p_header, $p_options); 2658 if ($v_result < PCLZIP_ERR_NO_ERROR) { 2659 return $v_result; 2660 } 2661 } 2662 2663 // ----- Use "in memory" zip algo 2664 else { 2665 2666 // ----- Open the source file 2667 if (($v_file = @fopen($p_filename, "rb")) == 0) { 2668 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, "Unable to open file '$p_filename' in binary read mode"); 2669 return PclZip::errorCode(); 2670 } 2671 2672 // ----- Read the file content 2673 $v_content = @fread($v_file, $p_header['size']); 2674 2675 // ----- Close the file 2676 @fclose($v_file); 2677 2678 // ----- Calculate the CRC 2679 $p_header['crc'] = @crc32($v_content); 2680 2681 // ----- Look for no compression 2682 if ($p_options[PCLZIP_OPT_NO_COMPRESSION]) { 2683 // ----- Set header parameters 2684 $p_header['compressed_size'] = $p_header['size']; 2685 $p_header['compression'] = 0; 2686 } 2687 2688 // ----- Look for normal compression 2689 else { 2690 // ----- Compress the content 2691 $v_content = @gzdeflate($v_content); 2692 2693 // ----- Set header parameters 2694 $p_header['compressed_size'] = strlen($v_content); 2695 $p_header['compression'] = 8; 2696 } 2697 2698 // ----- Call the header generation 2699 if (($v_result = $this->privWriteFileHeader($p_header)) != 1) { 2700 @fclose($v_file); 2701 return $v_result; 2702 } 2703 2704 // ----- Write the compressed (or not) content 2705 @fwrite($this->zip_fd, $v_content, $p_header['compressed_size']); 2706 2707 } 2708 2709 } 2710 2711 // ----- Look for a virtual file (a file from string) 2712 else if ($p_filedescr['type'] == 'virtual_file') { 2713 2714 $v_content = $p_filedescr['content']; 2715 2716 // ----- Calculate the CRC 2717 $p_header['crc'] = @crc32($v_content); 2718 2719 // ----- Look for no compression 2720 if ($p_options[PCLZIP_OPT_NO_COMPRESSION]) { 2721 // ----- Set header parameters 2722 $p_header['compressed_size'] = $p_header['size']; 2723 $p_header['compression'] = 0; 2724 } 2725 2726 // ----- Look for normal compression 2727 else { 2728 // ----- Compress the content 2729 $v_content = @gzdeflate($v_content); 2730 2731 // ----- Set header parameters 2732 $p_header['compressed_size'] = strlen($v_content); 2733 $p_header['compression'] = 8; 2734 } 2735 2736 // ----- Call the header generation 2737 if (($v_result = $this->privWriteFileHeader($p_header)) != 1) { 2738 @fclose($v_file); 2739 return $v_result; 2740 } 2741 2742 // ----- Write the compressed (or not) content 2743 @fwrite($this->zip_fd, $v_content, $p_header['compressed_size']); 2744 } 2745 2746 // ----- Look for a directory 2747 else if ($p_filedescr['type'] == 'folder') { 2748 // ----- Look for directory last '/' 2749 if (@substr($p_header['stored_filename'], -1) != '/') { 2750 $p_header['stored_filename'] .= '/'; 2751 } 2752 2753 // ----- Set the file properties 2754 $p_header['size'] = 0; 2755 //$p_header['external'] = 0x41FF0010; // Value for a folder : to be checked 2756 $p_header['external'] = 0x00000010; // Value for a folder : to be checked 2757 2758 // ----- Call the header generation 2759 if (($v_result = $this->privWriteFileHeader($p_header)) != 1) 2760 { 2761 return $v_result; 2762 } 2763 } 2764 } 2765 2766 // ----- Look for post-add callback 2767 if (isset($p_options[PCLZIP_CB_POST_ADD])) { 2768 2769 // ----- Generate a local information 2770 $v_local_header = array(); 2771 $this->privConvertHeader2FileInfo($p_header, $v_local_header); 2772 2773 // ----- Call the callback 2774 // Here I do not use call_user_func() because I need to send a reference to the 2775 // header. 2776 // eval('$v_result = '.$p_options[PCLZIP_CB_POST_ADD].'(PCLZIP_CB_POST_ADD, $v_local_header);'); 2777 $v_result = $p_options[PCLZIP_CB_POST_ADD](PCLZIP_CB_POST_ADD, $v_local_header); 2778 if ($v_result == 0) { 2779 // ----- Ignored 2780 $v_result = 1; 2781 } 2782 2783 // ----- Update the informations 2784 // Nothing can be modified 2785 } 2786 2787 // ----- Return 2788 return $v_result; 2789 } 2790 // -------------------------------------------------------------------------------- 2791 2792 // -------------------------------------------------------------------------------- 2793 // Function : privAddFileUsingTempFile() 2794 // Description : 2795 // Parameters : 2796 // Return Values : 2797 // -------------------------------------------------------------------------------- 2798 function privAddFileUsingTempFile($p_filedescr, &$p_header, &$p_options) 2799 { 2800 $v_result=PCLZIP_ERR_NO_ERROR; 2801 2802 // ----- Working variable 2803 $p_filename = $p_filedescr['filename']; 2804 2805 2806 // ----- Open the source file 2807 if (($v_file = @fopen($p_filename, "rb")) == 0) { 2808 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, "Unable to open file '$p_filename' in binary read mode"); 2809 return PclZip::errorCode(); 2810 } 2811 2812 // ----- Creates a compressed temporary file 2813 $v_gzip_temp_name = PCLZIP_TEMPORARY_DIR.uniqid('pclzip-').'.gz'; 2814 if (($v_file_compressed = @gzopen($v_gzip_temp_name, "wb")) == 0) { 2815 fclose($v_file); 2816 PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, 'Unable to open temporary file \''.$v_gzip_temp_name.'\' in binary write mode'); 2817 return PclZip::errorCode(); 2818 } 2819 2820 // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks 2821 $v_size = filesize($p_filename); 2822 while ($v_size != 0) { 2823 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 2824 $v_buffer = @fread($v_file, $v_read_size); 2825 //$v_binary_data = pack('a'.$v_read_size, $v_buffer); 2826 @gzputs($v_file_compressed, $v_buffer, $v_read_size); 2827 $v_size -= $v_read_size; 2828 } 2829 2830 // ----- Close the file 2831 @fclose($v_file); 2832 @gzclose($v_file_compressed); 2833 2834 // ----- Check the minimum file size 2835 if (filesize($v_gzip_temp_name) < 18) { 2836 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'gzip temporary file \''.$v_gzip_temp_name.'\' has invalid filesize - should be minimum 18 bytes'); 2837 return PclZip::errorCode(); 2838 } 2839 2840 // ----- Extract the compressed attributes 2841 if (($v_file_compressed = @fopen($v_gzip_temp_name, "rb")) == 0) { 2842 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \''.$v_gzip_temp_name.'\' in binary read mode'); 2843 return PclZip::errorCode(); 2844 } 2845 2846 // ----- Read the gzip file header 2847 $v_binary_data = @fread($v_file_compressed, 10); 2848 $v_data_header = unpack('a1id1/a1id2/a1cm/a1flag/Vmtime/a1xfl/a1os', $v_binary_data); 2849 2850 // ----- Check some parameters 2851 $v_data_header['os'] = bin2hex($v_data_header['os']); 2852 2853 // ----- Read the gzip file footer 2854 @fseek($v_file_compressed, filesize($v_gzip_temp_name)-8); 2855 $v_binary_data = @fread($v_file_compressed, 8); 2856 $v_data_footer = unpack('Vcrc/Vcompressed_size', $v_binary_data); 2857 2858 // ----- Set the attributes 2859 $p_header['compression'] = ord($v_data_header['cm']); 2860 //$p_header['mtime'] = $v_data_header['mtime']; 2861 $p_header['crc'] = $v_data_footer['crc']; 2862 $p_header['compressed_size'] = filesize($v_gzip_temp_name)-18; 2863 2864 // ----- Close the file 2865 @fclose($v_file_compressed); 2866 2867 // ----- Call the header generation 2868 if (($v_result = $this->privWriteFileHeader($p_header)) != 1) { 2869 return $v_result; 2870 } 2871 2872 // ----- Add the compressed data 2873 if (($v_file_compressed = @fopen($v_gzip_temp_name, "rb")) == 0) 2874 { 2875 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \''.$v_gzip_temp_name.'\' in binary read mode'); 2876 return PclZip::errorCode(); 2877 } 2878 2879 // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks 2880 fseek($v_file_compressed, 10); 2881 $v_size = $p_header['compressed_size']; 2882 while ($v_size != 0) 2883 { 2884 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 2885 $v_buffer = @fread($v_file_compressed, $v_read_size); 2886 //$v_binary_data = pack('a'.$v_read_size, $v_buffer); 2887 @fwrite($this->zip_fd, $v_buffer, $v_read_size); 2888 $v_size -= $v_read_size; 2889 } 2890 2891 // ----- Close the file 2892 @fclose($v_file_compressed); 2893 2894 // ----- Unlink the temporary file 2895 @unlink($v_gzip_temp_name); 2896 2897 // ----- Return 2898 return $v_result; 2899 } 2900 // -------------------------------------------------------------------------------- 2901 2902 // -------------------------------------------------------------------------------- 2903 // Function : privCalculateStoredFilename() 2904 // Description : 2905 // Based on file descriptor properties and global options, this method 2906 // calculate the filename that will be stored in the archive. 2907 // Parameters : 2908 // Return Values : 2909 // -------------------------------------------------------------------------------- 2910 function privCalculateStoredFilename(&$p_filedescr, &$p_options) 2911 { 2912 $v_result=1; 2913 2914 // ----- Working variables 2915 $p_filename = $p_filedescr['filename']; 2916 if (isset($p_options[PCLZIP_OPT_ADD_PATH])) { 2917 $p_add_dir = $p_options[PCLZIP_OPT_ADD_PATH]; 2918 } 2919 else { 2920 $p_add_dir = ''; 2921 } 2922 if (isset($p_options[PCLZIP_OPT_REMOVE_PATH])) { 2923 $p_remove_dir = $p_options[PCLZIP_OPT_REMOVE_PATH]; 2924 } 2925 else { 2926 $p_remove_dir = ''; 2927 } 2928 if (isset($p_options[PCLZIP_OPT_REMOVE_ALL_PATH])) { 2929 $p_remove_all_dir = $p_options[PCLZIP_OPT_REMOVE_ALL_PATH]; 2930 } 2931 else { 2932 $p_remove_all_dir = 0; 2933 } 2934 2935 2936 // ----- Look for full name change 2937 if (isset($p_filedescr['new_full_name'])) { 2938 // ----- Remove drive letter if any 2939 $v_stored_filename = PclZipUtilTranslateWinPath($p_filedescr['new_full_name']); 2940 } 2941 2942 // ----- Look for path and/or short name change 2943 else { 2944 2945 // ----- Look for short name change 2946 // Its when we cahnge just the filename but not the path 2947 if (isset($p_filedescr['new_short_name'])) { 2948 $v_path_info = pathinfo($p_filename); 2949 $v_dir = ''; 2950 if ($v_path_info['dirname'] != '') { 2951 $v_dir = $v_path_info['dirname'].'/'; 2952 } 2953 $v_stored_filename = $v_dir.$p_filedescr['new_short_name']; 2954 } 2955 else { 2956 // ----- Calculate the stored filename 2957 $v_stored_filename = $p_filename; 2958 } 2959 2960 // ----- Look for all path to remove 2961 if ($p_remove_all_dir) { 2962 $v_stored_filename = basename($p_filename); 2963 } 2964 // ----- Look for partial path remove 2965 else if ($p_remove_dir != "") { 2966 if (substr($p_remove_dir, -1) != '/') 2967 $p_remove_dir .= "/"; 2968 2969 if ( (substr($p_filename, 0, 2) == "./") 2970 || (substr($p_remove_dir, 0, 2) == "./")) { 2971 2972 if ( (substr($p_filename, 0, 2) == "./") 2973 && (substr($p_remove_dir, 0, 2) != "./")) { 2974 $p_remove_dir = "./".$p_remove_dir; 2975 } 2976 if ( (substr($p_filename, 0, 2) != "./") 2977 && (substr($p_remove_dir, 0, 2) == "./")) { 2978 $p_remove_dir = substr($p_remove_dir, 2); 2979 } 2980 } 2981 2982 $v_compare = PclZipUtilPathInclusion($p_remove_dir, 2983 $v_stored_filename); 2984 if ($v_compare > 0) { 2985 if ($v_compare == 2) { 2986 $v_stored_filename = ""; 2987 } 2988 else { 2989 $v_stored_filename = substr($v_stored_filename, 2990 strlen($p_remove_dir)); 2991 } 2992 } 2993 } 2994 2995 // ----- Remove drive letter if any 2996 $v_stored_filename = PclZipUtilTranslateWinPath($v_stored_filename); 2997 2998 // ----- Look for path to add 2999 if ($p_add_dir != "") { 3000 if (substr($p_add_dir, -1) == "/") 3001 $v_stored_filename = $p_add_dir.$v_stored_filename; 3002 else 3003 $v_stored_filename = $p_add_dir."/".$v_stored_filename; 3004 } 3005 } 3006 3007 // ----- Filename (reduce the path of stored name) 3008 $v_stored_filename = PclZipUtilPathReduction($v_stored_filename); 3009 $p_filedescr['stored_filename'] = $v_stored_filename; 3010 3011 // ----- Return 3012 return $v_result; 3013 } 3014 // -------------------------------------------------------------------------------- 3015 3016 // -------------------------------------------------------------------------------- 3017 // Function : privWriteFileHeader() 3018 // Description : 3019 // Parameters : 3020 // Return Values : 3021 // -------------------------------------------------------------------------------- 3022 function privWriteFileHeader(&$p_header) 3023 { 3024 $v_result=1; 3025 3026 // ----- Store the offset position of the file 3027 $p_header['offset'] = ftell($this->zip_fd); 3028 3029 // ----- Transform UNIX mtime to DOS format mdate/mtime 3030 $v_date = getdate($p_header['mtime']); 3031 $v_mtime = ($v_date['hours']<<11) + ($v_date['minutes']<<5) + $v_date['seconds']/2; 3032 $v_mdate = (($v_date['year']-1980)<<9) + ($v_date['mon']<<5) + $v_date['mday']; 3033 3034 // ----- Packed data 3035 $v_binary_data = pack("VvvvvvVVVvv", 0x04034b50, 3036 $p_header['version_extracted'], $p_header['flag'], 3037 $p_header['compression'], $v_mtime, $v_mdate, 3038 $p_header['crc'], $p_header['compressed_size'], 3039 $p_header['size'], 3040 strlen($p_header['stored_filename']), 3041 $p_header['extra_len']); 3042 3043 // ----- Write the first 148 bytes of the header in the archive 3044 fputs($this->zip_fd, $v_binary_data, 30); 3045 3046 // ----- Write the variable fields 3047 if (strlen($p_header['stored_filename']) != 0) 3048 { 3049 fputs($this->zip_fd, $p_header['stored_filename'], strlen($p_header['stored_filename'])); 3050 } 3051 if ($p_header['extra_len'] != 0) 3052 { 3053 fputs($this->zip_fd, $p_header['extra'], $p_header['extra_len']); 3054 } 3055 3056 // ----- Return 3057 return $v_result; 3058 } 3059 // -------------------------------------------------------------------------------- 3060 3061 // -------------------------------------------------------------------------------- 3062 // Function : privWriteCentralFileHeader() 3063 // Description : 3064 // Parameters : 3065 // Return Values : 3066 // -------------------------------------------------------------------------------- 3067 function privWriteCentralFileHeader(&$p_header) 3068 { 3069 $v_result=1; 3070 3071 // TBC 3072 //for(reset($p_header); $key = key($p_header); next($p_header)) { 3073 //} 3074 3075 // ----- Transform UNIX mtime to DOS format mdate/mtime 3076 $v_date = getdate($p_header['mtime']); 3077 $v_mtime = ($v_date['hours']<<11) + ($v_date['minutes']<<5) + $v_date['seconds']/2; 3078 $v_mdate = (($v_date['year']-1980)<<9) + ($v_date['mon']<<5) + $v_date['mday']; 3079 3080 3081 // ----- Packed data 3082 $v_binary_data = pack("VvvvvvvVVVvvvvvVV", 0x02014b50, 3083 $p_header['version'], $p_header['version_extracted'], 3084 $p_header['flag'], $p_header['compression'], 3085 $v_mtime, $v_mdate, $p_header['crc'], 3086 $p_header['compressed_size'], $p_header['size'], 3087 strlen($p_header['stored_filename']), 3088 $p_header['extra_len'], $p_header['comment_len'], 3089 $p_header['disk'], $p_header['internal'], 3090 $p_header['external'], $p_header['offset']); 3091 3092 // ----- Write the 42 bytes of the header in the zip file 3093 fputs($this->zip_fd, $v_binary_data, 46); 3094 3095 // ----- Write the variable fields 3096 if (strlen($p_header['stored_filename']) != 0) 3097 { 3098 fputs($this->zip_fd, $p_header['stored_filename'], strlen($p_header['stored_filename'])); 3099 } 3100 if ($p_header['extra_len'] != 0) 3101 { 3102 fputs($this->zip_fd, $p_header['extra'], $p_header['extra_len']); 3103 } 3104 if ($p_header['comment_len'] != 0) 3105 { 3106 fputs($this->zip_fd, $p_header['comment'], $p_header['comment_len']); 3107 } 3108 3109 // ----- Return 3110 return $v_result; 3111 } 3112 // -------------------------------------------------------------------------------- 3113 3114 // -------------------------------------------------------------------------------- 3115 // Function : privWriteCentralHeader() 3116 // Description : 3117 // Parameters : 3118 // Return Values : 3119 // -------------------------------------------------------------------------------- 3120 function privWriteCentralHeader($p_nb_entries, $p_size, $p_offset, $p_comment) 3121 { 3122 $v_result=1; 3123 3124 // ----- Packed data 3125 $v_binary_data = pack("VvvvvVVv", 0x06054b50, 0, 0, $p_nb_entries, 3126 $p_nb_entries, $p_size, 3127 $p_offset, strlen($p_comment)); 3128 3129 // ----- Write the 22 bytes of the header in the zip file 3130 fputs($this->zip_fd, $v_binary_data, 22); 3131 3132 // ----- Write the variable fields 3133 if (strlen($p_comment) != 0) 3134 { 3135 fputs($this->zip_fd, $p_comment, strlen($p_comment)); 3136 } 3137 3138 // ----- Return 3139 return $v_result; 3140 } 3141 // -------------------------------------------------------------------------------- 3142 3143 // -------------------------------------------------------------------------------- 3144 // Function : privList() 3145 // Description : 3146 // Parameters : 3147 // Return Values : 3148 // -------------------------------------------------------------------------------- 3149 function privList(&$p_list) 3150 { 3151 $v_result=1; 3152 3153 // ----- Magic quotes trick 3154 $this->privDisableMagicQuotes(); 3155 3156 // ----- Open the zip file 3157 if (($this->zip_fd = @fopen($this->zipname, 'rb')) == 0) 3158 { 3159 // ----- Magic quotes trick 3160 $this->privSwapBackMagicQuotes(); 3161 3162 // ----- Error log 3163 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive \''.$this->zipname.'\' in binary read mode'); 3164 3165 // ----- Return 3166 return PclZip::errorCode(); 3167 } 3168 3169 // ----- Read the central directory informations 3170 $v_central_dir = array(); 3171 if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) 3172 { 3173 $this->privSwapBackMagicQuotes(); 3174 return $v_result; 3175 } 3176 3177 // ----- Go to beginning of Central Dir 3178 @rewind($this->zip_fd); 3179 if (@fseek($this->zip_fd, $v_central_dir['offset'])) 3180 { 3181 $this->privSwapBackMagicQuotes(); 3182 3183 // ----- Error log 3184 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size'); 3185 3186 // ----- Return 3187 return PclZip::errorCode(); 3188 } 3189 3190 // ----- Read each entry 3191 for ($i=0; $i<$v_central_dir['entries']; $i++) 3192 { 3193 // ----- Read the file header 3194 if (($v_result = $this->privReadCentralFileHeader($v_header)) != 1) 3195 { 3196 $this->privSwapBackMagicQuotes(); 3197 return $v_result; 3198 } 3199 $v_header['index'] = $i; 3200 3201 // ----- Get the only interesting attributes 3202 $this->privConvertHeader2FileInfo($v_header, $p_list[$i]); 3203 unset($v_header); 3204 } 3205 3206 // ----- Close the zip file 3207 $this->privCloseFd(); 3208 3209 // ----- Magic quotes trick 3210 $this->privSwapBackMagicQuotes(); 3211 3212 // ----- Return 3213 return $v_result; 3214 } 3215 // -------------------------------------------------------------------------------- 3216 3217 // -------------------------------------------------------------------------------- 3218 // Function : privConvertHeader2FileInfo() 3219 // Description : 3220 // This function takes the file informations from the central directory 3221 // entries and extract the interesting parameters that will be given back. 3222 // The resulting file infos are set in the array $p_info 3223 // $p_info['filename'] : Filename with full path. Given by user (add), 3224 // extracted in the filesystem (extract). 3225 // $p_info['stored_filename'] : Stored filename in the archive. 3226 // $p_info['size'] = Size of the file. 3227 // $p_info['compressed_size'] = Compressed size of the file. 3228 // $p_info['mtime'] = Last modification date of the file. 3229 // $p_info['comment'] = Comment associated with the file. 3230 // $p_info['folder'] = true/false : indicates if the entry is a folder or not. 3231 // $p_info['status'] = status of the action on the file. 3232 // $p_info['crc'] = CRC of the file content. 3233 // Parameters : 3234 // Return Values : 3235 // -------------------------------------------------------------------------------- 3236 function privConvertHeader2FileInfo($p_header, &$p_info) 3237 { 3238 $v_result=1; 3239 3240 // ----- Get the interesting attributes 3241 $v_temp_path = PclZipUtilPathReduction($p_header['filename']); 3242 $p_info['filename'] = $v_temp_path; 3243 $v_temp_path = PclZipUtilPathReduction($p_header['stored_filename']); 3244 $p_info['stored_filename'] = $v_temp_path; 3245 $p_info['size'] = $p_header['size']; 3246 $p_info['compressed_size'] = $p_header['compressed_size']; 3247 $p_info['mtime'] = $p_header['mtime']; 3248 $p_info['comment'] = $p_header['comment']; 3249 $p_info['folder'] = (($p_header['external']&0x00000010)==0x00000010); 3250 $p_info['index'] = $p_header['index']; 3251 $p_info['status'] = $p_header['status']; 3252 $p_info['crc'] = $p_header['crc']; 3253 3254 // ----- Return 3255 return $v_result; 3256 } 3257 // -------------------------------------------------------------------------------- 3258 3259 // -------------------------------------------------------------------------------- 3260 // Function : privExtractByRule() 3261 // Description : 3262 // Extract a file or directory depending of rules (by index, by name, ...) 3263 // Parameters : 3264 // $p_file_list : An array where will be placed the properties of each 3265 // extracted file 3266 // $p_path : Path to add while writing the extracted files 3267 // $p_remove_path : Path to remove (from the file memorized path) while writing the 3268 // extracted files. If the path does not match the file path, 3269 // the file is extracted with its memorized path. 3270 // $p_remove_path does not apply to 'list' mode. 3271 // $p_path and $p_remove_path are commulative. 3272 // Return Values : 3273 // 1 on success,0 or less on error (see error code list) 3274 // -------------------------------------------------------------------------------- 3275 function privExtractByRule(&$p_file_list, $p_path, $p_remove_path, $p_remove_all_path, &$p_options) 3276 { 3277 $v_result=1; 3278 3279 // ----- Magic quotes trick 3280 $this->privDisableMagicQuotes(); 3281 3282 // ----- Check the path 3283 if ( ($p_path == "") 3284 || ( (substr($p_path, 0, 1) != "/") 3285 && (substr($p_path, 0, 3) != "../") 3286 && (substr($p_path,1,2)!=":/"))) 3287 $p_path = "./".$p_path; 3288 3289 // ----- Reduce the path last (and duplicated) '/' 3290 if (($p_path != "./") && ($p_path != "/")) 3291 { 3292 // ----- Look for the path end '/' 3293 while (substr($p_path, -1) == "/") 3294 { 3295 $p_path = substr($p_path, 0, strlen($p_path)-1); 3296 } 3297 } 3298 3299 // ----- Look for path to remove format (should end by /) 3300 if (($p_remove_path != "") && (substr($p_remove_path, -1) != '/')) 3301 { 3302 $p_remove_path .= '/'; 3303 } 3304 $p_remove_path_size = strlen($p_remove_path); 3305 3306 // ----- Open the zip file 3307 if (($v_result = $this->privOpenFd('rb')) != 1) 3308 { 3309 $this->privSwapBackMagicQuotes(); 3310 return $v_result; 3311 } 3312 3313 // ----- Read the central directory informations 3314 $v_central_dir = array(); 3315 if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) 3316 { 3317 // ----- Close the zip file 3318 $this->privCloseFd(); 3319 $this->privSwapBackMagicQuotes(); 3320 3321 return $v_result; 3322 } 3323 3324 // ----- Start at beginning of Central Dir 3325 $v_pos_entry = $v_central_dir['offset']; 3326 3327 // ----- Read each entry 3328 $j_start = 0; 3329 for ($i=0, $v_nb_extracted=0; $i<$v_central_dir['entries']; $i++) 3330 { 3331 3332 // ----- Read next Central dir entry 3333 @rewind($this->zip_fd); 3334 if (@fseek($this->zip_fd, $v_pos_entry)) 3335 { 3336 // ----- Close the zip file 3337 $this->privCloseFd(); 3338 $this->privSwapBackMagicQuotes(); 3339 3340 // ----- Error log 3341 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size'); 3342 3343 // ----- Return 3344 return PclZip::errorCode(); 3345 } 3346 3347 // ----- Read the file header 3348 $v_header = array(); 3349 if (($v_result = $this->privReadCentralFileHeader($v_header)) != 1) 3350 { 3351 // ----- Close the zip file 3352 $this->privCloseFd(); 3353 $this->privSwapBackMagicQuotes(); 3354 3355 return $v_result; 3356 } 3357 3358 // ----- Store the index 3359 $v_header['index'] = $i; 3360 3361 // ----- Store the file position 3362 $v_pos_entry = ftell($this->zip_fd); 3363 3364 // ----- Look for the specific extract rules 3365 $v_extract = false; 3366 3367 // ----- Look for extract by name rule 3368 if ( (isset($p_options[PCLZIP_OPT_BY_NAME])) 3369 && ($p_options[PCLZIP_OPT_BY_NAME] != 0)) { 3370 3371 // ----- Look if the filename is in the list 3372 for ($j=0; ($j<sizeof($p_options[PCLZIP_OPT_BY_NAME])) && (!$v_extract); $j++) { 3373 3374 // ----- Look for a directory 3375 if (substr($p_options[PCLZIP_OPT_BY_NAME][$j], -1) == "/") { 3376 3377 // ----- Look if the directory is in the filename path 3378 if ( (strlen($v_header['stored_filename']) > strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) 3379 && (substr($v_header['stored_filename'], 0, strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) == $p_options[PCLZIP_OPT_BY_NAME][$j])) { 3380 $v_extract = true; 3381 } 3382 } 3383 // ----- Look for a filename 3384 elseif ($v_header['stored_filename'] == $p_options[PCLZIP_OPT_BY_NAME][$j]) { 3385 $v_extract = true; 3386 } 3387 } 3388 } 3389 3390 // ----- Look for extract by ereg rule 3391 // ereg() is deprecated with PHP 5.3 3392 /* 3393 else if ( (isset($p_options[PCLZIP_OPT_BY_EREG])) 3394 && ($p_options[PCLZIP_OPT_BY_EREG] != "")) { 3395 3396 if (ereg($p_options[PCLZIP_OPT_BY_EREG], $v_header['stored_filename'])) { 3397 $v_extract = true; 3398 } 3399 } 3400 */ 3401 3402 // ----- Look for extract by preg rule 3403 else if ( (isset($p_options[PCLZIP_OPT_BY_PREG])) 3404 && ($p_options[PCLZIP_OPT_BY_PREG] != "")) { 3405 3406 if (preg_match($p_options[PCLZIP_OPT_BY_PREG], $v_header['stored_filename'])) { 3407 $v_extract = true; 3408 } 3409 } 3410 3411 // ----- Look for extract by index rule 3412 else if ( (isset($p_options[PCLZIP_OPT_BY_INDEX])) 3413 && ($p_options[PCLZIP_OPT_BY_INDEX] != 0)) { 3414 3415 // ----- Look if the index is in the list 3416 for ($j=$j_start; ($j<sizeof($p_options[PCLZIP_OPT_BY_INDEX])) && (!$v_extract); $j++) { 3417 3418 if (($i>=$p_options[PCLZIP_OPT_BY_INDEX][$j]['start']) && ($i<=$p_options[PCLZIP_OPT_BY_INDEX][$j]['end'])) { 3419 $v_extract = true; 3420 } 3421 if ($i>=$p_options[PCLZIP_OPT_BY_INDEX][$j]['end']) { 3422 $j_start = $j+1; 3423 } 3424 3425 if ($p_options[PCLZIP_OPT_BY_INDEX][$j]['start']>$i) { 3426 break; 3427 } 3428 } 3429 } 3430 3431 // ----- Look for no rule, which means extract all the archive 3432 else { 3433 $v_extract = true; 3434 } 3435 3436 // ----- Check compression method 3437 if ( ($v_extract) 3438 && ( ($v_header['compression'] != 8) 3439 && ($v_header['compression'] != 0))) { 3440 $v_header['status'] = 'unsupported_compression'; 3441 3442 // ----- Look for PCLZIP_OPT_STOP_ON_ERROR 3443 if ( (isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) 3444 && ($p_options[PCLZIP_OPT_STOP_ON_ERROR]===true)) { 3445 3446 $this->privSwapBackMagicQuotes(); 3447 3448 PclZip::privErrorLog(PCLZIP_ERR_UNSUPPORTED_COMPRESSION, 3449 "Filename '".$v_header['stored_filename']."' is " 3450 ."compressed by an unsupported compression " 3451 ."method (".$v_header['compression'].") "); 3452 3453 return PclZip::errorCode(); 3454 } 3455 } 3456 3457 // ----- Check encrypted files 3458 if (($v_extract) && (($v_header['flag'] & 1) == 1)) { 3459 $v_header['status'] = 'unsupported_encryption'; 3460 3461 // ----- Look for PCLZIP_OPT_STOP_ON_ERROR 3462 if ( (isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) 3463 && ($p_options[PCLZIP_OPT_STOP_ON_ERROR]===true)) { 3464 3465 $this->privSwapBackMagicQuotes(); 3466 3467 PclZip::privErrorLog(PCLZIP_ERR_UNSUPPORTED_ENCRYPTION, 3468 "Unsupported encryption for " 3469 ." filename '".$v_header['stored_filename'] 3470 ."'"); 3471 3472 return PclZip::errorCode(); 3473 } 3474 } 3475 3476 // ----- Look for real extraction 3477 if (($v_extract) && ($v_header['status'] != 'ok')) { 3478 $v_result = $this->privConvertHeader2FileInfo($v_header, 3479 $p_file_list[$v_nb_extracted++]); 3480 if ($v_result != 1) { 3481 $this->privCloseFd(); 3482 $this->privSwapBackMagicQuotes(); 3483 return $v_result; 3484 } 3485 3486 $v_extract = false; 3487 } 3488 3489 // ----- Look for real extraction 3490 if ($v_extract) 3491 { 3492 3493 // ----- Go to the file position 3494 @rewind($this->zip_fd); 3495 if (@fseek($this->zip_fd, $v_header['offset'])) 3496 { 3497 // ----- Close the zip file 3498 $this->privCloseFd(); 3499 3500 $this->privSwapBackMagicQuotes(); 3501 3502 // ----- Error log 3503 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size'); 3504 3505 // ----- Return 3506 return PclZip::errorCode(); 3507 } 3508 3509 // ----- Look for extraction as string 3510 if ($p_options[PCLZIP_OPT_EXTRACT_AS_STRING]) { 3511 3512 $v_string = ''; 3513 3514 // ----- Extracting the file 3515 $v_result1 = $this->privExtractFileAsString($v_header, $v_string, $p_options); 3516 if ($v_result1 < 1) { 3517 $this->privCloseFd(); 3518 $this->privSwapBackMagicQuotes(); 3519 return $v_result1; 3520 } 3521 3522 // ----- Get the only interesting attributes 3523 if (($v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted])) != 1) 3524 { 3525 // ----- Close the zip file 3526 $this->privCloseFd(); 3527 $this->privSwapBackMagicQuotes(); 3528 3529 return $v_result; 3530 } 3531 3532 // ----- Set the file content 3533 $p_file_list[$v_nb_extracted]['content'] = $v_string; 3534 3535 // ----- Next extracted file 3536 $v_nb_extracted++; 3537 3538 // ----- Look for user callback abort 3539 if ($v_result1 == 2) { 3540 break; 3541 } 3542 } 3543 // ----- Look for extraction in standard output 3544 elseif ( (isset($p_options[PCLZIP_OPT_EXTRACT_IN_OUTPUT])) 3545 && ($p_options[PCLZIP_OPT_EXTRACT_IN_OUTPUT])) { 3546 // ----- Extracting the file in standard output 3547 $v_result1 = $this->privExtractFileInOutput($v_header, $p_options); 3548 if ($v_result1 < 1) { 3549 $this->privCloseFd(); 3550 $this->privSwapBackMagicQuotes(); 3551 return $v_result1; 3552 } 3553 3554 // ----- Get the only interesting attributes 3555 if (($v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted++])) != 1) { 3556 $this->privCloseFd(); 3557 $this->privSwapBackMagicQuotes(); 3558 return $v_result; 3559 } 3560 3561 // ----- Look for user callback abort 3562 if ($v_result1 == 2) { 3563 break; 3564 } 3565 } 3566 // ----- Look for normal extraction 3567 else { 3568 // ----- Extracting the file 3569 $v_result1 = $this->privExtractFile($v_header, 3570 $p_path, $p_remove_path, 3571 $p_remove_all_path, 3572 $p_options); 3573 if ($v_result1 < 1) { 3574 $this->privCloseFd(); 3575 $this->privSwapBackMagicQuotes(); 3576 return $v_result1; 3577 } 3578 3579 // ----- Get the only interesting attributes 3580 if (($v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted++])) != 1) 3581 { 3582 // ----- Close the zip file 3583 $this->privCloseFd(); 3584 $this->privSwapBackMagicQuotes(); 3585 3586 return $v_result; 3587 } 3588 3589 // ----- Look for user callback abort 3590 if ($v_result1 == 2) { 3591 break; 3592 } 3593 } 3594 } 3595 } 3596 3597 // ----- Close the zip file 3598 $this->privCloseFd(); 3599 $this->privSwapBackMagicQuotes(); 3600 3601 // ----- Return 3602 return $v_result; 3603 } 3604 // -------------------------------------------------------------------------------- 3605 3606 // -------------------------------------------------------------------------------- 3607 // Function : privExtractFile() 3608 // Description : 3609 // Parameters : 3610 // Return Values : 3611 // 3612 // 1 : ... ? 3613 // PCLZIP_ERR_USER_ABORTED(2) : User ask for extraction stop in callback 3614 // -------------------------------------------------------------------------------- 3615 function privExtractFile(&$p_entry, $p_path, $p_remove_path, $p_remove_all_path, &$p_options) 3616 { 3617 $v_result=1; 3618 3619 // ----- Read the file header 3620 if (($v_result = $this->privReadFileHeader($v_header)) != 1) 3621 { 3622 // ----- Return 3623 return $v_result; 3624 } 3625 3626 3627 // ----- Check that the file header is coherent with $p_entry info 3628 if ($this->privCheckFileHeaders($v_header, $p_entry) != 1) { 3629 // TBC 3630 } 3631 3632 // ----- Look for all path to remove 3633 if ($p_remove_all_path == true) { 3634 // ----- Look for folder entry that not need to be extracted 3635 if (($p_entry['external']&0x00000010)==0x00000010) { 3636 3637 $p_entry['status'] = "filtered"; 3638 3639 return $v_result; 3640 } 3641 3642 // ----- Get the basename of the path 3643 $p_entry['filename'] = basename($p_entry['filename']); 3644 } 3645 3646 // ----- Look for path to remove 3647 else if ($p_remove_path != "") 3648 { 3649 if (PclZipUtilPathInclusion($p_remove_path, $p_entry['filename']) == 2) 3650 { 3651 3652 // ----- Change the file status 3653 $p_entry['status'] = "filtered"; 3654 3655 // ----- Return 3656 return $v_result; 3657 } 3658 3659 $p_remove_path_size = strlen($p_remove_path); 3660 if (substr($p_entry['filename'], 0, $p_remove_path_size) == $p_remove_path) 3661 { 3662 3663 // ----- Remove the path 3664 $p_entry['filename'] = substr($p_entry['filename'], $p_remove_path_size); 3665 3666 } 3667 } 3668 3669 // ----- Add the path 3670 if ($p_path != '') { 3671 $p_entry['filename'] = $p_path."/".$p_entry['filename']; 3672 } 3673 3674 // ----- Check a base_dir_restriction 3675 if (isset($p_options[PCLZIP_OPT_EXTRACT_DIR_RESTRICTION])) { 3676 $v_inclusion 3677 = PclZipUtilPathInclusion($p_options[PCLZIP_OPT_EXTRACT_DIR_RESTRICTION], 3678 $p_entry['filename']); 3679 if ($v_inclusion == 0) { 3680 3681 PclZip::privErrorLog(PCLZIP_ERR_DIRECTORY_RESTRICTION, 3682 "Filename '".$p_entry['filename']."' is " 3683 ."outside PCLZIP_OPT_EXTRACT_DIR_RESTRICTION"); 3684 3685 return PclZip::errorCode(); 3686 } 3687 } 3688 3689 // ----- Look for pre-extract callback 3690 if (isset($p_options[PCLZIP_CB_PRE_EXTRACT])) { 3691 3692 // ----- Generate a local information 3693 $v_local_header = array(); 3694 $this->privConvertHeader2FileInfo($p_entry, $v_local_header); 3695 3696 // ----- Call the callback 3697 // Here I do not use call_user_func() because I need to send a reference to the 3698 // header. 3699 // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_EXTRACT].'(PCLZIP_CB_PRE_EXTRACT, $v_local_header);'); 3700 $v_result = $p_options[PCLZIP_CB_PRE_EXTRACT](PCLZIP_CB_PRE_EXTRACT, $v_local_header); 3701 if ($v_result == 0) { 3702 // ----- Change the file status 3703 $p_entry['status'] = "skipped"; 3704 $v_result = 1; 3705 } 3706 3707 // ----- Look for abort result 3708 if ($v_result == 2) { 3709 // ----- This status is internal and will be changed in 'skipped' 3710 $p_entry['status'] = "aborted"; 3711 $v_result = PCLZIP_ERR_USER_ABORTED; 3712 } 3713 3714 // ----- Update the informations 3715 // Only some fields can be modified 3716 $p_entry['filename'] = $v_local_header['filename']; 3717 } 3718 3719 3720 // ----- Look if extraction should be done 3721 if ($p_entry['status'] == 'ok') { 3722 3723 // ----- Look for specific actions while the file exist 3724 if (file_exists($p_entry['filename'])) 3725 { 3726 3727 // ----- Look if file is a directory 3728 if (is_dir($p_entry['filename'])) 3729 { 3730 3731 // ----- Change the file status 3732 $p_entry['status'] = "already_a_directory"; 3733 3734 // ----- Look for PCLZIP_OPT_STOP_ON_ERROR 3735 // For historical reason first PclZip implementation does not stop 3736 // when this kind of error occurs. 3737 if ( (isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) 3738 && ($p_options[PCLZIP_OPT_STOP_ON_ERROR]===true)) { 3739 3740 PclZip::privErrorLog(PCLZIP_ERR_ALREADY_A_DIRECTORY, 3741 "Filename '".$p_entry['filename']."' is " 3742 ."already used by an existing directory"); 3743 3744 return PclZip::errorCode(); 3745 } 3746 } 3747 // ----- Look if file is write protected 3748 else if (!is_writeable($p_entry['filename'])) 3749 { 3750 3751 // ----- Change the file status 3752 $p_entry['status'] = "write_protected"; 3753 3754 // ----- Look for PCLZIP_OPT_STOP_ON_ERROR 3755 // For historical reason first PclZip implementation does not stop 3756 // when this kind of error occurs. 3757 if ( (isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) 3758 && ($p_options[PCLZIP_OPT_STOP_ON_ERROR]===true)) { 3759 3760 PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, 3761 "Filename '".$p_entry['filename']."' exists " 3762 ."and is write protected"); 3763 3764 return PclZip::errorCode(); 3765 } 3766 } 3767 3768 // ----- Look if the extracted file is older 3769 else if (filemtime($p_entry['filename']) > $p_entry['mtime']) 3770 { 3771 // ----- Change the file status 3772 if ( (isset($p_options[PCLZIP_OPT_REPLACE_NEWER])) 3773 && ($p_options[PCLZIP_OPT_REPLACE_NEWER]===true)) { 3774 } 3775 else { 3776 $p_entry['status'] = "newer_exist"; 3777 3778 // ----- Look for PCLZIP_OPT_STOP_ON_ERROR 3779 // For historical reason first PclZip implementation does not stop 3780 // when this kind of error occurs. 3781 if ( (isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) 3782 && ($p_options[PCLZIP_OPT_STOP_ON_ERROR]===true)) { 3783 3784 PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, 3785 "Newer version of '".$p_entry['filename']."' exists " 3786 ."and option PCLZIP_OPT_REPLACE_NEWER is not selected"); 3787 3788 return PclZip::errorCode(); 3789 } 3790 } 3791 } 3792 else { 3793 } 3794 } 3795 3796 // ----- Check the directory availability and create it if necessary 3797 else { 3798 if ((($p_entry['external']&0x00000010)==0x00000010) || (substr($p_entry['filename'], -1) == '/')) 3799 $v_dir_to_check = $p_entry['filename']; 3800 else if (!strstr($p_entry['filename'], "/")) 3801 $v_dir_to_check = ""; 3802 else 3803 $v_dir_to_check = dirname($p_entry['filename']); 3804 3805 if (($v_result = $this->privDirCheck($v_dir_to_check, (($p_entry['external']&0x00000010)==0x00000010))) != 1) { 3806 3807 // ----- Change the file status 3808 $p_entry['status'] = "path_creation_fail"; 3809 3810 // ----- Return 3811 //return $v_result; 3812 $v_result = 1; 3813 } 3814 } 3815 } 3816 3817 // ----- Look if extraction should be done 3818 if ($p_entry['status'] == 'ok') { 3819 3820 // ----- Do the extraction (if not a folder) 3821 if (!(($p_entry['external']&0x00000010)==0x00000010)) 3822 { 3823 // ----- Look for not compressed file 3824 if ($p_entry['compression'] == 0) { 3825 3826 // ----- Opening destination file 3827 if (($v_dest_file = @fopen($p_entry['filename'], 'wb')) == 0) 3828 { 3829 3830 // ----- Change the file status 3831 $p_entry['status'] = "write_error"; 3832 3833 // ----- Return 3834 return $v_result; 3835 } 3836 3837 3838 // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks 3839 $v_size = $p_entry['compressed_size']; 3840 while ($v_size != 0) 3841 { 3842 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 3843 $v_buffer = @fread($this->zip_fd, $v_read_size); 3844 /* Try to speed up the code 3845 $v_binary_data = pack('a'.$v_read_size, $v_buffer); 3846 @fwrite($v_dest_file, $v_binary_data, $v_read_size); 3847 */ 3848 @fwrite($v_dest_file, $v_buffer, $v_read_size); 3849 $v_size -= $v_read_size; 3850 } 3851 3852 // ----- Closing the destination file 3853 fclose($v_dest_file); 3854 3855 // ----- Change the file mtime 3856 touch($p_entry['filename'], $p_entry['mtime']); 3857 3858 3859 } 3860 else { 3861 // ----- TBC 3862 // Need to be finished 3863 if (($p_entry['flag'] & 1) == 1) { 3864 PclZip::privErrorLog(PCLZIP_ERR_UNSUPPORTED_ENCRYPTION, 'File \''.$p_entry['filename'].'\' is encrypted. Encrypted files are not supported.'); 3865 return PclZip::errorCode(); 3866 } 3867 3868 3869 // ----- Look for using temporary file to unzip 3870 if ( (!isset($p_options[PCLZIP_OPT_TEMP_FILE_OFF])) 3871 && (isset($p_options[PCLZIP_OPT_TEMP_FILE_ON]) 3872 || (isset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]) 3873 && ($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] <= $p_entry['size'])) ) ) { 3874 $v_result = $this->privExtractFileUsingTempFile($p_entry, $p_options); 3875 if ($v_result < PCLZIP_ERR_NO_ERROR) { 3876 return $v_result; 3877 } 3878 } 3879 3880 // ----- Look for extract in memory 3881 else { 3882 3883 3884 // ----- Read the compressed file in a buffer (one shot) 3885 $v_buffer = @fread($this->zip_fd, $p_entry['compressed_size']); 3886 3887 // ----- Decompress the file 3888 $v_file_content = @gzinflate($v_buffer); 3889 unset($v_buffer); 3890 if ($v_file_content === FALSE) { 3891 3892 // ----- Change the file status 3893 // TBC 3894 $p_entry['status'] = "error"; 3895 3896 return $v_result; 3897 } 3898 3899 // ----- Opening destination file 3900 if (($v_dest_file = @fopen($p_entry['filename'], 'wb')) == 0) { 3901 3902 // ----- Change the file status 3903 $p_entry['status'] = "write_error"; 3904 3905 return $v_result; 3906 } 3907 3908 // ----- Write the uncompressed data 3909 @fwrite($v_dest_file, $v_file_content, $p_entry['size']); 3910 unset($v_file_content); 3911 3912 // ----- Closing the destination file 3913 @fclose($v_dest_file); 3914 3915 } 3916 3917 // ----- Change the file mtime 3918 @touch($p_entry['filename'], $p_entry['mtime']); 3919 } 3920 3921 // ----- Look for chmod option 3922 if (isset($p_options[PCLZIP_OPT_SET_CHMOD])) { 3923 3924 // ----- Change the mode of the file 3925 @chmod($p_entry['filename'], $p_options[PCLZIP_OPT_SET_CHMOD]); 3926 } 3927 3928 } 3929 } 3930 3931 // ----- Change abort status 3932 if ($p_entry['status'] == "aborted") { 3933 $p_entry['status'] = "skipped"; 3934 } 3935 3936 // ----- Look for post-extract callback 3937 elseif (isset($p_options[PCLZIP_CB_POST_EXTRACT])) { 3938 3939 // ----- Generate a local information 3940 $v_local_header = array(); 3941 $this->privConvertHeader2FileInfo($p_entry, $v_local_header); 3942 3943 // ----- Call the callback 3944 // Here I do not use call_user_func() because I need to send a reference to the 3945 // header. 3946 // eval('$v_result = '.$p_options[PCLZIP_CB_POST_EXTRACT].'(PCLZIP_CB_POST_EXTRACT, $v_local_header);'); 3947 $v_result = $p_options[PCLZIP_CB_POST_EXTRACT](PCLZIP_CB_POST_EXTRACT, $v_local_header); 3948 3949 // ----- Look for abort result 3950 if ($v_result == 2) { 3951 $v_result = PCLZIP_ERR_USER_ABORTED; 3952 } 3953 } 3954 3955 // ----- Return 3956 return $v_result; 3957 } 3958 // -------------------------------------------------------------------------------- 3959 3960 // -------------------------------------------------------------------------------- 3961 // Function : privExtractFileUsingTempFile() 3962 // Description : 3963 // Parameters : 3964 // Return Values : 3965 // -------------------------------------------------------------------------------- 3966 function privExtractFileUsingTempFile(&$p_entry, &$p_options) 3967 { 3968 $v_result=1; 3969 3970 // ----- Creates a temporary file 3971 $v_gzip_temp_name = PCLZIP_TEMPORARY_DIR.uniqid('pclzip-').'.gz'; 3972 if (($v_dest_file = @fopen($v_gzip_temp_name, "wb")) == 0) { 3973 fclose($v_file); 3974 PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, 'Unable to open temporary file \''.$v_gzip_temp_name.'\' in binary write mode'); 3975 return PclZip::errorCode(); 3976 } 3977 3978 3979 // ----- Write gz file format header 3980 $v_binary_data = pack('va1a1Va1a1', 0x8b1f, Chr($p_entry['compression']), Chr(0x00), time(), Chr(0x00), Chr(3)); 3981 @fwrite($v_dest_file, $v_binary_data, 10); 3982 3983 // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks 3984 $v_size = $p_entry['compressed_size']; 3985 while ($v_size != 0) 3986 { 3987 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 3988 $v_buffer = @fread($this->zip_fd, $v_read_size); 3989 //$v_binary_data = pack('a'.$v_read_size, $v_buffer); 3990 @fwrite($v_dest_file, $v_buffer, $v_read_size); 3991 $v_size -= $v_read_size; 3992 } 3993 3994 // ----- Write gz file format footer 3995 $v_binary_data = pack('VV', $p_entry['crc'], $p_entry['size']); 3996 @fwrite($v_dest_file, $v_binary_data, 8); 3997 3998 // ----- Close the temporary file 3999 @fclose($v_dest_file); 4000 4001 // ----- Opening destination file 4002 if (($v_dest_file = @fopen($p_entry['filename'], 'wb')) == 0) { 4003 $p_entry['status'] = "write_error"; 4004 return $v_result; 4005 } 4006 4007 // ----- Open the temporary gz file 4008 if (($v_src_file = @gzopen($v_gzip_temp_name, 'rb')) == 0) { 4009 @fclose($v_dest_file); 4010 $p_entry['status'] = "read_error"; 4011 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \''.$v_gzip_temp_name.'\' in binary read mode'); 4012 return PclZip::errorCode(); 4013 } 4014 4015 4016 // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks 4017 $v_size = $p_entry['size']; 4018 while ($v_size != 0) { 4019 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 4020 $v_buffer = @gzread($v_src_file, $v_read_size); 4021 //$v_binary_data = pack('a'.$v_read_size, $v_buffer); 4022 @fwrite($v_dest_file, $v_buffer, $v_read_size); 4023 $v_size -= $v_read_size; 4024 } 4025 @fclose($v_dest_file); 4026 @gzclose($v_src_file); 4027 4028 // ----- Delete the temporary file 4029 @unlink($v_gzip_temp_name); 4030 4031 // ----- Return 4032 return $v_result; 4033 } 4034 // -------------------------------------------------------------------------------- 4035 4036 // -------------------------------------------------------------------------------- 4037 // Function : privExtractFileInOutput() 4038 // Description : 4039 // Parameters : 4040 // Return Values : 4041 // -------------------------------------------------------------------------------- 4042 function privExtractFileInOutput(&$p_entry, &$p_options) 4043 { 4044 $v_result=1; 4045 4046 // ----- Read the file header 4047 if (($v_result = $this->privReadFileHeader($v_header)) != 1) { 4048 return $v_result; 4049 } 4050 4051 4052 // ----- Check that the file header is coherent with $p_entry info 4053 if ($this->privCheckFileHeaders($v_header, $p_entry) != 1) { 4054 // TBC 4055 } 4056 4057 // ----- Look for pre-extract callback 4058 if (isset($p_options[PCLZIP_CB_PRE_EXTRACT])) { 4059 4060 // ----- Generate a local information 4061 $v_local_header = array(); 4062 $this->privConvertHeader2FileInfo($p_entry, $v_local_header); 4063 4064 // ----- Call the callback 4065 // Here I do not use call_user_func() because I need to send a reference to the 4066 // header. 4067 // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_EXTRACT].'(PCLZIP_CB_PRE_EXTRACT, $v_local_header);'); 4068 $v_result = $p_options[PCLZIP_CB_PRE_EXTRACT](PCLZIP_CB_PRE_EXTRACT, $v_local_header); 4069 if ($v_result == 0) { 4070 // ----- Change the file status 4071 $p_entry['status'] = "skipped"; 4072 $v_result = 1; 4073 } 4074 4075 // ----- Look for abort result 4076 if ($v_result == 2) { 4077 // ----- This status is internal and will be changed in 'skipped' 4078 $p_entry['status'] = "aborted"; 4079 $v_result = PCLZIP_ERR_USER_ABORTED; 4080 } 4081 4082 // ----- Update the informations 4083 // Only some fields can be modified 4084 $p_entry['filename'] = $v_local_header['filename']; 4085 } 4086 4087 // ----- Trace 4088 4089 // ----- Look if extraction should be done 4090 if ($p_entry['status'] == 'ok') { 4091 4092 // ----- Do the extraction (if not a folder) 4093 if (!(($p_entry['external']&0x00000010)==0x00000010)) { 4094 // ----- Look for not compressed file 4095 if ($p_entry['compressed_size'] == $p_entry['size']) { 4096 4097 // ----- Read the file in a buffer (one shot) 4098 $v_buffer = @fread($this->zip_fd, $p_entry['compressed_size']); 4099 4100 // ----- Send the file to the output 4101 echo $v_buffer; 4102 unset($v_buffer); 4103 } 4104 else { 4105 4106 // ----- Read the compressed file in a buffer (one shot) 4107 $v_buffer = @fread($this->zip_fd, $p_entry['compressed_size']); 4108 4109 // ----- Decompress the file 4110 $v_file_content = gzinflate($v_buffer); 4111 unset($v_buffer); 4112 4113 // ----- Send the file to the output 4114 echo $v_file_content; 4115 unset($v_file_content); 4116 } 4117 } 4118 } 4119 4120 // ----- Change abort status 4121 if ($p_entry['status'] == "aborted") { 4122 $p_entry['status'] = "skipped"; 4123 } 4124 4125 // ----- Look for post-extract callback 4126 elseif (isset($p_options[PCLZIP_CB_POST_EXTRACT])) { 4127 4128 // ----- Generate a local information 4129 $v_local_header = array(); 4130 $this->privConvertHeader2FileInfo($p_entry, $v_local_header); 4131 4132 // ----- Call the callback 4133 // Here I do not use call_user_func() because I need to send a reference to the 4134 // header. 4135 // eval('$v_result = '.$p_options[PCLZIP_CB_POST_EXTRACT].'(PCLZIP_CB_POST_EXTRACT, $v_local_header);'); 4136 $v_result = $p_options[PCLZIP_CB_POST_EXTRACT](PCLZIP_CB_POST_EXTRACT, $v_local_header); 4137 4138 // ----- Look for abort result 4139 if ($v_result == 2) { 4140 $v_result = PCLZIP_ERR_USER_ABORTED; 4141 } 4142 } 4143 4144 return $v_result; 4145 } 4146 // -------------------------------------------------------------------------------- 4147 4148 // -------------------------------------------------------------------------------- 4149 // Function : privExtractFileAsString() 4150 // Description : 4151 // Parameters : 4152 // Return Values : 4153 // -------------------------------------------------------------------------------- 4154 function privExtractFileAsString(&$p_entry, &$p_string, &$p_options) 4155 { 4156 $v_result=1; 4157 4158 // ----- Read the file header 4159 $v_header = array(); 4160 if (($v_result = $this->privReadFileHeader($v_header)) != 1) 4161 { 4162 // ----- Return 4163 return $v_result; 4164 } 4165 4166 4167 // ----- Check that the file header is coherent with $p_entry info 4168 if ($this->privCheckFileHeaders($v_header, $p_entry) != 1) { 4169 // TBC 4170 } 4171 4172 // ----- Look for pre-extract callback 4173 if (isset($p_options[PCLZIP_CB_PRE_EXTRACT])) { 4174 4175 // ----- Generate a local information 4176 $v_local_header = array(); 4177 $this->privConvertHeader2FileInfo($p_entry, $v_local_header); 4178 4179 // ----- Call the callback 4180 // Here I do not use call_user_func() because I need to send a reference to the 4181 // header. 4182 // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_EXTRACT].'(PCLZIP_CB_PRE_EXTRACT, $v_local_header);'); 4183 $v_result = $p_options[PCLZIP_CB_PRE_EXTRACT](PCLZIP_CB_PRE_EXTRACT, $v_local_header); 4184 if ($v_result == 0) { 4185 // ----- Change the file status 4186 $p_entry['status'] = "skipped"; 4187 $v_result = 1; 4188 } 4189 4190 // ----- Look for abort result 4191 if ($v_result == 2) { 4192 // ----- This status is internal and will be changed in 'skipped' 4193 $p_entry['status'] = "aborted"; 4194 $v_result = PCLZIP_ERR_USER_ABORTED; 4195 } 4196 4197 // ----- Update the informations 4198 // Only some fields can be modified 4199 $p_entry['filename'] = $v_local_header['filename']; 4200 } 4201 4202 4203 // ----- Look if extraction should be done 4204 if ($p_entry['status'] == 'ok') { 4205 4206 // ----- Do the extraction (if not a folder) 4207 if (!(($p_entry['external']&0x00000010)==0x00000010)) { 4208 // ----- Look for not compressed file 4209 // if ($p_entry['compressed_size'] == $p_entry['size']) 4210 if ($p_entry['compression'] == 0) { 4211 4212 // ----- Reading the file 4213 $p_string = @fread($this->zip_fd, $p_entry['compressed_size']); 4214 } 4215 else { 4216 4217 // ----- Reading the file 4218 $v_data = @fread($this->zip_fd, $p_entry['compressed_size']); 4219 4220 // ----- Decompress the file 4221 if (($p_string = @gzinflate($v_data)) === FALSE) { 4222 // TBC 4223 } 4224 } 4225 4226 // ----- Trace 4227 } 4228 else { 4229 // TBC : error : can not extract a folder in a string 4230 } 4231 4232 } 4233 4234 // ----- Change abort status 4235 if ($p_entry['status'] == "aborted") { 4236 $p_entry['status'] = "skipped"; 4237 } 4238 4239 // ----- Look for post-extract callback 4240 elseif (isset($p_options[PCLZIP_CB_POST_EXTRACT])) { 4241 4242 // ----- Generate a local information 4243 $v_local_header = array(); 4244 $this->privConvertHeader2FileInfo($p_entry, $v_local_header); 4245 4246 // ----- Swap the content to header 4247 $v_local_header['content'] = $p_string; 4248 $p_string = ''; 4249 4250 // ----- Call the callback 4251 // Here I do not use call_user_func() because I need to send a reference to the 4252 // header. 4253 // eval('$v_result = '.$p_options[PCLZIP_CB_POST_EXTRACT].'(PCLZIP_CB_POST_EXTRACT, $v_local_header);'); 4254 $v_result = $p_options[PCLZIP_CB_POST_EXTRACT](PCLZIP_CB_POST_EXTRACT, $v_local_header); 4255 4256 // ----- Swap back the content to header 4257 $p_string = $v_local_header['content']; 4258 unset($v_local_header['content']); 4259 4260 // ----- Look for abort result 4261 if ($v_result == 2) { 4262 $v_result = PCLZIP_ERR_USER_ABORTED; 4263 } 4264 } 4265 4266 // ----- Return 4267 return $v_result; 4268 } 4269 // -------------------------------------------------------------------------------- 4270 4271 // -------------------------------------------------------------------------------- 4272 // Function : privReadFileHeader() 4273 // Description : 4274 // Parameters : 4275 // Return Values : 4276 // -------------------------------------------------------------------------------- 4277 function privReadFileHeader(&$p_header) 4278 { 4279 $v_result=1; 4280 4281 // ----- Read the 4 bytes signature 4282 $v_binary_data = @fread($this->zip_fd, 4); 4283 $v_data = unpack('Vid', $v_binary_data); 4284 4285 // ----- Check signature 4286 if ($v_data['id'] != 0x04034b50) 4287 { 4288 4289 // ----- Error log 4290 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Invalid archive structure'); 4291 4292 // ----- Return 4293 return PclZip::errorCode(); 4294 } 4295 4296 // ----- Read the first 42 bytes of the header 4297 $v_binary_data = fread($this->zip_fd, 26); 4298 4299 // ----- Look for invalid block size 4300 if (strlen($v_binary_data) != 26) 4301 { 4302 $p_header['filename'] = ""; 4303 $p_header['status'] = "invalid_header"; 4304 4305 // ----- Error log 4306 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Invalid block size : ".strlen($v_binary_data)); 4307 4308 // ----- Return 4309 return PclZip::errorCode(); 4310 } 4311 4312 // ----- Extract the values 4313 $v_data = unpack('vversion/vflag/vcompression/vmtime/vmdate/Vcrc/Vcompressed_size/Vsize/vfilename_len/vextra_len', $v_binary_data); 4314 4315 // ----- Get filename 4316 $p_header['filename'] = fread($this->zip_fd, $v_data['filename_len']); 4317 4318 // ----- Get extra_fields 4319 if ($v_data['extra_len'] != 0) { 4320 $p_header['extra'] = fread($this->zip_fd, $v_data['extra_len']); 4321 } 4322 else { 4323 $p_header['extra'] = ''; 4324 } 4325 4326 // ----- Extract properties 4327 $p_header['version_extracted'] = $v_data['version']; 4328 $p_header['compression'] = $v_data['compression']; 4329 $p_header['size'] = $v_data['size']; 4330 $p_header['compressed_size'] = $v_data['compressed_size']; 4331 $p_header['crc'] = $v_data['crc']; 4332 $p_header['flag'] = $v_data['flag']; 4333 $p_header['filename_len'] = $v_data['filename_len']; 4334 4335 // ----- Recuperate date in UNIX format 4336 $p_header['mdate'] = $v_data['mdate']; 4337 $p_header['mtime'] = $v_data['mtime']; 4338 if ($p_header['mdate'] && $p_header['mtime']) 4339 { 4340 // ----- Extract time 4341 $v_hour = ($p_header['mtime'] & 0xF800) >> 11; 4342 $v_minute = ($p_header['mtime'] & 0x07E0) >> 5; 4343 $v_seconde = ($p_header['mtime'] & 0x001F)*2; 4344 4345 // ----- Extract date 4346 $v_year = (($p_header['mdate'] & 0xFE00) >> 9) + 1980; 4347 $v_month = ($p_header['mdate'] & 0x01E0) >> 5; 4348 $v_day = $p_header['mdate'] & 0x001F; 4349 4350 // ----- Get UNIX date format 4351 $p_header['mtime'] = @mktime($v_hour, $v_minute, $v_seconde, $v_month, $v_day, $v_year); 4352 4353 } 4354 else 4355 { 4356 $p_header['mtime'] = time(); 4357 } 4358 4359 // TBC 4360 //for(reset($v_data); $key = key($v_data); next($v_data)) { 4361 //} 4362 4363 // ----- Set the stored filename 4364 $p_header['stored_filename'] = $p_header['filename']; 4365 4366 // ----- Set the status field 4367 $p_header['status'] = "ok"; 4368 4369 // ----- Return 4370 return $v_result; 4371 } 4372 // -------------------------------------------------------------------------------- 4373 4374 // -------------------------------------------------------------------------------- 4375 // Function : privReadCentralFileHeader() 4376 // Description : 4377 // Parameters : 4378 // Return Values : 4379 // -------------------------------------------------------------------------------- 4380 function privReadCentralFileHeader(&$p_header) 4381 { 4382 $v_result=1; 4383 4384 // ----- Read the 4 bytes signature 4385 $v_binary_data = @fread($this->zip_fd, 4); 4386 $v_data = unpack('Vid', $v_binary_data); 4387 4388 // ----- Check signature 4389 if ($v_data['id'] != 0x02014b50) 4390 { 4391 4392 // ----- Error log 4393 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Invalid archive structure'); 4394 4395 // ----- Return 4396 return PclZip::errorCode(); 4397 } 4398 4399 // ----- Read the first 42 bytes of the header 4400 $v_binary_data = fread($this->zip_fd, 42); 4401 4402 // ----- Look for invalid block size 4403 if (strlen($v_binary_data) != 42) 4404 { 4405 $p_header['filename'] = ""; 4406 $p_header['status'] = "invalid_header"; 4407 4408 // ----- Error log 4409 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Invalid block size : ".strlen($v_binary_data)); 4410 4411 // ----- Return 4412 return PclZip::errorCode(); 4413 } 4414 4415 // ----- Extract the values 4416 $p_header = unpack('vversion/vversion_extracted/vflag/vcompression/vmtime/vmdate/Vcrc/Vcompressed_size/Vsize/vfilename_len/vextra_len/vcomment_len/vdisk/vinternal/Vexternal/Voffset', $v_binary_data); 4417 4418 // ----- Get filename 4419 if ($p_header['filename_len'] != 0) 4420 $p_header['filename'] = fread($this->zip_fd, $p_header['filename_len']); 4421 else 4422 $p_header['filename'] = ''; 4423 4424 // ----- Get extra 4425 if ($p_header['extra_len'] != 0) 4426 $p_header['extra'] = fread($this->zip_fd, $p_header['extra_len']); 4427 else 4428 $p_header['extra'] = ''; 4429 4430 // ----- Get comment 4431 if ($p_header['comment_len'] != 0) 4432 $p_header['comment'] = fread($this->zip_fd, $p_header['comment_len']); 4433 else 4434 $p_header['comment'] = ''; 4435 4436 // ----- Extract properties 4437 4438 // ----- Recuperate date in UNIX format 4439 //if ($p_header['mdate'] && $p_header['mtime']) 4440 // TBC : bug : this was ignoring time with 0/0/0 4441 if (1) 4442 { 4443 // ----- Extract time 4444 $v_hour = ($p_header['mtime'] & 0xF800) >> 11; 4445 $v_minute = ($p_header['mtime'] & 0x07E0) >> 5; 4446 $v_seconde = ($p_header['mtime'] & 0x001F)*2; 4447 4448 // ----- Extract date 4449 $v_year = (($p_header['mdate'] & 0xFE00) >> 9) + 1980; 4450 $v_month = ($p_header['mdate'] & 0x01E0) >> 5; 4451 $v_day = $p_header['mdate'] & 0x001F; 4452 4453 // ----- Get UNIX date format 4454 $p_header['mtime'] = @mktime($v_hour, $v_minute, $v_seconde, $v_month, $v_day, $v_year); 4455 4456 } 4457 else 4458 { 4459 $p_header['mtime'] = time(); 4460 } 4461 4462 // ----- Set the stored filename 4463 $p_header['stored_filename'] = $p_header['filename']; 4464 4465 // ----- Set default status to ok 4466 $p_header['status'] = 'ok'; 4467 4468 // ----- Look if it is a directory 4469 if (substr($p_header['filename'], -1) == '/') { 4470 //$p_header['external'] = 0x41FF0010; 4471 $p_header['external'] = 0x00000010; 4472 } 4473 4474 4475 // ----- Return 4476 return $v_result; 4477 } 4478 // -------------------------------------------------------------------------------- 4479 4480 // -------------------------------------------------------------------------------- 4481 // Function : privCheckFileHeaders() 4482 // Description : 4483 // Parameters : 4484 // Return Values : 4485 // 1 on success, 4486 // 0 on error; 4487 // -------------------------------------------------------------------------------- 4488 function privCheckFileHeaders(&$p_local_header, &$p_central_header) 4489 { 4490 $v_result=1; 4491 4492 // ----- Check the static values 4493 // TBC 4494 if ($p_local_header['filename'] != $p_central_header['filename']) { 4495 } 4496 if ($p_local_header['version_extracted'] != $p_central_header['version_extracted']) { 4497 } 4498 if ($p_local_header['flag'] != $p_central_header['flag']) { 4499 } 4500 if ($p_local_header['compression'] != $p_central_header['compression']) { 4501 } 4502 if ($p_local_header['mtime'] != $p_central_header['mtime']) { 4503 } 4504 if ($p_local_header['filename_len'] != $p_central_header['filename_len']) { 4505 } 4506 4507 // ----- Look for flag bit 3 4508 if (($p_local_header['flag'] & 8) == 8) { 4509 $p_local_header['size'] = $p_central_header['size']; 4510 $p_local_header['compressed_size'] = $p_central_header['compressed_size']; 4511 $p_local_header['crc'] = $p_central_header['crc']; 4512 } 4513 4514 // ----- Return 4515 return $v_result; 4516 } 4517 // -------------------------------------------------------------------------------- 4518 4519 // -------------------------------------------------------------------------------- 4520 // Function : privReadEndCentralDir() 4521 // Description : 4522 // Parameters : 4523 // Return Values : 4524 // -------------------------------------------------------------------------------- 4525 function privReadEndCentralDir(&$p_central_dir) 4526 { 4527 $v_result=1; 4528 4529 // ----- Go to the end of the zip file 4530 $v_size = filesize($this->zipname); 4531 @fseek($this->zip_fd, $v_size); 4532 if (@ftell($this->zip_fd) != $v_size) 4533 { 4534 // ----- Error log 4535 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Unable to go to the end of the archive \''.$this->zipname.'\''); 4536 4537 // ----- Return 4538 return PclZip::errorCode(); 4539 } 4540 4541 // ----- First try : look if this is an archive with no commentaries (most of the time) 4542 // in this case the end of central dir is at 22 bytes of the file end 4543 $v_found = 0; 4544 if ($v_size > 26) { 4545 @fseek($this->zip_fd, $v_size-22); 4546 if (($v_pos = @ftell($this->zip_fd)) != ($v_size-22)) 4547 { 4548 // ----- Error log 4549 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Unable to seek back to the middle of the archive \''.$this->zipname.'\''); 4550 4551 // ----- Return 4552 return PclZip::errorCode(); 4553 } 4554 4555 // ----- Read for bytes 4556 $v_binary_data = @fread($this->zip_fd, 4); 4557 $v_data = @unpack('Vid', $v_binary_data); 4558 4559 // ----- Check signature 4560 if ($v_data['id'] == 0x06054b50) { 4561 $v_found = 1; 4562 } 4563 4564 $v_pos = ftell($this->zip_fd); 4565 } 4566 4567 // ----- Go back to the maximum possible size of the Central Dir End Record 4568 if (!$v_found) { 4569 $v_maximum_size = 65557; // 0xFFFF + 22; 4570 if ($v_maximum_size > $v_size) 4571 $v_maximum_size = $v_size; 4572 @fseek($this->zip_fd, $v_size-$v_maximum_size); 4573 if (@ftell($this->zip_fd) != ($v_size-$v_maximum_size)) 4574 { 4575 // ----- Error log 4576 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Unable to seek back to the middle of the archive \''.$this->zipname.'\''); 4577 4578 // ----- Return 4579 return PclZip::errorCode(); 4580 } 4581 4582 // ----- Read byte per byte in order to find the signature 4583 $v_pos = ftell($this->zip_fd); 4584 $v_bytes = 0x00000000; 4585 while ($v_pos < $v_size) 4586 { 4587 // ----- Read a byte 4588 $v_byte = @fread($this->zip_fd, 1); 4589 4590 // ----- Add the byte 4591 //$v_bytes = ($v_bytes << 8) | Ord($v_byte); 4592 // Note we mask the old value down such that once shifted we can never end up with more than a 32bit number 4593 // Otherwise on systems where we have 64bit integers the check below for the magic number will fail. 4594 $v_bytes = ( ($v_bytes & 0xFFFFFF) << 8) | Ord($v_byte); 4595 4596 // ----- Compare the bytes 4597 if ($v_bytes == 0x504b0506) 4598 { 4599 $v_pos++; 4600 break; 4601 } 4602 4603 $v_pos++; 4604 } 4605 4606 // ----- Look if not found end of central dir 4607 if ($v_pos == $v_size) 4608 { 4609 4610 // ----- Error log 4611 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Unable to find End of Central Dir Record signature"); 4612 4613 // ----- Return 4614 return PclZip::errorCode(); 4615 } 4616 } 4617 4618 // ----- Read the first 18 bytes of the header 4619 $v_binary_data = fread($this->zip_fd, 18); 4620 4621 // ----- Look for invalid block size 4622 if (strlen($v_binary_data) != 18) 4623 { 4624 4625 // ----- Error log 4626 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Invalid End of Central Dir Record size : ".strlen($v_binary_data)); 4627 4628 // ----- Return 4629 return PclZip::errorCode(); 4630 } 4631 4632 // ----- Extract the values 4633 $v_data = unpack('vdisk/vdisk_start/vdisk_entries/ventries/Vsize/Voffset/vcomment_size', $v_binary_data); 4634 4635 // ----- Check the global size 4636 if (($v_pos + $v_data['comment_size'] + 18) != $v_size) { 4637 4638 // ----- Removed in release 2.2 see readme file 4639 // The check of the file size is a little too strict. 4640 // Some bugs where found when a zip is encrypted/decrypted with 'crypt'. 4641 // While decrypted, zip has training 0 bytes 4642 if (0) { 4643 // ----- Error log 4644 PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 4645 'The central dir is not at the end of the archive.' 4646 .' Some trailing bytes exists after the archive.'); 4647 4648 // ----- Return 4649 return PclZip::errorCode(); 4650 } 4651 } 4652 4653 // ----- Get comment 4654 if ($v_data['comment_size'] != 0) { 4655 $p_central_dir['comment'] = fread($this->zip_fd, $v_data['comment_size']); 4656 } 4657 else 4658 $p_central_dir['comment'] = ''; 4659 4660 $p_central_dir['entries'] = $v_data['entries']; 4661 $p_central_dir['disk_entries'] = $v_data['disk_entries']; 4662 $p_central_dir['offset'] = $v_data['offset']; 4663 $p_central_dir['size'] = $v_data['size']; 4664 $p_central_dir['disk'] = $v_data['disk']; 4665 $p_central_dir['disk_start'] = $v_data['disk_start']; 4666 4667 // TBC 4668 //for(reset($p_central_dir); $key = key($p_central_dir); next($p_central_dir)) { 4669 //} 4670 4671 // ----- Return 4672 return $v_result; 4673 } 4674 // -------------------------------------------------------------------------------- 4675 4676 // -------------------------------------------------------------------------------- 4677 // Function : privDeleteByRule() 4678 // Description : 4679 // Parameters : 4680 // Return Values : 4681 // -------------------------------------------------------------------------------- 4682 function privDeleteByRule(&$p_result_list, &$p_options) 4683 { 4684 $v_result=1; 4685 $v_list_detail = array(); 4686 4687 // ----- Open the zip file 4688 if (($v_result=$this->privOpenFd('rb')) != 1) 4689 { 4690 // ----- Return 4691 return $v_result; 4692 } 4693 4694 // ----- Read the central directory informations 4695 $v_central_dir = array(); 4696 if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) 4697 { 4698 $this->privCloseFd(); 4699 return $v_result; 4700 } 4701 4702 // ----- Go to beginning of File 4703 @rewind($this->zip_fd); 4704 4705 // ----- Scan all the files 4706 // ----- Start at beginning of Central Dir 4707 $v_pos_entry = $v_central_dir['offset']; 4708 @rewind($this->zip_fd); 4709 if (@fseek($this->zip_fd, $v_pos_entry)) 4710 { 4711 // ----- Close the zip file 4712 $this->privCloseFd(); 4713 4714 // ----- Error log 4715 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size'); 4716 4717 // ----- Return 4718 return PclZip::errorCode(); 4719 } 4720 4721 // ----- Read each entry 4722 $v_header_list = array(); 4723 $j_start = 0; 4724 for ($i=0, $v_nb_extracted=0; $i<$v_central_dir['entries']; $i++) 4725 { 4726 4727 // ----- Read the file header 4728 $v_header_list[$v_nb_extracted] = array(); 4729 if (($v_result = $this->privReadCentralFileHeader($v_header_list[$v_nb_extracted])) != 1) 4730 { 4731 // ----- Close the zip file 4732 $this->privCloseFd(); 4733 4734 return $v_result; 4735 } 4736 4737 4738 // ----- Store the index 4739 $v_header_list[$v_nb_extracted]['index'] = $i; 4740 4741 // ----- Look for the specific extract rules 4742 $v_found = false; 4743 4744 // ----- Look for extract by name rule 4745 if ( (isset($p_options[PCLZIP_OPT_BY_NAME])) 4746 && ($p_options[PCLZIP_OPT_BY_NAME] != 0)) { 4747 4748 // ----- Look if the filename is in the list 4749 for ($j=0; ($j<sizeof($p_options[PCLZIP_OPT_BY_NAME])) && (!$v_found); $j++) { 4750 4751 // ----- Look for a directory 4752 if (substr($p_options[PCLZIP_OPT_BY_NAME][$j], -1) == "/") { 4753 4754 // ----- Look if the directory is in the filename path 4755 if ( (strlen($v_header_list[$v_nb_extracted]['stored_filename']) > strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) 4756 && (substr($v_header_list[$v_nb_extracted]['stored_filename'], 0, strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) == $p_options[PCLZIP_OPT_BY_NAME][$j])) { 4757 $v_found = true; 4758 } 4759 elseif ( (($v_header_list[$v_nb_extracted]['external']&0x00000010)==0x00000010) /* Indicates a folder */ 4760 && ($v_header_list[$v_nb_extracted]['stored_filename'].'/' == $p_options[PCLZIP_OPT_BY_NAME][$j])) { 4761 $v_found = true; 4762 } 4763 } 4764 // ----- Look for a filename 4765 elseif ($v_header_list[$v_nb_extracted]['stored_filename'] == $p_options[PCLZIP_OPT_BY_NAME][$j]) { 4766 $v_found = true; 4767 } 4768 } 4769 } 4770 4771 // ----- Look for extract by ereg rule 4772 // ereg() is deprecated with PHP 5.3 4773 /* 4774 else if ( (isset($p_options[PCLZIP_OPT_BY_EREG])) 4775 && ($p_options[PCLZIP_OPT_BY_EREG] != "")) { 4776 4777 if (ereg($p_options[PCLZIP_OPT_BY_EREG], $v_header_list[$v_nb_extracted]['stored_filename'])) { 4778 $v_found = true; 4779 } 4780 } 4781 */ 4782 4783 // ----- Look for extract by preg rule 4784 else if ( (isset($p_options[PCLZIP_OPT_BY_PREG])) 4785 && ($p_options[PCLZIP_OPT_BY_PREG] != "")) { 4786 4787 if (preg_match($p_options[PCLZIP_OPT_BY_PREG], $v_header_list[$v_nb_extracted]['stored_filename'])) { 4788 $v_found = true; 4789 } 4790 } 4791 4792 // ----- Look for extract by index rule 4793 else if ( (isset($p_options[PCLZIP_OPT_BY_INDEX])) 4794 && ($p_options[PCLZIP_OPT_BY_INDEX] != 0)) { 4795 4796 // ----- Look if the index is in the list 4797 for ($j=$j_start; ($j<sizeof($p_options[PCLZIP_OPT_BY_INDEX])) && (!$v_found); $j++) { 4798 4799 if (($i>=$p_options[PCLZIP_OPT_BY_INDEX][$j]['start']) && ($i<=$p_options[PCLZIP_OPT_BY_INDEX][$j]['end'])) { 4800 $v_found = true; 4801 } 4802 if ($i>=$p_options[PCLZIP_OPT_BY_INDEX][$j]['end']) { 4803 $j_start = $j+1; 4804 } 4805 4806 if ($p_options[PCLZIP_OPT_BY_INDEX][$j]['start']>$i) { 4807 break; 4808 } 4809 } 4810 } 4811 else { 4812 $v_found = true; 4813 } 4814 4815 // ----- Look for deletion 4816 if ($v_found) 4817 { 4818 unset($v_header_list[$v_nb_extracted]); 4819 } 4820 else 4821 { 4822 $v_nb_extracted++; 4823 } 4824 } 4825 4826 // ----- Look if something need to be deleted 4827 if ($v_nb_extracted > 0) { 4828 4829 // ----- Creates a temporay file 4830 $v_zip_temp_name = PCLZIP_TEMPORARY_DIR.uniqid('pclzip-').'.tmp'; 4831 4832 // ----- Creates a temporary zip archive 4833 $v_temp_zip = new PclZip($v_zip_temp_name); 4834 4835 // ----- Open the temporary zip file in write mode 4836 if (($v_result = $v_temp_zip->privOpenFd('wb')) != 1) { 4837 $this->privCloseFd(); 4838 4839 // ----- Return 4840 return $v_result; 4841 } 4842 4843 // ----- Look which file need to be kept 4844 for ($i=0; $i<sizeof($v_header_list); $i++) { 4845 4846 // ----- Calculate the position of the header 4847 @rewind($this->zip_fd); 4848 if (@fseek($this->zip_fd, $v_header_list[$i]['offset'])) { 4849 // ----- Close the zip file 4850 $this->privCloseFd(); 4851 $v_temp_zip->privCloseFd(); 4852 @unlink($v_zip_temp_name); 4853 4854 // ----- Error log 4855 PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size'); 4856 4857 // ----- Return 4858 return PclZip::errorCode(); 4859 } 4860 4861 // ----- Read the file header 4862 $v_local_header = array(); 4863 if (($v_result = $this->privReadFileHeader($v_local_header)) != 1) { 4864 // ----- Close the zip file 4865 $this->privCloseFd(); 4866 $v_temp_zip->privCloseFd(); 4867 @unlink($v_zip_temp_name); 4868 4869 // ----- Return 4870 return $v_result; 4871 } 4872 4873 // ----- Check that local file header is same as central file header 4874 if ($this->privCheckFileHeaders($v_local_header, 4875 $v_header_list[$i]) != 1) { 4876 // TBC 4877 } 4878 unset($v_local_header); 4879 4880 // ----- Write the file header 4881 if (($v_result = $v_temp_zip->privWriteFileHeader($v_header_list[$i])) != 1) { 4882 // ----- Close the zip file 4883 $this->privCloseFd(); 4884 $v_temp_zip->privCloseFd(); 4885 @unlink($v_zip_temp_name); 4886 4887 // ----- Return 4888 return $v_result; 4889 } 4890 4891 // ----- Read/write the data block 4892 if (($v_result = PclZipUtilCopyBlock($this->zip_fd, $v_temp_zip->zip_fd, $v_header_list[$i]['compressed_size'])) != 1) { 4893 // ----- Close the zip file 4894 $this->privCloseFd(); 4895 $v_temp_zip->privCloseFd(); 4896 @unlink($v_zip_temp_name); 4897 4898 // ----- Return 4899 return $v_result; 4900 } 4901 } 4902 4903 // ----- Store the offset of the central dir 4904 $v_offset = @ftell($v_temp_zip->zip_fd); 4905 4906 // ----- Re-Create the Central Dir files header 4907 for ($i=0; $i<sizeof($v_header_list); $i++) { 4908 // ----- Create the file header 4909 if (($v_result = $v_temp_zip->privWriteCentralFileHeader($v_header_list[$i])) != 1) { 4910 $v_temp_zip->privCloseFd(); 4911 $this->privCloseFd(); 4912 @unlink($v_zip_temp_name); 4913 4914 // ----- Return 4915 return $v_result; 4916 } 4917 4918 // ----- Transform the header to a 'usable' info 4919 $v_temp_zip->privConvertHeader2FileInfo($v_header_list[$i], $p_result_list[$i]); 4920 } 4921 4922 4923 // ----- Zip file comment 4924 $v_comment = ''; 4925 if (isset($p_options[PCLZIP_OPT_COMMENT])) { 4926 $v_comment = $p_options[PCLZIP_OPT_COMMENT]; 4927 } 4928 4929 // ----- Calculate the size of the central header 4930 $v_size = @ftell($v_temp_zip->zip_fd)-$v_offset; 4931 4932 // ----- Create the central dir footer 4933 if (($v_result = $v_temp_zip->privWriteCentralHeader(sizeof($v_header_list), $v_size, $v_offset, $v_comment)) != 1) { 4934 // ----- Reset the file list 4935 unset($v_header_list); 4936 $v_temp_zip->privCloseFd(); 4937 $this->privCloseFd(); 4938 @unlink($v_zip_temp_name); 4939 4940 // ----- Return 4941 return $v_result; 4942 } 4943 4944 // ----- Close 4945 $v_temp_zip->privCloseFd(); 4946 $this->privCloseFd(); 4947 4948 // ----- Delete the zip file 4949 // TBC : I should test the result ... 4950 @unlink($this->zipname); 4951 4952 // ----- Rename the temporary file 4953 // TBC : I should test the result ... 4954 //@rename($v_zip_temp_name, $this->zipname); 4955 PclZipUtilRename($v_zip_temp_name, $this->zipname); 4956 4957 // ----- Destroy the temporary archive 4958 unset($v_temp_zip); 4959 } 4960 4961 // ----- Remove every files : reset the file 4962 else if ($v_central_dir['entries'] != 0) { 4963 $this->privCloseFd(); 4964 4965 if (($v_result = $this->privOpenFd('wb')) != 1) { 4966 return $v_result; 4967 } 4968 4969 if (($v_result = $this->privWriteCentralHeader(0, 0, 0, '')) != 1) { 4970 return $v_result; 4971 } 4972 4973 $this->privCloseFd(); 4974 } 4975 4976 // ----- Return 4977 return $v_result; 4978 } 4979 // -------------------------------------------------------------------------------- 4980 4981 // -------------------------------------------------------------------------------- 4982 // Function : privDirCheck() 4983 // Description : 4984 // Check if a directory exists, if not it creates it and all the parents directory 4985 // which may be useful. 4986 // Parameters : 4987 // $p_dir : Directory path to check. 4988 // Return Values : 4989 // 1 : OK 4990 // -1 : Unable to create directory 4991 // -------------------------------------------------------------------------------- 4992 function privDirCheck($p_dir, $p_is_dir=false) 4993 { 4994 $v_result = 1; 4995 4996 4997 // ----- Remove the final '/' 4998 if (($p_is_dir) && (substr($p_dir, -1)=='/')) 4999 { 5000 $p_dir = substr($p_dir, 0, strlen($p_dir)-1); 5001 } 5002 5003 // ----- Check the directory availability 5004 if ((is_dir($p_dir)) || ($p_dir == "")) 5005 { 5006 return 1; 5007 } 5008 5009 // ----- Extract parent directory 5010 $p_parent_dir = dirname($p_dir); 5011 5012 // ----- Just a check 5013 if ($p_parent_dir != $p_dir) 5014 { 5015 // ----- Look for parent directory 5016 if ($p_parent_dir != "") 5017 { 5018 if (($v_result = $this->privDirCheck($p_parent_dir)) != 1) 5019 { 5020 return $v_result; 5021 } 5022 } 5023 } 5024 5025 // ----- Create the directory 5026 if (!@mkdir($p_dir, 0777)) 5027 { 5028 // ----- Error log 5029 PclZip::privErrorLog(PCLZIP_ERR_DIR_CREATE_FAIL, "Unable to create directory '$p_dir'"); 5030 5031 // ----- Return 5032 return PclZip::errorCode(); 5033 } 5034 5035 // ----- Return 5036 return $v_result; 5037 } 5038 // -------------------------------------------------------------------------------- 5039 5040 // -------------------------------------------------------------------------------- 5041 // Function : privMerge() 5042 // Description : 5043 // If $p_archive_to_add does not exist, the function exit with a success result. 5044 // Parameters : 5045 // Return Values : 5046 // -------------------------------------------------------------------------------- 5047 function privMerge(&$p_archive_to_add) 5048 { 5049 $v_result=1; 5050 5051 // ----- Look if the archive_to_add exists 5052 if (!is_file($p_archive_to_add->zipname)) 5053 { 5054 5055 // ----- Nothing to merge, so merge is a success 5056 $v_result = 1; 5057 5058 // ----- Return 5059 return $v_result; 5060 } 5061 5062 // ----- Look if the archive exists 5063 if (!is_file($this->zipname)) 5064 { 5065 5066 // ----- Do a duplicate 5067 $v_result = $this->privDuplicate($p_archive_to_add->zipname); 5068 5069 // ----- Return 5070 return $v_result; 5071 } 5072 5073 // ----- Open the zip file 5074 if (($v_result=$this->privOpenFd('rb')) != 1) 5075 { 5076 // ----- Return 5077 return $v_result; 5078 } 5079 5080 // ----- Read the central directory informations 5081 $v_central_dir = array(); 5082 if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) 5083 { 5084 $this->privCloseFd(); 5085 return $v_result; 5086 } 5087 5088 // ----- Go to beginning of File 5089 @rewind($this->zip_fd); 5090 5091 // ----- Open the archive_to_add file 5092 if (($v_result=$p_archive_to_add->privOpenFd('rb')) != 1) 5093 { 5094 $this->privCloseFd(); 5095 5096 // ----- Return 5097 return $v_result; 5098 } 5099 5100 // ----- Read the central directory informations 5101 $v_central_dir_to_add = array(); 5102 if (($v_result = $p_archive_to_add->privReadEndCentralDir($v_central_dir_to_add)) != 1) 5103 { 5104 $this->privCloseFd(); 5105 $p_archive_to_add->privCloseFd(); 5106 5107 return $v_result; 5108 } 5109 5110 // ----- Go to beginning of File 5111 @rewind($p_archive_to_add->zip_fd); 5112 5113 // ----- Creates a temporay file 5114 $v_zip_temp_name = PCLZIP_TEMPORARY_DIR.uniqid('pclzip-').'.tmp'; 5115 5116 // ----- Open the temporary file in write mode 5117 if (($v_zip_temp_fd = @fopen($v_zip_temp_name, 'wb')) == 0) 5118 { 5119 $this->privCloseFd(); 5120 $p_archive_to_add->privCloseFd(); 5121 5122 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \''.$v_zip_temp_name.'\' in binary write mode'); 5123 5124 // ----- Return 5125 return PclZip::errorCode(); 5126 } 5127 5128 // ----- Copy the files from the archive to the temporary file 5129 // TBC : Here I should better append the file and go back to erase the central dir 5130 $v_size = $v_central_dir['offset']; 5131 while ($v_size != 0) 5132 { 5133 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 5134 $v_buffer = fread($this->zip_fd, $v_read_size); 5135 @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size); 5136 $v_size -= $v_read_size; 5137 } 5138 5139 // ----- Copy the files from the archive_to_add into the temporary file 5140 $v_size = $v_central_dir_to_add['offset']; 5141 while ($v_size != 0) 5142 { 5143 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 5144 $v_buffer = fread($p_archive_to_add->zip_fd, $v_read_size); 5145 @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size); 5146 $v_size -= $v_read_size; 5147 } 5148 5149 // ----- Store the offset of the central dir 5150 $v_offset = @ftell($v_zip_temp_fd); 5151 5152 // ----- Copy the block of file headers from the old archive 5153 $v_size = $v_central_dir['size']; 5154 while ($v_size != 0) 5155 { 5156 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 5157 $v_buffer = @fread($this->zip_fd, $v_read_size); 5158 @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size); 5159 $v_size -= $v_read_size; 5160 } 5161 5162 // ----- Copy the block of file headers from the archive_to_add 5163 $v_size = $v_central_dir_to_add['size']; 5164 while ($v_size != 0) 5165 { 5166 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 5167 $v_buffer = @fread($p_archive_to_add->zip_fd, $v_read_size); 5168 @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size); 5169 $v_size -= $v_read_size; 5170 } 5171 5172 // ----- Merge the file comments 5173 $v_comment = $v_central_dir['comment'].' '.$v_central_dir_to_add['comment']; 5174 5175 // ----- Calculate the size of the (new) central header 5176 $v_size = @ftell($v_zip_temp_fd)-$v_offset; 5177 5178 // ----- Swap the file descriptor 5179 // Here is a trick : I swap the temporary fd with the zip fd, in order to use 5180 // the following methods on the temporary fil and not the real archive fd 5181 $v_swap = $this->zip_fd; 5182 $this->zip_fd = $v_zip_temp_fd; 5183 $v_zip_temp_fd = $v_swap; 5184 5185 // ----- Create the central dir footer 5186 if (($v_result = $this->privWriteCentralHeader($v_central_dir['entries']+$v_central_dir_to_add['entries'], $v_size, $v_offset, $v_comment)) != 1) 5187 { 5188 $this->privCloseFd(); 5189 $p_archive_to_add->privCloseFd(); 5190 @fclose($v_zip_temp_fd); 5191 $this->zip_fd = null; 5192 5193 // ----- Reset the file list 5194 unset($v_header_list); 5195 5196 // ----- Return 5197 return $v_result; 5198 } 5199 5200 // ----- Swap back the file descriptor 5201 $v_swap = $this->zip_fd; 5202 $this->zip_fd = $v_zip_temp_fd; 5203 $v_zip_temp_fd = $v_swap; 5204 5205 // ----- Close 5206 $this->privCloseFd(); 5207 $p_archive_to_add->privCloseFd(); 5208 5209 // ----- Close the temporary file 5210 @fclose($v_zip_temp_fd); 5211 5212 // ----- Delete the zip file 5213 // TBC : I should test the result ... 5214 @unlink($this->zipname); 5215 5216 // ----- Rename the temporary file 5217 // TBC : I should test the result ... 5218 //@rename($v_zip_temp_name, $this->zipname); 5219 PclZipUtilRename($v_zip_temp_name, $this->zipname); 5220 5221 // ----- Return 5222 return $v_result; 5223 } 5224 // -------------------------------------------------------------------------------- 5225 5226 // -------------------------------------------------------------------------------- 5227 // Function : privDuplicate() 5228 // Description : 5229 // Parameters : 5230 // Return Values : 5231 // -------------------------------------------------------------------------------- 5232 function privDuplicate($p_archive_filename) 5233 { 5234 $v_result=1; 5235 5236 // ----- Look if the $p_archive_filename exists 5237 if (!is_file($p_archive_filename)) 5238 { 5239 5240 // ----- Nothing to duplicate, so duplicate is a success. 5241 $v_result = 1; 5242 5243 // ----- Return 5244 return $v_result; 5245 } 5246 5247 // ----- Open the zip file 5248 if (($v_result=$this->privOpenFd('wb')) != 1) 5249 { 5250 // ----- Return 5251 return $v_result; 5252 } 5253 5254 // ----- Open the temporary file in write mode 5255 if (($v_zip_temp_fd = @fopen($p_archive_filename, 'rb')) == 0) 5256 { 5257 $this->privCloseFd(); 5258 5259 PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive file \''.$p_archive_filename.'\' in binary write mode'); 5260 5261 // ----- Return 5262 return PclZip::errorCode(); 5263 } 5264 5265 // ----- Copy the files from the archive to the temporary file 5266 // TBC : Here I should better append the file and go back to erase the central dir 5267 $v_size = filesize($p_archive_filename); 5268 while ($v_size != 0) 5269 { 5270 $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE); 5271 $v_buffer = fread($v_zip_temp_fd, $v_read_size); 5272 @fwrite($this->zip_fd, $v_buffer, $v_read_size); 5273 $v_size -= $v_read_size; 5274 } 5275 5276 // ----- Close 5277 $this->privCloseFd(); 5278 5279 // ----- Close the temporary file 5280 @fclose($v_zip_temp_fd); 5281 5282 // ----- Return 5283 return $v_result; 5284 } 5285 // -------------------------------------------------------------------------------- 5286 5287 // -------------------------------------------------------------------------------- 5288 // Function : privErrorLog() 5289 // Description : 5290 // Parameters : 5291 // -------------------------------------------------------------------------------- 5292 function privErrorLog($p_error_code=0, $p_error_string='') 5293 { 5294 if (PCLZIP_ERROR_EXTERNAL == 1) { 5295 PclError($p_error_code, $p_error_string); 5296 } 5297 else { 5298 $this->error_code = $p_error_code; 5299 $this->error_string = $p_error_string; 5300 } 5301 } 5302 // -------------------------------------------------------------------------------- 5303 5304 // -------------------------------------------------------------------------------- 5305 // Function : privErrorReset() 5306 // Description : 5307 // Parameters : 5308 // -------------------------------------------------------------------------------- 5309 function privErrorReset() 5310 { 5311 if (PCLZIP_ERROR_EXTERNAL == 1) { 5312 PclErrorReset(); 5313 } 5314 else { 5315 $this->error_code = 0; 5316 $this->error_string = ''; 5317 } 5318 } 5319 // -------------------------------------------------------------------------------- 5320 5321 // -------------------------------------------------------------------------------- 5322 // Function : privDisableMagicQuotes() 5323 // Description : 5324 // Parameters : 5325 // Return Values : 5326 // -------------------------------------------------------------------------------- 5327 function privDisableMagicQuotes() 5328 { 5329 $v_result=1; 5330 5331 // ----- Look if function exists 5332 if ( (!function_exists("get_magic_quotes_runtime")) 5333 || (!function_exists("set_magic_quotes_runtime"))) { 5334 return $v_result; 5335 } 5336 5337 // ----- Look if already done 5338 if ($this->magic_quotes_status != -1) { 5339 return $v_result; 5340 } 5341 5342 // ----- Get and memorize the magic_quote value 5343 $this->magic_quotes_status = @get_magic_quotes_runtime(); 5344 5345 // ----- Disable magic_quotes 5346 if ($this->magic_quotes_status == 1) { 5347 @set_magic_quotes_runtime(0); 5348 } 5349 5350 // ----- Return 5351 return $v_result; 5352 } 5353 // -------------------------------------------------------------------------------- 5354 5355 // -------------------------------------------------------------------------------- 5356 // Function : privSwapBackMagicQuotes() 5357 // Description : 5358 // Parameters : 5359 // Return Values : 5360 // -------------------------------------------------------------------------------- 5361 function privSwapBackMagicQuotes() 5362 { 5363 $v_result=1; 5364 5365 // ----- Look if function exists 5366 if ( (!function_exists("get_magic_quotes_runtime")) 5367 || (!function_exists("set_magic_quotes_runtime"))) { 5368 return $v_result; 5369 } 5370 5371 // ----- Look if something to do 5372 if ($this->magic_quotes_status != -1) { 5373 return $v_result; 5374 } 5375 5376 // ----- Swap back magic_quotes 5377 if ($this->magic_quotes_status == 1) { 5378 @set_magic_quotes_runtime($this->magic_quotes_status); 5379 } 5380 5381 // ----- Return 5382 return $v_result; 5383 } 5384 // -------------------------------------------------------------------------------- 5385 5386 } 5387 // End of class 5388 // -------------------------------------------------------------------------------- 5389 5390 // -------------------------------------------------------------------------------- 5391 // Function : PclZipUtilPathReduction() 5392 // Description : 5393 // Parameters : 5394 // Return Values : 5395 // -------------------------------------------------------------------------------- 5396 function PclZipUtilPathReduction($p_dir) 5397 { 5398 $v_result = ""; 5399 5400 // ----- Look for not empty path 5401 if ($p_dir != "") { 5402 // ----- Explode path by directory names 5403 $v_list = explode("/", $p_dir); 5404 5405 // ----- Study directories from last to first 5406 $v_skip = 0; 5407 for ($i=sizeof($v_list)-1; $i>=0; $i--) { 5408 // ----- Look for current path 5409 if ($v_list[$i] == ".") { 5410 // ----- Ignore this directory 5411 // Should be the first $i=0, but no check is done 5412 } 5413 else if ($v_list[$i] == "..") { 5414 $v_skip++; 5415 } 5416 else if ($v_list[$i] == "") { 5417 // ----- First '/' i.e. root slash 5418 if ($i == 0) { 5419 $v_result = "/".$v_result; 5420 if ($v_skip > 0) { 5421 // ----- It is an invalid path, so the path is not modified 5422 // TBC 5423 $v_result = $p_dir; 5424 $v_skip = 0; 5425 } 5426 } 5427 // ----- Last '/' i.e. indicates a directory 5428 else if ($i == (sizeof($v_list)-1)) { 5429 $v_result = $v_list[$i]; 5430 } 5431 // ----- Double '/' inside the path 5432 else { 5433 // ----- Ignore only the double '//' in path, 5434 // but not the first and last '/' 5435 } 5436 } 5437 else { 5438 // ----- Look for item to skip 5439 if ($v_skip > 0) { 5440 $v_skip--; 5441 } 5442 else { 5443 $v_result = $v_list[$i].($i!=(sizeof($v_list)-1)?"/".$v_result:""); 5444 } 5445 } 5446 } 5447 5448 // ----- Look for skip 5449 if ($v_skip > 0) { 5450 while ($v_skip > 0) { 5451 $v_result = '../'.$v_result; 5452 $v_skip--; 5453 } 5454 } 5455 } 5456 5457 // ----- Return 5458 return $v_result; 5459 } 5460 // -------------------------------------------------------------------------------- 5461 5462 // -------------------------------------------------------------------------------- 5463 // Function : PclZipUtilPathInclusion() 5464 // Description : 5465 // This function indicates if the path $p_path is under the $p_dir tree. Or, 5466 // said in an other way, if the file or sub-dir $p_path is inside the dir 5467 // $p_dir. 5468 // The function indicates also if the path is exactly the same as the dir. 5469 // This function supports path with duplicated '/' like '//', but does not 5470 // support '.' or '..' statements. 5471 // Parameters : 5472 // Return Values : 5473 // 0 if $p_path is not inside directory $p_dir 5474 // 1 if $p_path is inside directory $p_dir 5475 // 2 if $p_path is exactly the same as $p_dir 5476 // -------------------------------------------------------------------------------- 5477 function PclZipUtilPathInclusion($p_dir, $p_path) 5478 { 5479 $v_result = 1; 5480 5481 // ----- Look for path beginning by ./ 5482 if ( ($p_dir == '.') 5483 || ((strlen($p_dir) >=2) && (substr($p_dir, 0, 2) == './'))) { 5484 $p_dir = PclZipUtilTranslateWinPath(getcwd(), FALSE).'/'.substr($p_dir, 1); 5485 } 5486 if ( ($p_path == '.') 5487 || ((strlen($p_path) >=2) && (substr($p_path, 0, 2) == './'))) { 5488 $p_path = PclZipUtilTranslateWinPath(getcwd(), FALSE).'/'.substr($p_path, 1); 5489 } 5490 5491 // ----- Explode dir and path by directory separator 5492 $v_list_dir = explode("/", $p_dir); 5493 $v_list_dir_size = sizeof($v_list_dir); 5494 $v_list_path = explode("/", $p_path); 5495 $v_list_path_size = sizeof($v_list_path); 5496 5497 // ----- Study directories paths 5498 $i = 0; 5499 $j = 0; 5500 while (($i < $v_list_dir_size) && ($j < $v_list_path_size) && ($v_result)) { 5501 5502 // ----- Look for empty dir (path reduction) 5503 if ($v_list_dir[$i] == '') { 5504 $i++; 5505 continue; 5506 } 5507 if ($v_list_path[$j] == '') { 5508 $j++; 5509 continue; 5510 } 5511 5512 // ----- Compare the items 5513 if (($v_list_dir[$i] != $v_list_path[$j]) && ($v_list_dir[$i] != '') && ( $v_list_path[$j] != '')) { 5514 $v_result = 0; 5515 } 5516 5517 // ----- Next items 5518 $i++; 5519 $j++; 5520 } 5521 5522 // ----- Look if everything seems to be the same 5523 if ($v_result) { 5524 // ----- Skip all the empty items 5525 while (($j < $v_list_path_size) && ($v_list_path[$j] == '')) $j++; 5526 while (($i < $v_list_dir_size) && ($v_list_dir[$i] == '')) $i++; 5527 5528 if (($i >= $v_list_dir_size) && ($j >= $v_list_path_size)) { 5529 // ----- There are exactly the same 5530 $v_result = 2; 5531 } 5532 else if ($i < $v_list_dir_size) { 5533 // ----- The path is shorter than the dir 5534 $v_result = 0; 5535 } 5536 } 5537 5538 // ----- Return 5539 return $v_result; 5540 } 5541 // -------------------------------------------------------------------------------- 5542 5543 // -------------------------------------------------------------------------------- 5544 // Function : PclZipUtilCopyBlock() 5545 // Description : 5546 // Parameters : 5547 // $p_mode : read/write compression mode 5548 // 0 : src & dest normal 5549 // 1 : src gzip, dest normal 5550 // 2 : src normal, dest gzip 5551 // 3 : src & dest gzip 5552 // Return Values : 5553 // -------------------------------------------------------------------------------- 5554 function PclZipUtilCopyBlock($p_src, $p_dest, $p_size, $p_mode=0) 5555 { 5556 $v_result = 1; 5557 5558 if ($p_mode==0) 5559 { 5560 while ($p_size != 0) 5561 { 5562 $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE); 5563 $v_buffer = @fread($p_src, $v_read_size); 5564 @fwrite($p_dest, $v_buffer, $v_read_size); 5565 $p_size -= $v_read_size; 5566 } 5567 } 5568 else if ($p_mode==1) 5569 { 5570 while ($p_size != 0) 5571 { 5572 $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE); 5573 $v_buffer = @gzread($p_src, $v_read_size); 5574 @fwrite($p_dest, $v_buffer, $v_read_size); 5575 $p_size -= $v_read_size; 5576 } 5577 } 5578 else if ($p_mode==2) 5579 { 5580 while ($p_size != 0) 5581 { 5582 $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE); 5583 $v_buffer = @fread($p_src, $v_read_size); 5584 @gzwrite($p_dest, $v_buffer, $v_read_size); 5585 $p_size -= $v_read_size; 5586 } 5587 } 5588 else if ($p_mode==3) 5589 { 5590 while ($p_size != 0) 5591 { 5592 $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE); 5593 $v_buffer = @gzread($p_src, $v_read_size); 5594 @gzwrite($p_dest, $v_buffer, $v_read_size); 5595 $p_size -= $v_read_size; 5596 } 5597 } 5598 5599 // ----- Return 5600 return $v_result; 5601 } 5602 // -------------------------------------------------------------------------------- 5603 5604 // -------------------------------------------------------------------------------- 5605 // Function : PclZipUtilRename() 5606 // Description : 5607 // This function tries to do a simple rename() function. If it fails, it 5608 // tries to copy the $p_src file in a new $p_dest file and then unlink the 5609 // first one. 5610 // Parameters : 5611 // $p_src : Old filename 5612 // $p_dest : New filename 5613 // Return Values : 5614 // 1 on success, 0 on failure. 5615 // -------------------------------------------------------------------------------- 5616 function PclZipUtilRename($p_src, $p_dest) 5617 { 5618 $v_result = 1; 5619 5620 // ----- Try to rename the files 5621 if (!@rename($p_src, $p_dest)) { 5622 5623 // ----- Try to copy & unlink the src 5624 if (!@copy($p_src, $p_dest)) { 5625 $v_result = 0; 5626 } 5627 else if (!@unlink($p_src)) { 5628 $v_result = 0; 5629 } 5630 } 5631 5632 // ----- Return 5633 return $v_result; 5634 } 5635 // -------------------------------------------------------------------------------- 5636 5637 // -------------------------------------------------------------------------------- 5638 // Function : PclZipUtilOptionText() 5639 // Description : 5640 // Translate option value in text. Mainly for debug purpose. 5641 // Parameters : 5642 // $p_option : the option value. 5643 // Return Values : 5644 // The option text value. 5645 // -------------------------------------------------------------------------------- 5646 function PclZipUtilOptionText($p_option) 5647 { 5648 5649 $v_list = get_defined_constants(); 5650 for (reset($v_list); $v_key = key($v_list); next($v_list)) { 5651 $v_prefix = substr($v_key, 0, 10); 5652 if (( ($v_prefix == 'PCLZIP_OPT') 5653 || ($v_prefix == 'PCLZIP_CB_') 5654 || ($v_prefix == 'PCLZIP_ATT')) 5655 && ($v_list[$v_key] == $p_option)) { 5656 return $v_key; 5657 } 5658 } 5659 5660 $v_result = 'Unknown'; 5661 5662 return $v_result; 5663 } 5664 // -------------------------------------------------------------------------------- 5665 5666 // -------------------------------------------------------------------------------- 5667 // Function : PclZipUtilTranslateWinPath() 5668 // Description : 5669 // Translate windows path by replacing '\' by '/' and optionally removing 5670 // drive letter. 5671 // Parameters : 5672 // $p_path : path to translate. 5673 // $p_remove_disk_letter : true | false 5674 // Return Values : 5675 // The path translated. 5676 // -------------------------------------------------------------------------------- 5677 function PclZipUtilTranslateWinPath($p_path, $p_remove_disk_letter=true) 5678 { 5679 if (stristr(php_uname(), 'windows')) { 5680 // ----- Look for potential disk letter 5681 if (($p_remove_disk_letter) && (($v_position = strpos($p_path, ':')) != false)) { 5682 $p_path = substr($p_path, $v_position+1); 5683 } 5684 // ----- Change potential windows directory separator 5685 if ((strpos($p_path, '\\') > 0) || (substr($p_path, 0,1) == '\\')) { 5686 $p_path = strtr($p_path, '\\', '/'); 5687 } 5688 } 5689 return $p_path; 5690 } 5691 // -------------------------------------------------------------------------------- 5692 5693 5694 ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Tue Mar 17 22:47:18 2015 | Cross-referenced by PHPXref 0.7.1 |