★ wanayoo — archive 1999 http://www.php.net/manual/function.stat.phpNouvelle recherche | Portail wanayoo

PHP Home Page
Manual Table of Contents
Up to Filesystem
Quick Reference
German version of this pageJapanese version of this pageItalian version of this pageFrench version of this pageHungarian version of this page
Filesystem
* basename
* chgrp
* chmod
* chown
* clearstatcache
* copy
* delete
* dirname
* diskfreespace
* fclose
* feof
* fgetc
* fgetcsv
* fgets
* fgetss
* file
* file_exists
* fileatime
* filectime
* filegroup
* fileinode
* filemtime
* fileowner
* fileperms
* filesize
* filetype
* flock
* fopen
* fpassthru
* fputs
* fread
* fscanf
* fseek
* fstat
* ftell
* ftruncate
* fwrite
* set_file_buffer
* is_dir
* is_executable
* is_file
* is_link
* is_readable
* is_writeable
* link
* linkinfo
* mkdir
* pclose
* popen
* readfile
* readlink
* rename
* rewind
* rmdir
* stat
* lstat
* realpath
* symlink
* tempnam
* touch
* umask
* unlink
Manual: stat
 View the source code for this pageSearch the site



Previous page
  rmdir
  Updated
Sat, 12 Aug 2000
 lstat 
 Next page

stat

(PHP3 , PHP4 )

stat -- Give information about a file

Description

array stat (string filename)

Gathers the statistics of the file named by filename.

Returns an array with the statistics of the file with the following elements:

  1. device

  2. inode

  3. inode protection mode

  4. number of links

  5. user id of owner

  6. group id owner

  7. device type if inode device *

  8. size in bytes

  9. time of last access

  10. time of last modification

  11. time of last change

  12. blocksize for filesystem I/O *

  13. number of blocks allocated

* - only valid on systems supporting the st_blksize type--other systems (i.e. Windows) return -1

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


User Contributed Notes: stat

ian@eiloart.com
23-Jul-1999 08:52
Here's what the UNIX man page on stat has to say about the difference between a file change and a file modification:

st_mtime Time when data was last modified. Changed by the following functions: creat(), mknod(), pipe(), utime(), and write(2).

st_ctime Time when file status was last changed. Changed by the following functions: chmod(), chown(), creat(), link(2), mknod(), pipe(), unlink(2), utime(), and write().

So a modification is a change in the data, whereas a change also happens if you modify file permissions and so on.


esmith@schicktech.com
07-Mar-2000 11:53
Note that in the docs above, the array is zero based. I scratched my head a couple of times, before decreasing each item by one. ie - stat for file size is actually 7 !

dvogel@intercarve.net
18-May-2000 04:20
Is the information cached (ie: cleared by clearstatcache()) cached on a per script basis, or do scripts share a global cache?

 About Notes

Previous page
  rmdir
  Updated
Sat, 12 Aug 2000
 lstat 
 Next page




Who's responsible for this?
Top of this page
Site
Hosting:

Located in
United States
Elements of this website are subject to copyright.
Questions about installing or using PHP should be directed to one of the mailing lists.
Only questions about the website should be directed to webmaster@php.net.