LXXXV. PHP Opzioni&Informazioni

Introduzione

Queste funzioni permettono di accedere a diverse informazioni sul PHP stesso, come la configurazione di runtime, il moduli caricati, la versione e molto altro. Si troveranno anche funzioni per impostare le opzioni di runtime del PHP. Probabilmente la pi nota tra queste - phpinfo() -.

Requisiti

Non sono necessarie librerie esterne per utilizzare questo modulo.

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. Parametri di configurazione per PHP Opzioni/informazioni

NomeDefaultModificabile
assert.active"1"PHP_INI_ALL
assert.bail"0"PHP_INI_ALL
assert.warning"1"PHP_INI_ALL
assert.callbackNULLPHP_INI_ALL
assert.quiet_eval"0"PHP_INI_ALL
enable_dl"1"PHP_INI_SYSTEM
max_execution_time"30"PHP_INI_ALL
max_input_time"60"PHP_INI_ALL
magic_quotes_gpc"1"PHP_INI_PERDIR|PHP_INI_SYSTEM
magic_quotes_runtime"0"PHP_INI_ALL
Per maggiori dettagli e per le definizioni delle costanti PHP_INI_* fare riferimento a ini_set().

Breve descrizione dei parametri di configurazione.

assert.active boolean

Abilita l'analisi degli assert().

assert.bail boolean

Termina uno script a fronte di un assert fallito.

assert.warning boolean

Invia un PHP warning per ogni asserzione fallita.

assert.callback string

Funzione utente da richiamare a fronte di un assert fallito

assert.quiet_eval boolean

Utilizzare questo parametro di error_reporting() durante l'analisi dei un'asserzione. Se abilitato, non sono visualizzati gli errori (error_reporting(0)) durante il parsing di una asserzione. Se disabilitato, gli errori saranno visualizzati in base all'impostazione di error_reporting().

enable_dl boolean

Questa direttiva utile soltanto nella versione di PHP attiva come modulo di Apache. Essa permette di caricare in modo dinamico le estensioni di PHP potendo impostare dl() on oppure off in base al server virtuale o per directory.

La ragione principale per disabilitare il caricamento dinamico dei moduli la sicurezza. Con il caricamento dinamico possibile ignorare tutte le restrizioni open_basedir. Per default il caricamento dinamico attivo tranne quando si utilizza il safe mode. In safe mode, sempre impossibile utilizzare dl().

max_execution_time integer

Questo parametro imposta il tempo massimo in secondi concessi ad uno script per l'esecuzione prima di essere interrotto dal parser. Questo aiuta a prevenire che script scritti male blocchino il server. Per default impostato a 30.

Il tempo massimo di esecuzione non condizionato dalle chiamate di sistema, dalle operazioni sugli stream, eccetera. Vedere la funzione set_time_limit() per maggiori dettagli.

Non si pu cambiare questo parametro con ini_set() quando il PHP gira in safe mode. L'unico modo di disabilitare il safe mode oppure di cambiare il limite di tempo nel php.ini.

max_input_time integer

Impostail tempo massimo in secondi concesso ad uno script per ricevere i dati di input, tipo POST, GET e upload di file. Il valore di default 60.

magic_quotes_gpc boolean

Imposta il parametro magic_quote per GPC (Get/Post/Cookie). Quando magic_quote impostato a on, tutti i ' (apici singoli), " (doppi apici), \ (backslash) e NUL sono vengono preceduti in automatico dal backslash.

Nota: Se il parametro magic_quotes_sybase impostato a ON, questo prioritario rispetto a magic_quotes_gpc. Avere entrambi i parametri attivi significa che soltanto gli apici singoli sono preceduti dal carattere di escape come ''. Doppi apici, backslash, e NUL non vengono toccati.

Vedere anche get_magic_quotes_gpc()

magic_quotes_runtime boolean

Se si abilita magic_quotes_runtime, diverse funzioni che restituiscono dati da ogni tipo di fonte esterna, compresi i database ed i file di testo, avranno gli apici preceduti dal backslash. Se anche attivato magic_quotes_sybase, soltanto l'apice singolo sar preceduto dal carattere di escape costituito da un apice singolo anzich il backslash.

Tipi di risorse

Questa estensione non definisce alcun tipo di risorsa.

Costanti predefinite

Le costanti qui elencate sono sempre disponibili in quanto parte del core di PHP.

Tabella 2. Costanti predefinite per phpcredits()

