CXXI. 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
| Nome | Default | Modificabile |
|---|---|---|
| assert.active | "1" | PHP_INI_ALL |
| assert.bail | "0" | PHP_INI_ALL |
| assert.warning | "1" | PHP_INI_ALL |
| assert.callback | NULL | PHP_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 |
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 modalità sicura. In modalità sicura, è 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 modalità sicura. L'unico modo è di disabilitare il safe mode oppure di cambiare il limite di tempo nel php.ini.
Anche il server web ha i propri timeout. Ad esempio Apache ha un proprio parametro Timeout, IIS ha una funzione di timeout sugli script CGI, entrambi con default 300 secondi. Vedere la documentazione del server web per maggiori dettagli.
- 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()
| Costante | Valore | Descrizione |
|---|---|---|
| CREDITS_GROUP | 1 | Lista degli sviluppatori principali |
| CREDITS_GENERAL | 2 | Lista generale: design e progetto del linguaggio, autori del PHP e del modulo SAPI. |
| CREDITS_SAPI | 4 | Lista delle API server e dei loro sviluppatori. |
| CREDITS_MODULES | 8 | Lista dei moduli e dei loro sviluppatori. |
| CREDITS_DOCS | 16 | La lista del gruppo di documentazione. |
| CREDITS_FULLPAGE | 32 | Solitamente utilizzato in combinazione con altri flag. Indica che la pagina completa HTML deve essere stampata includendo le infomazioni di altri flag. |
| CREDITS_QA | 64 | 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()
| Costante | Valore | Descrizione |
|---|---|---|
| INFO_GENERAL | 1 | La linea di configurazione, php.ini luogo, data di compila, Web Server, sistema e altro. |
| INFO_CREDITS | 2 | PHP Credits. Vedere anche phpcredits(). |
| INFO_CONFIGURATION | 4 | Impostazioni correnti e di base delle opzioni PHP. Vedere anche ini_get(). |
| INFO_MODULES | 8 | Moduli caricati e le loro impostazioni. |
| INFO_ENVIRONMENT | 16 | Variabili d'ambiente disponibili in $_ENV. |
| INFO_VARIABLES | 32 | Visualizza tutte le variabili predefinite da EGPCS (Environment, GET, POST, Cookie, Server). |
| INFO_LICENSE | 64 | Informazioni sulla licenza di PHP. Vedere anche faq sulla licenza. |
| INFO_ALL | -1 | Visualizza tutto quanto descritto. Questo è il valore dei default. |
- 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_peak_usage -- Returns the peak of memory allocated by PHP
- 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 gira 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
- sys_get_temp_dir -- Returns directory path used for temporary files
- 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