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 numericoAssociativo (da PHP 4.0.6)Descrizione
0devdevice
1inoinode
2modemodalità di protezione dell'inode
3nlinknumero di link
4uidID utente del proprietario
5gidID del gruppo del proprietario
6rdevtipo di device con l'inode device *
7sizedimensione in byte
8atimeora dell'ultimo accesso (Unix timestamp)
9mtimeora del'ultima modifica (Unix timestamp)
10ctimeora dell'ultimo cambiamento (Unix timestamp)
11blksizedimensione del blocco per l'I/O di filesystem *
12blocksnumero 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 L per la lista di quali wrappers supportano le funzioni della famiglia stat().

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