XL. Filesystem Functions
Requisiti
Non sono richieste librerie esterne per compilare questo modulo, ma se si desidera avere il supporto per LFS (file di grandi dimensioni) su Linux, occorre avere una versione recente di glibc e occorre compilare il PHP con i seguenti parametri: -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64.
Installazione
Non è necessaria nessuna installazione per usare queste funzioni, esse fanno parte del core di PHP.
Configurazione di Runtime
Il comportamento di queste funzioni è influenzato dalle impostazioni di php.ini.
Tabella 1. Opzioni di configurazione per Filesystem e Streams
| Nome | Default | Modificabile |
|---|---|---|
| allow_url_fopen | "1" | PHP_INI_SYSTEM |
| user_agent | NULL | PHP_INI_ALL |
| default_socket_timeout | "60" | PHP_INI_ALL |
| from | NULL | ?? |
| auto_detect_line_endings | "Off" | PHP_INI_ALL |
Breve descrizione dei parametri di configurazione.
- allow_url_fopen boolean
Questa opzione abilita i wrapper URL per fopen, in modo da potere accedere ad oggetti URL come file. Per default sono forniti wrapper per accedere a file remoti usando il protocollo ftp o http, alcune estensioni, tipo zlib, possono registrarne altri.
Nota: Questa impostazione può essere impostata solamente nel php.ini per motivi di sicurezza.
Nota: Questa opzione è stata aggiunta subito dopo il rilascio di PHP 4.0.3. Per le versioni fino a 4.0.3 compresa si può disabilitare questa opzione solo al momento della compila utilizzando il parametro di configurazione --disable-url-fopen-wrapper.
Avvertimento Nelle versioni precedenti alla 4.3.0 per i sistemi Windows, le suguenti funzioni non supportano l'accesso a file remoti: include(), include_once(), require(), require_once() e le funzioni imagecreatefromXXX nel modulo Riferimento LXIII, Funzioni per le immagini.
- user_agent string
Definisce un agente utente il PHP.
- default_socket_timeout integer
Timeout di default (in secondi) per gli stream sui socket.
Nota: Questa opzione di configurazione è stata inserita in PHP 4.3.0
- from="joe@example.com" string
Imposta la password per l'ftp anonimo (il tuo indirizzo di posta elettronica).
- auto_detect_line_endings boolean
Quando è attivato, il PHP esamina i dati letti da fgets() e file() per vedere se si sta utilizzando le convezioni di Unix, MS-Dos o Macintosh.
Questo permette al PHP di operare con sistemi Macintosh, ma, per default, l'opzione è impostata a Off, poichè vi è una piccola penalizzazione di velocità nel cercare di individuare il tipo di EOL per la prima riga; e anche perchè in alcuni casi si è sperimentato che l'utilizzo del carriage-returns come separatore nei sistemi Unix ha generato comportamenti non compatibili con il passato.
Nota: Questa opzione è stata introdotta in PHP 4.3.0
Costanti predefinite
Queste costanti sono definite da questa estensione e sono disponibili solo se l'estensione è stata compilata nel PHP o se è stata caricata dinamicamente a runtime.
- GLOB_BRACE (integer)
- GLOB_ONLYDIR (integer)
- GLOB_MARK (integer)
- GLOB_NOSORT (integer)
- GLOB_NOCHECK (integer)
- GLOB_NOESCAPE (integer)
- PATHINFO_DIRNAME (integer)
- PATHINFO_BASENAME (integer)
- PATHINFO_EXTENSION (integer)
- FILE_USE_INCLUDE_PATH (integer)
- FILE_APPEND (integer)
- FILE_IGNORE_NEW_LINES (integer)
- FILE_SKIP_EMPTY_LINES (integer)
Vedere anche:
Vedere anche le sezioni Directory e Esecuzione di programmi.
Per avere un elenco e le spiegazioni sui vari wrapper URL che possono essere utilizzati sui file remoti, vedere Appendice M.
- Sommario
- basename -- Restituisce il nome del file dal percorso indicato
- chgrp -- Cambia il gruppo del file
- chmod -- Cambia le impostazioni del file
- chown -- Cambia il proprietario del file
- clearstatcache -- Libera la cache dello stato di un file
- copy -- Copia un file
- delete -- Vedere unlink() oppure unset()
- dirname -- Restituisce il nome della directory dal percorso indicato
- disk_free_space -- Restituisce lo spazio disponibile nella directory
- disk_total_space -- Restituisce lo spazio totale di una directory
- diskfreespace -- Alias di disk_free_space()
- fclose -- Chiude un puntatore a file aperto
- feof -- Verifica se è stata raggiunta la fine del file su un puntatore a file
- fflush -- Invia l'output in un file
- fgetc -- Prende un carattere da un puntatore a file
- fgetcsv -- Prende una riga da un puntatore a file e l'analizza in cerca di campi CSV
- fgets -- Prende una riga da un puntatore a file
- fgetss -- Prende una riga da un puntatore a file ed elimina i tag HTML
- file_exists -- Controlla se un file o directory esiste
- file_get_contents -- Legge un file all'interno di una stringa
- file_put_contents -- Write a string to a file
- file -- Legge l'intero file in un vettore
- fileatime -- Prende l'ora dell'ultimo accesso al file
- filectime -- Prende l'ora in cui l'inode del file è stato modificato
- filegroup -- Restituisce il gruppo di un file
- fileinode -- Restituisce il numero di inode del file
- filemtime -- Restituisce l'ora delle modifiche al file
- fileowner -- Restituisce il proprietario del file
- fileperms -- Restituisce i permessi sui file
- filesize -- Restituisce la dimensione del file
- filetype -- Restituisce il tipo di file
- flock -- Sistema di bloccaggio file
- fnmatch -- Match filename against a pattern
- fopen -- Apre un file o un URL
- fpassthru -- Invia tutti i dati rimanenti su un puntartore a file
- fputcsv -- Format line as CSV and write to file pointer
- fputs -- Alias di fwrite()
- fread -- Legge un file salvaguardando la corrispondenza binaria
- fscanf -- Analizza l'input da un file secondo un determinato formato
- fseek -- Sposta un puntatore sul file
- fstat -- Restituisce le informazioni riguardanti un file attraverso un puntatore al file aperto
- ftell -- Comunica la posizione di lettura/scrittura del puntatore al file
- ftruncate -- Tronca un file alla lunghezza data
- fwrite -- Scrive un file salvaguardando la corrispondenza binaria
- glob -- Find pathnames matching a pattern
- is_dir -- Dice se la stringa corrisponde ad una directory
- is_executable -- Dice se il file indicato è eseguibile
- is_file -- Dice se il file è un file regolare
- is_link -- Dice se il file è un link simbolico
- is_readable -- Dice se un file è leggibile
- is_uploaded_file -- Dice se un file fù caricato via HTTP POST.
- is_writable -- Dice se un file è scrivibile
- is_writeable -- Alias di is_writable()
- lchgrp -- Changes group ownership of symlink
- lchown -- Changes user ownership of symlink
- link -- Crea un hard link
- linkinfo -- Restituisce informazioni su un collegamento
- lstat -- Da informazioni su un file o un link simbolico
- mkdir -- Crea una directory
- move_uploaded_file -- Muove un file caricato in una nuova posizione
- parse_ini_file -- Legge il file di configurazione
- pathinfo -- Restituisce informazioni su un percorso di file
- pclose -- Chiude un puntatore ad un file di processo
- popen -- Apre un puntatore ad un file di processo
- readfile -- Invia un file
- readlink -- Restituisce il target di un link simbolico
- realpath -- Restituisce un percorso assoluto regolare
- rename -- Rinomina un file o una directory
- rewind -- Riavvolge la posizione di un puntatore a file
- rmdir -- Rimuove una directory
- set_file_buffer -- Alias di stream_set_write_buffer()
- stat -- Da informazioni su un file
- symlink -- Crea un link simbolico
- tempnam -- Crea file con unico nome file
- tmpfile -- Crea un file temporaneo
- touch -- Imposta l'ora di modifica di un file
- umask -- Cambia l'umask corrente
- unlink -- Cancella un file