What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

stat
Prev	XXII. Filesystem Functions	Next

stat

Name

stat — Retrieves file status information.

Synopsis

array stat(filename); string filename:

Returns

Array of file information; FALSE on error

Description

Accesses a file's properties and returns a 13-element array containing various information about the file. The array contains the following elements:

Array Index	Value
0	Device
1	Inode number
2	Inode protection mode
3	Number of links
4	User ID of owner
5	Group ID of owner
6	Device type if inode device
7	Size in bytes
8	Time of last access
9	Time of last modification
10	Time of last change
11	Block size for filesystem I/O
12	Number of blocks allocated

Not all entries are filled with meaningful values on all systems. For example, under Windows device type and block size are filled with -1. It's a good idea to test the return values on non-UNIX systems before relying on them.

Note

Unlike lstat() , this function follows symbolic links. If a symlink is specified as the parameter, stat() returns information about the link target, not the link itself.

Note

The results of this function are cached. See clearstatcache() for details.

Warning

3.0.5: Still reports status information on files that are in the stat cache but have already been unlinked.

Example

Example 349. Get size of a file

<?php
$file = "test.txt";

$stat = stat ($file)
   or die ("Could not call stat on file '$file'.");

var_dump ($stat);
?>

Prev	Home	Next
set_file_buffer	Up	symlink

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.