CostanteValoreDescrizione
CREDITS_GROUP1Lista degli sviluppatori principali
CREDITS_GENERAL2 Lista generale: design e progetto del linguaggio, autori del PHP 4.0 e del modulo SAPI.
CREDITS_SAPI4 Lista delle API server e dei loro sviluppatori.
CREDITS_MODULES8 Lista dei moduli e dei loro sviluppatori.
CREDITS_DOCS16 La lista del gruppo di documentazione.
CREDITS_FULLPAGE32 Solitamente utilizzato in combinazione con altri flag. Indica che la pagina completa HTML deve essere stampata includendo le infomazioni di altri flag.
CREDITS_QA64 Elenca i riconoscimenti per il gruppo della qualit.
CREDITS_ALL-1 Tutta la lista dei meriti, equivale a CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + CREDITS_FULLPAGE. Genera una pagina HTML completa. Questa l'impostazione di default.

Tabella 3. Costanti di phpinfo()

CostanteValoreDescrizione
INFO_GENERAL1 La linea di configurazione, php.ini luogo, data di compila, Web Server, sistema e altro.
INFO_CREDITS2 PHP 4 Credits. Vedere anche phpcredits().
INFO_CONFIGURATION4 Impostazioni correnti e di base delle opzioni PHP. Vedere anche ini_get().
INFO_MODULES8 Moduli caricati e le loro impostazioni.
INFO_ENVIRONMENT16 Variabili d'ambiente disponibili in $_ENV.
INFO_VARIABLES32 Visualizza tutte le variabili predefinite da EGPCS (Environment, GET, POST, Cookie, Server).
INFO_LICENSE64 Informazioni sulla licenza di PHP. Vedere anche faq sulla licenza.
INFO_ALL-1 Visualizza tutto quanto descritto. Questo il valore dei default.

ASSERT_ACTIVE (integer)

ASSERT_CALLBACK (integer)

ASSERT_BAIL (integer)

ASSERT_WARNING (integer)

ASSERT_QUIET_EVAL (integer)

Sommario
assert_options -- Imposta/ottiene vari parametri per assert
assert -- Verifica se un'asserzione FALSE
dl -- Carica i moduli del PHP a runtime
extension_loaded -- Verifica se un modulo gi stato caricato
get_cfg_var --  Restituisce il valore di un'opzione di configurazione del PHP
get_current_user --  Restituisce il nome del proprietario dello script PHP
get_defined_constants --  Restituisve un array associativo con i nomi di tutte le costanti ed i loro valori
get_extension_funcs --  Restituisce una matrice con i nomi delle funzioni di un modulo
get_include_path --  Restituisce il valore del parametro di configurazione include_path
get_included_files --  Restituisce una matrice con i nomi dei file inclusi o richiesti
get_loaded_extensions --  Restituisce una matrice con il nome di tutti i moduli compilati e caricati
get_magic_quotes_gpc --  Restituisce l'attuale configurazione di magic quotes gpc
get_magic_quotes_runtime --  Restituisce l'impostazione corrente della direttiva magic_quotes_runtime
get_required_files -- Alias di get_included_files()
getenv -- Restituisce il valore di una variabile d'ambiente
getlastmod -- Restituisce la data dell'ultima modifica alla pagina
getmygid -- Restituisce il GID del proprietario dello script PHP
getmyinode -- Restituisce l'inode dello script
getmypid -- Restituisce l'ID del processo PHP
getmyuid -- Restituisce l'UID del proprietario dello script PHP
getopt -- Ottiene le opzioni dagli argomenti della linea di comando
getrusage -- Restituisce lo stato dell'utilizzo delle risorse
ini_alter -- Alias di ini_set()
ini_get_all -- Restituisce tutte le opzioni di configurazione
ini_get -- Restituisce il valore delle opzioni di configurazione
ini_restore -- Ripristina il valore di un'opzione di configurazione
ini_set -- Imposta le opzioni di configurazione
main -- Riferimento a main()
memory_get_usage -- Restituisce la quantit di memoria allocata dal PHP
php_ini_scanned_files -- Restituisce l'elenco dei file .ini leti dalla directory ini aggiuntiva
php_logo_guid -- Restituisce il guid del logo
php_sapi_name --  Restituisce il tipo di interfaccia tra il PHP ed il server web
php_uname --  Restituisce informazioni sul sistema operativo su cui compilato il PHP
phpcredits -- Visualizza i credits per il PHP
phpinfo -- Visualizza diverse informazioni sul PHP
phpversion -- Restituisce la versione del PHP
putenv -- Imposta il valore di una variabile d'ambiente
restore_include_path --  Ripristina il valore dell'opzione include_path
set_include_path --  Imposta include_path
set_magic_quotes_runtime --  Imposta il valore attuale di magic_quotes_runtime
set_time_limit -- Limita il tempo massimo di esecuzione
version_compare --  Confronta due stringhe contenenti il numero di versione di "PHP-standardized"
zend_logo_guid -- Ottiene il guid del logo Zend
zend_version -- Restituisce il numero di versione dell'engine Zend