[edit] Last updated: Fri, 25 May 2012

ZipArchive::statName

(PHP 5 >= 5.2.0, PECL zip >= 1.5.0)

ZipArchive::statName — Get the details of an entry defined by its name.

Description

mixed ZipArchive::statName ( name $name [, int $flags ] )

The function obtains information about the entry defined by its name.

Parameters

name

Name of the entry

flags

The flags argument specifies how the name lookup should be done. Also, ZIPARCHIVE::FL_UNCHANGED may be ORed to it to request information about the original file in the archive, ignoring any changes made.

ZIPARCHIVE::FL_NOCASE
ZIPARCHIVE::FL_NODIR
ZIPARCHIVE::FL_UNCHANGED

Return Values

Returns an array containing the entry details or FALSE on failure.

Examples

Example #1 Dump the stat info of an entry


<?php
$zip = new ZipArchive;
$res = $zip->open('test.zip');
if ($res === TRUE) {
    print_r($zip->statName('foobar/baz'));
    $zip->close();
} else {
    echo 'failed, code:' . $res;
}
?>

The above example will output something similar to:

Array
(
    [name] => foobar/baz
    [index] => 3
    [crc] => 499465816
    [size] => 27
    [mtime] => 1123164748
    [comp_size] => 24
    [comp_method] => 8
)

add a note User Contributed Notes ZipArchive::statName

Stewart Rice 26-Mar-2010 05:18


Since a Unix Timestamp is measured in seconds, not milliseconds, I would have to assume that mtime is 'modified time' rather than 'millisecond time'... however it does not appear to work on a Linux system

martin_packer at uk dot ibm dot com 23-Oct-2009 10:43


This may be stating the obvious but I assume that mtime is "millisecond time". Using http://www.onlineconversion.com/unix_time.htm  the example time "1123164748" converts to "Thu, 04 Aug 2005 14:12:28 GMT".



The two sizes - size and comp_size are presumably in bytes (the latter being the compressed file in the archive).

add a note