stat

(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.

**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 Supported Protocols and Wrappers per la lista di quali wrappers supportano le funzioni della famiglia stat().

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