Manuale PHP
Indietro |  | Avanti

# stat

(PHP 3, PHP 4, PHP 5)

stat -- Da informazioni su un file

## Descrizione

array stat ( string filename )

Restituisce una serie di informazioni a riguardo del file filename. Se il parametro filename è un link simbolico, le informazioni riguardano il file stesso, e non il file puntato dal link. La funzione lstat() è identica a stat() tranne che dovrebbe restituire il file puntato dal link.

In caso di errore stat() restituisce `FALSE`. Inoltre genera un warning.

La funzione restituisce un vettore con le informazioni sul file contenente i seguenti elementi. Il vettore parte dall'indice zero. Oltre agli indici numerici il vettore contiene indici associativi, come sarà indicato per ciascun parametro; questo è disponibile dal PHP versione 4.0.6.

Tabella 1. Formato del vettore restituito da stat() e fstat()

Indice numerico | Associativo (da PHP 4.0.6) | Descrizione
--- | --- | ---
0 | dev | device
1 | ino | inode
2 | mode | modalità di protezione dell'inode
3 | nlink | numero di link
4 | uid | ID utente del proprietario
5 | gid | ID del gruppo del proprietario
6 | rdev | tipo di device con l'inode device *
7 | size | dimensione in byte
8 | atime | ora dell'ultimo accesso (Unix timestamp)
9 | mtime | ora del'ultima modifica (Unix timestamp)
10 | ctime | ora dell'ultimo cambiamento di inode(Unix timestamp)
11 | blksize | dimensione del blocco per l'I/O di filesystem *
12 | blocks | numero dei blocchi allocati

* - valida solo su sistemi che supportano il tipo st_blksize--altri sistemi (ad esempio Windows) restituiscono -1.

> Nota: I risultati di questa funzione saranno memorizzati. Vedere clearstatcache() per maggiori dettagli.

> Suggerimento: A partire da PHP 5.0.0, questa funzione può essere utilizzata con alcuni URL wrappers. Fare riferimento a Appendice M per la lista di quali wrappers supportano le funzioni della famiglia stat().

Vedere anche lstat(), fstat(), filemtime() e filegroup().

Indietro | Partenza | Avanti
set_file_buffer | Risali | symlink