Manuale PHP
Indietro |  | Avanti

# CXI. 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

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

`ASSERT_ACTIVE` (integer)

`ASSERT_CALLBACK` (integer)

`ASSERT_BAIL` (integer)

`ASSERT_WARNING` (integer)

`ASSERT_QUIET_EVAL` (integer)

Indietro | Partenza | Avanti
PDOStatement::setFetchMode | Risali | assert_options