set_file_buffer
symlink
Funkcje Systemu plików
PHP Manual

# stat

(PHP 4, PHP 5)

stat — Gives information about a file

### Opis

array stat ( string `$filename` )

Gathers the statistics of the file named by `filename` . If `filename` is a symbolic link, statistics are from the file itself, not the symlink.

lstat() is identical to stat() except it would instead be based off the symlinks status.

### Parametry

`filename`

  Path to the file.

### Zwracane wartości

stat() and fstat() result format
Numeric | Associative (since PHP 4.0.6) | Description
--- | --- | ---
0 | dev | device number
1 | ino | inode number *
2 | mode | inode protection mode
3 | nlink | number of links
4 | uid | userid of owner *
5 | gid | groupid of owner *
6 | rdev | device type, if inode device
7 | size | size in bytes
8 | atime | time of last access (Unix timestamp)
9 | mtime | time of last modification (Unix timestamp)
10 | ctime | time of last inode change (Unix timestamp)
11 | blksize | blocksize of filesystem IO **
12 | blocks | number of blocks allocated **

* On Windows this will always be 0.

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

In case of error, stat() returns `FALSE`.

### Błędy/Wyjątki

Upon failure, an `E_WARNING` is emitted.

### Rejestr zmian

Wersja | Opis
--- | ---
4.0.6 | In addition to returning these attributes in a numeric array, they can be accessed with associative indices, as noted next to each parameter

### Przykłady

Przykład #1 stat() example

`<?php
/* Get file stat */
$stat = stat('C:\php\php.exe');
/*
* Print file access file, this is the same
* as calling fileatime()
*/
echo 'Access time: ' . $stat['atime'];
/*
* Print file modification time, this is the
* same as calling filemtime()
*/
echo 'Modification time: ' . $stat['mtime'];
/* Print the device number */
echo 'Device number: ' . $stat['dev'];`

Przykład #2 Using stat() information together with touch()

`<?php
/* Get file stat */
$stat = @stat('C:\php\php.exe');
/* Did we failed to get stat information ? */
if(!$stat)
{
echo 'Stat call failed...';
}
else
{
/*
* We want the access time to be 1 week
* before the current access time.
*/
$atime = $stat['atime'] + 604800;
/* Touch the file */
if(!@touch('some_file.txt', time(), $atime))
{
echo 'Failed to touch file...';
}
else
{
echo 'Touch returned success...';
}
}
?>`

### Notatki

> Informacja: Proszę zauważyć, że informacja o czasie dostępu może się różnić w zależności od systemu plików.

> Informacja: Wyniki działania tej funkcji są buforowane. Zobacz opis funkcji clearstatcache() aby uzyskać więcej informacji.

Wskazówka

Od PHP 5.0.0 ta funkcja może być użyta także z niektórymi nakładkami URL. Zobacz List of Supported Protocols/Wrappers aby uzyskać listę nakładek, które obsługują funkcjonalność z rodziny stat().

### Zobacz też:

- lstat() - Podaje informacje o pliku lub dowiązaniu symbolicznym
- fstat() - Pobiera informacje o pliku używając otwartego wskaźnika pliku
- filemtime() - Pobiera czas ostatniej modyfikacji pliku
- filegroup() - Pobiera grupę pliku

set_file_buffer
symlink
Funkcje Systemu plików
PHP Manual