Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2025-05-25 12:37
📄 central_directory.php <?php /** * File containing the ezcArchiveCentralDirectoryHeader class. * * @package Archive * @version 1.4.1 * @copyright Copyright (C) 2005-2010 eZ Systems AS. All rights reserved. * @license http://ez.no/licenses/new_bsd New BSD License * @access private / /* * The ezcArchiveCentralDirectoryHeader class represents the Zip central directory header. * * ezcArchiveCentralDirectoryHeader can read the header from an ezcArchiveCharacterFile or ezcArchiveEntry. * * The values from the headers are directly accessible via the class properties, and allows * reading and writing to specific header values. * * The entire header can be appended to an ezcArchiveCharacterFile again or written to an ezcArchiveFileStructure. * Information may get lost, though. * * The central directory format[1]: * * <pre> * [file header 1] * . * . * . * [file header n] * [digital signature] <-- Optional, TODO: check if implemented. * </pre> * * The Central Directory Header has the following structure: * * <pre> * + ---+---------+------------+------------------------+------------------------------------+ * \| ID \| Offset \| Field size \| Property \| Description \| * +----+---------+------------+------------------------+------------------------------------+ * \| \| 0 \| 4 \| - \| Central directory header signature \| * \| \| 4 \| 2 \| versionMadeBy \| Version made by \| * \| \| 6 \| 2 \| versionNeededToExtract \| Version needed to extract \| * \| \| 8 \| 2 \| bitFlag \| General purpose bit flag \| * \| \| 10 \| 2 \| compressionMethod \| Compression method \| * \| \| 12 \| 2 \| lastModFileTime \| Last modification file time \| * \| \| 14 \| 2 \| lastModFileDate \| Last modification file date \| * \| \| 16 \| 4 \| crc \| crc-32 \| * \| \| 20 \| 4 \| compressedSize \| compressed size \| * \| \| 24 \| 4 \| uncompressedSize \| uncompressed size \| * \| X: \| 26 \| 2 \| fileNameLength \| file name length \| * \| Y: \| 28 \| 2 \| extraFieldLength \| extra field length \| * \| Z: \| 30 \| 2 \| fileCommentLength \| file comment length \| * \| \| 32 \| 2 \| diskNumberStart \| disk number start \| * \| \| 34 \| 2 \| internalFileAttributes \| internal file attributes \| * \| \| 38 \| 4 \| externalFileAttributes \| external file attributes \| * \| \| 42 \| 4 \| relativeHeaderOffset \| relative offset of local header \| * \| \| 46 \| X \| fileName \| file name \| * \| \| 46+X \| Y \| - \| extra field \| * \| \| 46+X+Y \| Z \| comment \| file comment \| * +----+---------+------------+------------------------+------------------------------------+ * </pre> * * The columns of the table are: * - ID gives a label to a specific field or row in the table. * - Offset describes the start position of a header field. * - Field size describes the size of the field in bytes. * - Property is the name of the property that will be set by the header field. * - Description explains what this field describes. * * The central directory signature cannot be changed and is set in the constant {@link self::magic}. * * The extra fields that are implemented and references to extra documentation can be found in * the {@link ezcArchivelocalFileHeader}. * * @package Archive * @version 1.4.1 * @access private / class ezcArchiveCentralDirectoryHeader extends ezcArchiveLocalFileHeader { /* * Defines the signature of this header. / const magic = 0x02014b50; /* * Creates and initializes a new header. * * If the ezcArchiveCharacterFile $file is null then the header will be empty. * When an ezcArchiveCharacterFile is given, the file position should be directly after the * signature of the header. This header will be read from the file and initialized in this class. * * @param ezcArchiveCharacterFile $file / public function __construct( ezcArchiveCharacterFile $file = null ) { if ( !is_null( $file ) ) { $this->properties = unpack ( "vversionMadeBy/". "vversionNeededToExtract/". "vbitFlag/". "vcompressionMethod/". "vlastModFileTime/". "vlastModFileDate/". "Vcrc/". "VcompressedSize/". "VuncompressedSize/". "vfileNameLength/". "vextraFieldLength/". "vfileCommentLength/". "vdiskNumberStart/". "vinternalFileAttributes/". "VexternalFileAttributes/". "VrelativeHeaderOffset", $file->read( 42 ) ); $this->properties["fileName"] = $file->read( $this->properties["fileNameLength"] ); $extraField = $file->read( $this->properties["extraFieldLength"] ); // FIXME, extra fields. $this->properties["comment"] = $file->read( $this->properties["fileCommentLength"] ); // Append extra field information. $this->setExtraFieldData( $extraField ); } else { // Some default values: $this->properties["versionMadeBy"] = 791; $this->properties["versionNeededToExtract"] = 10; $this->properties["diskNumberStart"] = 0; $this->setComment( "" ); } } /* * Sets the property $name to $value. * * @throws ezcBasePropertyNotFoundException if the property does not exist * @throws ezcBasePropertyReadOnlyException if the property is read-only * @param string $name * @param mixed $value * @return void * @ignore / public function __set( $name, $value ) { switch ( $name ) { case "versionMadeBy": case "versionNeededToExtract": case "bitFlag": case "compressionMethod": case "lastModFileTime": case "lastModFileDate": case "crc": case "compressedSize": case "uncompressedSize": case "diskNumberStart": case "internalFileAttributes": case "externalFileAttributes": case "fileName": case "relativeHeaderOffset": $this->properties[$name] = $value; break; case "comment": $this->setComment( $value ); break; case "fileNameLength": case "extraFieldLength": case "fileCommentLength": throw new ezcBasePropertyReadOnlyException( $name ); default: throw new ezcBasePropertyNotFoundException( $name ); } } /* * Returns the value of the property $name. * * @throws ezcBasePropertyNotFoundException if the property does not exist. * @param string $name * @return mixed * @ignore / public function __get( $name ) { switch ( $name ) { case "versionMadeBy": case "versionNeededToExtract": case "bitFlag": case "compressionMethod": case "lastModFileTime": case "lastModFileDate": case "crc": case "compressedSize": case "uncompressedSize": case "diskNumberStart": case "internalFileAttributes": case "externalFileAttributes": case "relativeHeaderOffset": case "fileNameLength": case "extraFieldLength": case "fileCommentLength": case "fileName": case "comment": return $this->properties[$name]; default: throw new ezcBasePropertyNotFoundException( $name ); } } /* * Sets the comment to string $comment and updates the comment length. * * @param string $comment * @return void / public function setComment( $comment ) { $this->properties["comment"] = $comment; $this->properties["fileCommentLength"] = strlen( $comment ); } /* * Sets the type to int $type. * * The type is a constant from the {@link ezcArchiveEntry}. For example: * ezcArchiveEntry::IS_FIFO. * The property externalFileAttributes will be changed to reflect the $type. * * @throws ezcArchiveException * if $type is unknown * @param int $type * @return void / public function setType( $type ) { $ext = 0; switch ( $type ) { case ezcArchiveEntry::IS_FIFO: $ext = ezcArchiveStatMode::S_IFIFO; break; case ezcArchiveEntry::IS_CHARACTER_DEVICE: $ext = ezcArchiveStatMode::S_IFCHR; break; case ezcArchiveEntry::IS_DIRECTORY: $ext = ezcArchiveStatMode::S_IFDIR; break; case ezcArchiveEntry::IS_BLOCK_DEVICE: $ext = ezcArchiveStatMode::S_IFBLK; break; case ezcArchiveEntry::IS_FILE: $ext = ezcArchiveStatMode::S_IFREG; break; case ezcArchiveEntry::IS_SYMBOLIC_LINK: $ext = ezcArchiveStatMode::S_IFLNK; break; default: throw new ezcArchiveException( "Unknown type" ); } if ( !isset( $this->properties["externalFileAttributes"] ) ) { $this->properties["externalFileAttributes"] = 0; } $ext <<= 16; $clear = ( $this->properties["externalFileAttributes"] & ezcArchiveStatMode::S_IFMT << 16 ); $this->properties["externalFileAttributes"] ^= $clear; // Remove the bits from S_IFMT, because we XOR with self. $this->properties["externalFileAttributes"] \|= $ext; // And add the ext bits. } /* * Returns the type of the file. * * The type is read and translated from the externalFileAttributes property. * * @return int An ezcArchiveEntry constant. / public function getType() { $extAttrib = ( $this->properties["externalFileAttributes"] >> 16 ); switch ( $extAttrib & ezcArchiveStatMode::S_IFMT ) { case ezcArchiveStatMode::S_IFIFO: return ezcArchiveEntry::IS_FIFO; case ezcArchiveStatMode::S_IFCHR: return ezcArchiveEntry::IS_CHARACTER_DEVICE; case ezcArchiveStatMode::S_IFDIR: return ezcArchiveEntry::IS_DIRECTORY; case ezcArchiveStatMode::S_IFBLK: return ezcArchiveEntry::IS_BLOCK_DEVICE; case ezcArchiveStatMode::S_IFREG: return ezcArchiveEntry::IS_FILE; case ezcArchiveStatMode::S_IFLNK: return ezcArchiveEntry::IS_SYMBOLIC_LINK; default: if ( substr( $this->properties["fileName"], -1 ) == "/" ) { return ezcArchiveEntry::IS_DIRECTORY; } else { return ezcArchiveEntry::IS_FILE; } } } /* * Returns the permissions (as a decimal number) of the file. * * The type is read and translated from the externalFileAttributes property. * * @return int / public function getPermissions() { $extAttrib = ( $this->properties["externalFileAttributes"] >> 16 ); return decoct( $extAttrib & ezcArchiveStatMode::S_PERM_MASK ); } /* * Sets the permissions (as a decimal number) of the file to int $permissions. * * The $permissions expects an decimal number. * * The externalFileAttributes property will be changed. * * @param int $permissions / public function setPermissions( $permissions ) { $perm = octdec( $permissions ); $perm <<= 16; if ( !isset( $this->properties["externalFileAttributes"] ) ) { $this->properties["externalFileAttributes"] = 0; } $clear = ( $this->properties["externalFileAttributes"] & ezcArchiveStatMode::S_PERM_MASK << 16 ); $this->properties["externalFileAttributes"] ^= $clear; // Remove the bits from S_PERM_MASK, because we XOR with self. $this->properties["externalFileAttributes"] \|= $perm; // And add the perm bits. } /* * Updates the given ezcArchiveFileStructure $struct with the values from this header. * * If bool $override is false, this method will not overwrite the values from the ezcArchiveFileStructure $struct. * The values that can be set in the archiveFileStructure are: path, mode, type, size. * * @param ezcArchiveFileStructure &$struct * @param bool $override * @return void / public function setArchiveFileStructure( ezcArchiveFileStructure &$struct, $override = false ) { if ( !isset( $struct->path ) \|\| $override ) { $struct->path = $this->fileName; } if ( !isset( $struct->mode ) \|\| $override ) { $struct->mode = ( $this->getPermissions() == 0 ? false : $this->getPermissions() ); } if ( !isset( $struct->type ) \|\| $override ) { $struct->type = $this->getType(); } if ( !isset( $struct->size ) \|\| $override ) { $struct->size = $this->uncompressedSize; } } /* * Returns the total size of this header. * * @return int / public function getHeaderSize() { return 46 + $this->properties["fileNameLength"] + $this->properties["extraFieldLength"] + $this->properties["fileCommentLength"]; } /* * Sets this header with the values from the {@link ezcArchiveLocalFileHeader}. * * The properties that are set: versionNeededToExtract, bitFlag, compressionMethod, * lastModFileTime, lastModFileDate, crc, compressedSize, uncompressedSize, fileNameLength, * and fileName. * * @param ezcArchiveLocalFileHeader $localFileHeader * @return void / public function setHeaderFromLocalFileHeader( ezcArchiveLocalFileHeader $localFileHeader ) { $this->properties["versionNeededToExtract"] = $localFileHeader->version; $this->properties["bitFlag"] = $localFileHeader->bitFlag; $this->properties["compressionMethod"] = $localFileHeader->compressionMethod; $this->properties["lastModFileTime"] = $localFileHeader->lastModFileTime; $this->properties["lastModFileDate"] = $localFileHeader->lastModFileDate; $this->properties["crc"] = $localFileHeader->crc; $this->properties["compressedSize"] = $localFileHeader->compressedSize; $this->properties["uncompressedSize"] = $localFileHeader->uncompressedSize; $this->properties["fileNameLength"] = $localFileHeader->fileNameLength; $this->properties["fileName"] = $localFileHeader->fileName; } /* * Sets this header with the values from the ezcArchiveEntry $entry. * * The values that are possible to set from the ezcArchiveEntry $entry are set in this header. * The properties that change are: internalFileAttributes, relativeHeaderOffset, type, and mtime. * * @param ezcArchiveEntry $entry * @return void / public function setHeaderFromArchiveEntry( ezcArchiveEntry $entry ) { $this->properties["internalFileAttributes"] = 0; $this->setType( $entry->getType() ); $this->setPermissions( $entry->getPermissions() ); $this->properties["relativeHeaderOffset"] = 0; $this->properties["mtime"] = $entry->getModificationTime(); } /* * Serializes this header and appends it to the given ezcArchiveCharacterFile $archiveFile. * * @param ezcArchiveCharacterFile $archiveFile * @return void / public function writeEncodedHeader( $archiveFile ) { $this->properties["extraFieldLength" ] = 13; // 9 + 4. $enc = pack( "VvvvvvvVVVvvvvvVV", self::magic, // V magic number $this->versionMadeBy, // v $this->versionNeededToExtract, // v $this->bitFlag, // v $this->compressionMethod, // v $this->lastModFileTime, // v $this->lastModFileDate, // v $this->crc, // V $this->compressedSize, // V $this->uncompressedSize, // V $this->fileNameLength, // v $this->extraFieldLength, // v extra data. $this->fileCommentLength , // v Comment $this->diskNumberStart , // v disknumber start $this->internalFileAttributes, // v Internal attribute $this->externalFileAttributes, // V external attributes $this->relativeHeaderOffset // V relative header offset? ); $time = pack( "vvcV", self::EF_TIME, 5, 1, $this->mtime ); // fixme atime? $unix2 = pack( "vv", self::EF_IZUNIX2, 0 ); // Add empty unix2 stamp. $archiveFile->write( $enc . $this->fileName . $time . $unix2 . $this->comment ); } /* * Returns true if the given string $string matches with the current signature. * * @param string $string * @return bool */ public static function isSignature( $string ) { return $string == pack( "V", self::magic ); } } ?>	17.84 KB	2024-07-17 10:18
📄 central_directory_end.php <?php /** * File containing the ezcArchiveCentralDirectoryHeader class. * * @package Archive * @version 1.4.1 * @copyright Copyright (C) 2005-2010 eZ Systems AS. All rights reserved. * @license http://ez.no/licenses/new_bsd New BSD License * @access private / /* * The ezcArchiveCentralDirectoryEndHeader class represents the Zip central directory end header. * * ezcArchiveCentralDirectoryEndHeader can read the header from an ezcArchiveCharacterFile. * * The values from the headers are directly accessible via the class properties, and allows * reading and writing to specific header values. * * The entire header can be appended to an ezcArchiveCharacterFile again. * * The central directory end header is the last header of the ZIP archive. Some algorithms * search back to this header in order to find the other headers. The variable comment length * makes it tricky. * * The Central Directory End Header has the following structure: * * <pre> * + ---+---------+------------+------------------------------------+-------------------------------------------------------------------------------+ * \| ID \| Offset \| Field size \| Property \| Description \| * +----+---------+------------+------------------------------------+-------------------------------------------------------------------------------+ * \| \| 0 \| 4 \| - \| Central directory header signature \| * \| \| 4 \| 2 \| diskNumber \| nr of this disk \| * \| \| 6 \| 2 \| centralDirectoryDisk \| number of the disk with the start of the central directory \| * \| \| 8 \| 2 \| totalCentralDirectoryEntriesOnDisk \| total number of entries in the central directory on this disk \| * \| \| 10 \| 2 \| totalCentralDirectoryEntries \| total number of entries in the central directory \| * \| \| 12 \| 4 \| centralDirectorySize \| size of the central directory \| * \| \| 16 \| 4 \| centralDirectoryStart \| offset of start of central directory with respect to the starting disk number \| * \| X: \| 20 \| 2 \| commentLength \| .ZIP file comment length \| * \| \| 22 \| X \| comment \| .ZIP file comment \| * +----+---------+------------+------------------------------------+-------------------------------------------------------------------------------+ * </pre> * * * The columns of the table are: * - ID gives a label to a specific field or row in the table. * - Offset describes the start position of a header field. * - Field size describes the size of the field in bytes. * - Property is the name of the property that will be set by the header field. * - Description explains what this field describes. * * * @package Archive * @version 1.4.1 * @access private / class ezcArchiveCentralDirectoryEndHeader { /* * Defines the signature of this header. / const magic = 0x06054b50; /* * Holds the properties of this class. * * @var array(string=>mixed) / private $properties = array(); /* * Creates and initializes a new header. * * If the ezcArchiveCharacterFile $file is null then the header will be empty. * When an ezcArchiveCharacterFile is given, the file position should be directly after the * signature of the header. This header will be read from the file and initialized in this class. * * @param ezcArchiveCharacterFile $file / public function __construct( ezcArchiveCharacterFile $file = null ) { if ( !is_null( $file ) ) { $this->properties = unpack ( "vdiskNumber/". "vcentralDirectoryDisk/". "vtotalCentralDirectoryEntriesOnDisk/". "vtotalCentralDirectoryEntries/". "VcentralDirectorySize/". "VcentralDirectoryStart/". "vcommentLength", $file->read( 18 ) ); $this->properties["comment"] = $file->read( $this->properties["commentLength"] ); } else { $this->properties["diskNumber"] = 0; $this->properties["centralDirectoryDisk"] = 0; $this->properties["totalCentralDirectoryEntries"] = 0; $this->properties["totalCentralDirectoryEntriesOnDisk"] = 0; $this->properties["totalCentralDirectorySize"] = 0; $this->properties["totalCentralDirectoryStart"] = 0; $this->setComment( "" ); } } /* * Sets the property $name to $value. * * @throws ezcBasePropertyNotFoundException if the property does not exist. * @throws ezcBasePropertyReadOnlyException if the property is read-only * @param string $name * @param mixed $value * @return void * @ignore / public function __set( $name, $value ) { switch ( $name ) { case "diskNumber": case "centralDirectoryDisk": case "totalCentralDirectoryEntriesOnDisk": throw new ezcBasePropertyReadOnlyException( $name ); case "totalCentralDirectoryEntries": $this->setTotalDirectoryEntries( $value ); break; case "centralDirectorySize": case "centralDirectoryStart": $this->properties[$name] = $value; break; case "commentLength": throw new ezcBasePropertyReadOnlyException( $name ); case "comment": $this->setComment( $value ); break; default: throw new ezcBasePropertyNotFoundException( $name ); } } /* * Returns the value of the property $name. * * @throws ezcBasePropertyNotFoundException if the property does not exist. * @param string $name * @return mixed * @ignore / public function __get( $name ) { switch ( $name ) { case "diskNumber": case "centralDirectoryDisk": case "totalCentralDirectoryEntriesOnDisk": case "totalCentralDirectoryEntries": case "centralDirectorySize": case "centralDirectoryStart": case "commentLength": case "comment": return $this->properties[$name]; default: throw new ezcBasePropertyNotFoundException( $name ); } } /* * Sets the comment and comment length in the header from the string $comment. * * @param string $comment * @return void / public function setComment( $comment ) { $this->properties["comment"] = $comment; $this->properties["commentLength"] = strlen( $comment ); } /* * Sets the total directory entries to the int $numberOfEntries. * * The properties: diskNumber and centralDirectory will be set to 0. * The properties: totalCentralDirectoryEntriesOnDisk and totalCentralDirectoryEntries are set to the $numberOfEntries. * * @param int $numberOfEntries * @return void / public function setTotalDirectoryEntries( $numberOfEntries ) { $this->properties["diskNumber"] = 0; $this->properties["centralDirectoryDisk"] = 0; $this->properties["totalCentralDirectoryEntriesOnDisk"] = $numberOfEntries; $this->properties["totalCentralDirectoryEntries"] = $numberOfEntries; } /* * Serializes this header and appends it to the given ezcArchiveCharacterFile $archiveFile. * * @param ezcArchiveCharacterFile $archiveFile * @return void / public function writeEncodedHeader( $archiveFile ) { $enc = pack ( "VvvvvVVv", self::magic, $this->properties["diskNumber"], $this->properties["centralDirectoryDisk"], $this->properties["totalCentralDirectoryEntriesOnDisk"], $this->properties["totalCentralDirectoryEntries"], $this->properties["centralDirectorySize"], $this->properties["centralDirectoryStart"], $this->properties["commentLength"] ); $archiveFile->write( $enc . $this->properties["comment"] ); } /* * Returns true if the given string $string matches with the current signature. * * @param string $string * @return void */ public static function isSignature( $string ) { return $string == pack( "V", self::magic ); } } ?>	8.91 KB	2024-07-17 10:18
📄 local_file.php <?php /** * File containing the ezcArchiveLocalFileHeader class. * * @package Archive * @version 1.4.1 * @copyright Copyright (C) 2005-2010 eZ Systems AS. All rights reserved. * @license http://ez.no/licenses/new_bsd New BSD License * @access private / /* * The ezcArchiveLocalFileHeader class represents the Zip local header. * * ezcArchiveLocalFileHeader can read the header from an ezcArchiveCharacterFile or ezcArchiveEntry. * * The values from the headers are directly accessible via the class properties, and allows * reading and writing to specific header values. * * The entire header can be appended to an ezcArchiveCharacterFile again or written to an ezcArchiveFileStructure. * Information may get lost, though. * * The overall .ZIP file format[1] : * * <pre> * [local file header 1] * [file data 1] * [data descriptor 1] * . * . * [local file header n] * [file data n] * [data descriptor n] * [central directory] * [end of central directory record] * </pre> * * The Local File Header has the following structure: * * <pre> * + ---+--------+------------+-------------------+-------------------------------+ * \| ID \| Offset \| Field size \| Property \| Description \| * +----+--------+------------+-------------------+-------------------------------+ * \| \| 0 \| 4 \| - \| Local file header signature \| * \| \| 4 \| 2 \| version \| Version needed to extract \| * \| \| 6 \| 2 \| bitFlag \| General purpose bit flag \| * \| \| 8 \| 2 \| compressionMethod \| Compression method \| * \| \| 10 \| 2 \| lastModFileTime \| Last modification file time \| * \| \| 12 \| 2 \| lastModFileDate \| Last modification file date \| * \| \| 14 \| 4 \| crc \| crc-32 \| * \| \| 18 \| 4 \| compressedSize \| compressed size \| * \| \| 22 \| 4 \| uncompressedSize \| uncompressed size \| * \| X \| 26 \| 2 \| fileNameLength \| file name length \| * \| Y \| 28 \| 2 \| extraFieldLength \| extra field length \| * \| \| 30 \| X \| fileName \| file name \| * \| \| 30+X \| Y \| - \| extra field \| * +----+--------+------------+-------------------+-------------------------------+ * </pre> * * The columns of the table are: * - ID gives a label to a specific field or row in the table. * - Offset describes the start position of a header field. * - Field size describes the size of the field in bytes. * - Property is the name of the property that will be set by the header field. * - Description explains what this field describes. * * The local file signature cannot be changed and is set in the constant {@link self::magic}. * * The extra fields that are implemented are: * - Info-Zip Unix field (old). * - Info-Zip Unix field (new). * - Universal timestamp. * * Info-Zip Unix field (old): * <pre> * +--------+------------+------------------------------------+ * \| Offset \| Field size \| Description \| * +--------+------------+------------------------------------+ * \| 0 \| 2 \| Header ID (0x5855) \| * \| 2 \| 2 \| Data size: Full size = 12 \| * \| 4 \| 4 \| Last Access Time \| * \| 8 \| 4 \| Last Modification Time \| * \| 12 \| 2 \| User ID (Optional if size < 12 ) \| * \| 14 \| 2 \| Group ID (Optional if size < 12 ) \| * +--------+------------+------------------------------------+ * </pre> * * Info-Zip Unix field (new): * <pre> * +--------+------------+--------------------+ * \| Offset \| Field size \| Description \| * +--------+------------+--------------------+ * \| 0 \| 2 \| Header ID (0x7855) \| * \| 2 \| 2 \| Data size. \| * \| 4 \| 2 \| User ID \| * \| 6 \| 2 \| Group ID \| * +--------+------------+--------------------+ * </pre> * * Universal timestamp: * <pre> * +--------+------------+-------------------------+ * \| Offset \| Field size \| Description \| * +--------+------------+-------------------------+ * \| 0 \| 2 \| Header ID (0x5455) \| * \| 2 \| 2 \| Data size. \| * \| 4 \| 1 \| Info bits (flags) \| * \| 5 \| 4 \| Last Modification Time \| * \| 9 \| 4 \| Last Access Time \| * \| 13 \| 4 \| Creation Time \| * +--------+------------+-------------------------+ * </pre> * * Info bits indicate which fields are set: * - bit 0, if set then the modification time is present. * - bit 1, if set then the access time is present. * - bit 2, if set then the creation time is present. * * These info bits are ONLY valid for the local file header. The * central header has the same Universal Timestamp, but reflects * the bits from the local file header! * * * See PKWare documentation and InfoZip extra field documentation for more information. * * * [1] PKWARE .ZIP file format specification: * <pre> * File: APPNOTE.TXT - .ZIP File Format Specification * Version: 4.5 * Revised: 11/01/2001 * Copyright (c) 1989 - 2001 PKWARE Inc., All Rights Reserved. * </pre> * * [2] InfoZip distribution contains the file: proginfo/extra.fld * * @package Archive * @version 1.4.1 * @access private / class ezcArchiveLocalFileHeader { /* * Defines the signature of this header. / const magic = 0x04034b50; /* * Extra field definition. * * UNIX Extra Field ID ("UX"). / const EF_IZUNIX = 0x5855; /* * Extra field definition. * * Info-ZIP's new Unix( "Ux" ). / const EF_IZUNIX2 = 0x7855; /* * Extra field definition. * * Universal timestamp( "UT" ). / const EF_TIME = 0x5455; /* * Minimal UT field contains Flags byte / const EB_UT_MINLEN = 1; /* * Byte offset of Flags field / const EB_UT_FLAGS = 0; /* * Byte offset of 1st time value / const EB_UT_TIME1 = 1; /* * mtime present / const EB_UT_FL_MTIME = 1; /* * atime present / const EB_UT_FL_ATIME = 2; /* * ctime present / const EB_UT_FL_CTIME = 4; /* * UT field length. / const EB_UT_FL_LEN = 4; /* * Minimal "UX" field contains atime, mtime / const EB_UX_MINLEN = 8; /* * Offset of atime in "UX" extra field data / const EB_UX_ATIME = 0; /* * Offset of mtime in "UX" extra field data / const EB_UX_MTIME = 4; /* * Full "UX" field ( atime, mtime, uid, gid ) / const EB_UX_FULLSIZE = 12; /* * Byte offset of UID in "UX" field data / const EB_UX_UID = 8; /* * Byte offset of GID in "UX" field data / const EB_UX_GID = 10; /* * Minimal Ux field contains UID/GID / const EB_UX2_MINLEN = 4; /* * Byte offset of UID in "Ux" field data / const EB_UX2_UID = 0; /* * Byte offset of GID in "Ux" field data / const EB_UX2_GID = 2; /* * Byte offset of valid in "Ux" field data / const EB_UX2_VALID = 256; /* * Holds the properties of this class. * * @var array(string=>mixed) / protected $properties = array(); /* * Holds the user ID and is false if not set. * * @var int / protected $userId = false; /* * Holds the group ID and is false if not set. * * @var int / protected $groupId = false; /* * Holds the modification time as a timestamp and is false if not set. * * @var int / protected $mtime = false; /* * Holds the modification time as a timestamp and is false if not set. * * @var int / protected $atime = false; /* * Holds the creation time as a timestamp and is false if not set. * * @var int / protected $ctime = false; /* * Creates and initializes a new header. * * If the ezcArchiveCharacterFile $file is null then the header will be empty. * When an ezcArchiveCharacterFile is given, the file position should be directly after the * signature of the header. This header will be read from the file and initialized in this class. * * @param ezcArchiveCharacterFile $file / public function __construct( ezcArchiveCharacterFile $file = null, ezcArchiveCentralDirectoryHeader $centralHeader = null ) { // Offset \| Field size \| Description // ---------------------------------- // 0 \| 4 \| Local file header signature ( 0x04034b50 ). // 4 \| 2 \| Version needed to extract. // 6 \| 2 \| General purpose bit flag. // 8 \| 2 \| Compression method. // 10 \| 2 \| Last mod file time. // 12 \| 2 \| Last mod file date. // 14 \| 4 \| Crc-32. // 18 \| 4 \| Compressed size. // 22 \| 4 \| Uncompressed size. // 26 \| 2 \| File name length. // 28 \| 2 \| Extra field length. if ( !is_null( $file ) ) { $this->properties = unpack ( "vversion/". "vbitFlag/". "vcompressionMethod/". "vlastModFileTime/". "vlastModFileDate/". "Vcrc/". "VcompressedSize/". "VuncompressedSize/". "vfileNameLength/". "vextraFieldLength", $file->read( 26 ) ); $this->properties["fileName"] = $file->read( $this->properties["fileNameLength"] ); $extraField = $file->read( $this->properties["extraFieldLength"] ); // Append extra field information. $this->setExtraFieldData( $extraField ); // Fix the local file headers from the central header, in case crc, // compressed size and original size are not set. This is needed // for Open Office documents at least. if ( $centralHeader && $this->properties['compressedSize'] === 0 && $this->properties['uncompressedSize'] === 0 ) { $this->properties['compressedSize'] = $centralHeader->compressedSize; $this->properties['uncompressedSize'] = $centralHeader->uncompressedSize; $this->properties['crc'] = $centralHeader->crc; } // Skip the file. $file->seek( $this->compressedSize, SEEK_CUR ); } } /* * Serializes this header and appends it to the given ezcArchiveCharacterFile $archiveFile. * * @param ezcArchiveCharacterFile $archiveFile * @return void / public function writeEncodedHeader( $archiveFile ) { $this->properties["extraFieldLength" ] = 21; // FIXME. $enc = pack( "VvvvvvVVVvv", self::magic, $this->properties["version"], $this->properties["bitFlag"], $this->properties["compressionMethod"], $this->properties["lastModFileTime"], $this->properties["lastModFileDate"], $this->properties["crc"], $this->properties["compressedSize"], $this->properties["uncompressedSize"], $this->properties["fileNameLength"], $this->properties["extraFieldLength"] ); $time = pack( "vvcVV", self::EF_TIME, 9, 3, $this->mtime, $this->atime ); // set accesss time to modification time. $unix2 = pack( "vvvv", self::EF_IZUNIX2, 4, $this->userId, $this->groupId ); $archiveFile->write( $enc . $this->fileName . $time . $unix2 ); } /* * Sets the property $name to $value. * * @throws ezcBasePropertyNotFoundException if the property does not exist * @throws ezcBasePropertyReadOnlyException if the property is read-only * @param string $name * @param mixed $value * @return void * @ignore / public function __set( $name, $value ) { switch ( $name ) { case "version": case "bitFlag": case "compressionMethod": case "crc": case "compressedSize": case "uncompressedSize": case "extraFieldLength": $this->properties[$name] = $value; break; case "lastModFileTime": case "lastModFileDate": case "fileNameLength": throw new ezcBasePropertyReadOnlyException( $name ); default: throw new ezcBasePropertyNotFoundException( $name ); } } /* * Returns the value of the property $name. * * @throws ezcBasePropertyNotFoundException if the property does not exist. * @param string $name * @return mixed * @ignore / public function __get( $name ) { switch ( $name ) { case "version": case "bitFlag": case "compressionMethod": case "lastModFileTime": case "lastModFileDate": case "crc": case "compressedSize": case "uncompressedSize": case "extraFieldLength": case "fileNameLength": case "fileName": return $this->properties[ $name ]; default: throw new ezcBasePropertyNotFoundException( $name ); } } /* * Returns the modification timestamp. * * The timestamp from the extra fields is returned if it is available. * If it cannot be found, the ZIP time is converted to a timestamp. * * @return int / public function getModificationTime() { return ( $this->mtime ? $this->mtime : self::dosFormatToTimestamp( array( $this->lastModFileTime, $this->lastModFileDate ) ) ); } /* * Sets the modification time to the int $timestamp. * * The properties lastModFileTime and lastModFileDate properties will be set. * * @param int $timestamp * @return void / public function setModificationTime( $timestamp ) { $this->mtime = $timestamp; list( $this->properties["lastModFileTime"], $this->properties["lastModFileDate"] ) = self::timestampToDosFormat( $timestamp ); } /* * Returns an two element array with, respectively, the dos time and dos date, which are converted from * the given int $timestamp. * * The DOS time and date format are described here: {@link http://www.vsft.com/hal/dostime.htm}. * * @see http://www.vsft.com/hal/dostime.htm * * @param int $timestamp * @return array(int) / public static function timestampToDosFormat( $timestamp ) { $time = getdate( $timestamp ); $dosTime = ( $time["hours"] & 31 ); // Hours. Bit: 11 .. 15 $dosTime <<= 6; $dosTime \|= ( $time["minutes"] & 63 ); // Minutes. $dosTime <<= 5; $dosTime \|= ( ( int ) ( $time["seconds"] / 2 ) & 31 ); // seconds. $dosDate = ( $time["year"] - 1980 ) & 127; // Year. $dosDate <<= 4; $dosDate \|= ( $time["mon"] & 15 ); // month. $dosDate <<= 5; $dosDate \|= ( $time["mday"] & 31 ); // day. return array( $dosTime, $dosDate ); } /* * Returns the timestamp which is converted from an array with, respectively, the dos time and dos date. * * Expects an array with two elements. * * The DOS time and date format are described here: {@link http://www.vsft.com/hal/dostime.htm}. * * @see http://www.vsft.com/hal/dostime.htm * * @param array(int) $array * @return int / public static function dosFormatToTimestamp( array $array ) { $dosTime = $array[0]; $seconds = ( ($dosTime ) & 31 ) 2 ; // Bit 0 .. 4 $minutes = ( $dosTime >> 5 ) & 63 ; // Bit 5 .. 10 $hours = ( $dosTime >> 11 ) & 31; // Bit 11 .. 15 $dosDate = $array[1]; $day = ( ( $dosDate ) & 31 ); // Bit 0 .. 4 $month = ( $dosDate >> 5 ) & 15 ; // Bit 5 .. 8 $year = ( ( $dosDate >> 9 ) & 127 ) + 1980; // Bit 9 .. 15 return mktime( $hours, $minutes, $seconds, $month, $day, $year ); } /** * Sets the filename in the header. * * The properties fileName and file length are changed. * * @param string $name / public function setFileName( $name ) { $this->properties["fileName"] = $name; $this->properties["fileNameLength"] = strlen( $name ); } /* * Sets the compression. * * @param int $compressionMethod * @param int $compressedSize * @return void / public function setCompression( $compressionMethod, $compressedSize ) { // Fixme, for now only decompressed. $this->compressionMethod = $compressionMethod; $this->compressedSize = $compressedSize; } /* * Updates the given ezcArchiveFileStructure $struct with the values from this header. * * If bool $override is false, this method will not overwrite the values from the ezcArchiveFileStructure $struct. * The values that can be set in the archiveFileStructure are: path, gid, uid, mtime, and size. * * @param ezcArchiveFileStructure &$struct * @param bool $override * @return void / public function setArchiveFileStructure( ezcArchiveFileStructure &$struct, $override = false ) { if ( !isset( $struct->path ) \|\| $override ) { $struct->path = $this->fileName; } if ( !isset( $struct->size ) \|\| $override ) { $struct->size = $this->uncompressedSize; } if ( $this->groupId && ( !isset( $struct->size ) \|\| $override ) ) { $struct->gid = $this->groupId; } if ( $this->userId && ( !isset( $struct->size ) \|\| $override ) ) { $struct->uid = $this->userId; } if ( $this->mtime && ( !isset( $struct->mtime ) \|\| $override ) ) { $struct->mtime = $this->mtime; } if ( $this->atime && ( !isset( $struct->atime ) \|\| $override ) ) { $struct->atime = $this->atime; } } /* * Sets this header with the values from the ezcArchiveEntry $entry. * * The values that are possible to set from the ezcArchiveEntry $entry are set in this header. * * @param ezcArchiveEntry $entry * @return void / public function setHeaderFromArchiveEntry( ezcArchiveEntry $entry ) { $this->version = 10; // FIXME $this->bitFlag = 0; // FIXME $this->atime = $entry->getAccessTime(); $this->groupId = $entry->getGroupId(); $this->userId = $entry->getUserId(); $this->setModificationTime( $entry->getModificationTime() ); if ( $entry->isSymLink() ) { $this->uncompressedSize = strlen( $entry->getLink() ); $this->crc = ezcArchiveChecksums::getCrc32FromString( $entry->getLink() ); } else { $this->uncompressedSize = $entry->getSize(); $this->crc = ezcArchiveChecksums::getCrc32FromFile( $entry->getPath() ); } $this->setFileName( $entry->getPath( false ) ); } /* * Returns the total size of this header. * * @return int / public function getHeaderSize() { return 30 + $this->properties["fileNameLength"] + $this->properties["extraFieldLength"]; } /* * Decodes and sets the extra header properties from the string $data. * * @param string $data * @return void / protected function setExtraFieldData( $data ) { $raw = array(); $offset = 0; $dataLength = strlen( $data ); while ( $offset < $dataLength ) { // Read header. $dec = unpack( "vid/vlength", substr( $data, $offset, 4 ) ); $offset += 4; switch ( $dec["id"] ) { case self::EF_IZUNIX2: $raw[ "EF_IZUNIX2" ] = $this->getNewInfoZipExtraField( substr( $data, $offset, $dec["length"] ), $dec["length"] ); break; case self::EF_IZUNIX: $raw[ "EF_IZUNIX" ] = $this->getOldInfoZipExtraField( substr( $data, $offset, $dec["length"] ), $dec["length"] ); break; case self::EF_TIME: $raw[ "EF_TIME" ] = $this->getUniversalTimestampField( substr( $data, $offset, $dec["length"] ), $dec["length"] ); break; } $offset += $dec["length"]; } $result = array(); // The order is important. if ( isset( $raw["EF_TIME"]["mtime"] ) ) { $this->mtime = $raw["EF_TIME"]["mtime"]; } if ( isset( $raw["EF_TIME"]["atime"] ) ) { $this->atime = $raw["EF_TIME"]["atime"]; } if ( isset( $raw["EF_TIME"]["ctime"] ) ) { $this->ctime = $raw["EF_TIME"]["ctime"]; } if ( isset( $raw["EF_IZUNIX"]["mtime"] ) ) { $this->mtime = $raw["EF_IZUNIX"]["mtime"]; } if ( isset( $raw["EF_IZUNIX"]["atime"] ) ) { $this->atime = $raw["EF_IZUNIX"]["atime"]; } if ( isset( $raw["EF_IZUNIX"]["gid"] ) ) { $this->groupId = $raw["EF_IZUNIX"]["gid"]; } if ( isset( $raw["EF_IZUNIX"]["uid"] ) ) { $this->userId = $raw["EF_IZUNIX"]["uid"]; } if ( isset( $raw["EF_IZUNIX2"]["gid"] ) ) { $this->groupId = $raw["EF_IZUNIX2"]["gid"]; } if ( isset( $raw["EF_IZUNIX2"]["uid"] ) ) { $this->userId = $raw["EF_IZUNIX2"]["uid"]; } return $result; } /* * Returns an array with the decoded 'new Info-Zip' data. * * @param string $field * @param int $length * @return array(string) / protected function getNewInfoZipExtraField( $field, $length ) { $localOffset = 0; if ( $length >= self::EB_UX2_MINLEN ) { return unpack( "vuid/vgid", substr( $field, 0, self::EB_UX2_MINLEN ) ); } return array(); } /* * Returns an array with the decoded 'old Info-Zip' data. * * @param string $field * @param int $length * @return array(string) / protected function getOldInfoZipExtraField( $field, $length ) { if ( $length >= self::EB_UX_FULLSIZE ) { return unpack( "Vatime/Vmtime/vuid/vgid", substr( $field, 0, self::EB_UX_FULLSIZE ) ); } else if ( $length >= self::EB_UX_MINLEN ) { return unpack( "Vatime/Vmtime", substr( $field, 0, self::EB_UX_MINLEN ) ); } return array(); } /* * Returns an array with the decoded 'universal timestamp' data. * * @param string $field * @param int $length * @return array(string) / protected function getUniversalTimestampField( $field, $length ) { $localOffset = 0; $result = array(); if ( $length >= self::EB_UT_MINLEN ) { $f = unpack( "cflags", substr( $field, $localOffset, 1 ) ); $length--; // Flag takes one byte. if ( ( $f["flags"] & self::EB_UT_FL_MTIME ) && $length >= 4 ) { $result = array_merge( $result, unpack( "Vmtime", substr( $field, $localOffset + self::EB_UT_MINLEN + ( self::EB_UT_FL_LEN 0 ), self::EB_UT_FL_LEN ) ) ); $length -= 4; } if ( $f["flags"] & self::EB_UT_FL_ATIME && $length >= 4 ) { $result = array_merge( $result, unpack( "Vatime", substr( $field, $localOffset + self::EB_UT_MINLEN + ( self::EB_UT_FL_LEN * 1 ), self::EB_UT_FL_LEN ) ) ); $length -= 4; } if ( $f["flags"] & self::EB_UT_FL_CTIME && $length >= 4 ) { $result = array_merge( $result, unpack( "Vctime", substr( $field, $localOffset + self::EB_UT_MINLEN + ( self::EB_UT_FL_LEN * 2 ), self::EB_UT_FL_LEN ) ) ); $length -= 4; } } return $result; } /** * Returns true if the given string $string matches with the current signature. * * @param string $string * @return bool */ public static function isSignature( $string ) { return $string == pack( "V", self::magic ); } } ?>	24.84 KB	2024-07-17 10:18

Terminal