<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: pastore Status: ready -->

<!-- CREDITS: cucinato -->

<section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>Descrizione dei parametri core di &php.ini;</title>

<para>

Questo elenco contiene i parametri 'core' del &php.ini; che sono utilizzati

per configurare il PHP. Le impostazioni gestite dai vari moduli sono elencate

e dettagliate nelle pagine di documentazione dei rispettivi moduli;

informazioni sui parametri per le sessioni, ad esempio, possono essere troavte nelle

<link linkend="session.configuration">pagine delle sessioni</link>.

</para>

<note>

<para>

I valori di default elencati qui sono usati quando &php.ini; non è caricato; i valori di &php.ini; per la produzione e lo sviluppo possono variare.

</para>

</note>

<section xml:id="ini.sect.language-options">

<title>Parametri del linguaggio</title>

<para>

<table>

<title>Parametri del linguaggio e configurazioni varie</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.short-open-tag">short_open_tag</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.precision">precision</link></entry>

<entry>"14"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.serialize-precision">serialize_precision</link></entry>

<entry>"-1"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>

Prima di PHP 7.1.0, il valore predefinito era 17.

</entry>

</row>

<row>

<entry><link linkend="ini.disable-functions">disable_functions</link></entry>

<entry>""</entry>

<entry>Solo <constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.disable-classes">disable_classes</link></entry>

<entry>""</entry>

<entry>Solo &php.ini;</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.expose-php">expose_php</link></entry>

<entry>"1"</entry>

<entry>solo &php.ini;</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>

<entry>"2"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry>Disponibile da PHP 7.1.0.</entry>

</row>

<row>

<entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>

<entry>"0"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Disponibile da PHP 7.4.0</entry>

</row>

<row>

<entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>

<entry>"0"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.script-encoding">zend.script_encoding</link></entry>

<entry>NULL</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.detect-unicode">zend.detect_unicode</link></entry>

<entry>NULL</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.signal-check">zend.signal_check</link></entry>

<entry>"0"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.assertions">zend.assertions</link></entry>

<entry>"1"</entry>

<entry><constant>INI_ALL</constant> con restrizioni</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.exception-string-param-max-len">zend.exception_string_param_max_len</link></entry>

<entry>"15"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Disponibile a partire da PHP 8.0.0.</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.short-open-tag">

<term>

<parameter>short_open_tag</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Indica se abilitare o meno la forma abbreviata dei tag di apertura del PHP

(<userinput>&lt;? ?&gt;</userinput>). Se si desidera utilizzare il PHP

in combinazione con l'XML, occorre disabilitare questa opzione per poter

utilizzare <userinput>&lt;?xml ?&gt;</userinput>. In alternativa si può

stampare il testo con il PHP, ad esempio: <userinput>&lt;?php echo '&lt;?xml

version="1.0"?&gt;'; ?&gt;</userinput>. Inoltre, se disabilitato, occorre utilizzare

la versione lunga dei tag di apertura del PHP (<userinput>&lt;?php ?&gt;</userinput>).

</para>

<note>

<para>

Questa direttiva non influisce sulla scorciatoia

<userinput>&lt;?=</userinput>, che è sempre disponibile.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.precision">

<term>

<parameter>precision</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Il numero di cifre significative usato nella visualizzazione dei numeri in virgola mobile.

<literal>-1</literal> indica che verrà utilizzato un algoritmo migliorato

per arrotondare tali numeri.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.serialize-precision">

<term>

<parameter>serialize_precision</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Il numero di cifre significative salvato nella serializzazione dei numeri in virgola mobile.

<literal>-1</literal> indica che verrà utilizzato un algoritmo migliorato

per arrotondare tali numeri.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.expose-php">

<term>

<parameter>expose_php</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Indica se il PHP deve indicare il fatto che è installato su un server, il che include la

versione di PHP all'interno delle intestazioni HTTP (es. X-Powered-By: PHP/5.3.7).

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.disable-functions">

<term>

<parameter>disable_functions</parameter>

<type>string</type>

</term>

<listitem>

<simpara>

Questa direttiva permette di disabilitare alcune funzioni.

Riceve una lista di nomi di funzione separati da virgole.

A partire da PHP 8.0.0, disabilitare una funzione ne rimuove la definizione

consentendo allo spazio utente di ridefinirla.

Prima di PHP 8.0.0, disabilitare una funzione impediva semplicemente di invocare la funzione.

</simpara>

<simpara>

Solo <link linkend="functions.internal">le funzioni interne</link> possono

essere disattivate usando questa direttiva.

Le <link linkend="functions.user-defined">funzioni definite dall'utente</link>

non sono interessate.

</simpara>

<simpara>

Questa direttiva deve essere impostata in &php.ini;.

Può essere impostata in &httpd.conf;.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.disable-classes">

<term>

<parameter>disable_classes</parameter>

<type>string</type>

</term>

<listitem>

<para>

Questa direttiva permette di disabilitare alcune classi.

Riceve una lista di nomi di classi separati da virgole.

Disabilitare una classe impedisce semplicemente di istanziarla.

</para>

<para>

Solo le classi interne possono essere disabilitate usando questa direttiva.

Le classi definite dall'utente non sono interessate.

</para>

<simpara>

Questa direttiva deve essere impostata in &php.ini;.

Può essere impostata in &httpd.conf;.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.assertions">

<term>

<parameter>zend.assertions</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Quando impostato a <literal>1</literal>, il codice di asserzione sarà generato ed

eseguito (modalità di sviluppo). Quando impostato a <literal>0</literal>,

il codice di asserzione sarà generato ma sarà saltato (non eseguito)

in fase di esecuzione. Quando impostato a <literal>-1</literal>, il codice di asserzione non

sarà generato, rendendo le asserzioni a costo zero (modalità di produzione).

</simpara>

<note>

<para>

Se viene avviato un processo in modalità di produzione, <link linkend="ini.zend.assertions">zend.assertions</link>

non può essere cambiato in fase di runtime, poichè il codice per le asserzioni non è stato generato.

</para>

<para>

Se viene avviato un processo in modalità di sviluppo, <link linkend="ini.zend.assertions">zend.assertions</link>

non può essere impostato a <literal>-1</literal> in fase di runtime.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.exception-string-param-max-len">

<term>

<parameter>zend.exception_string_param_max_len</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

La lunghezza massima degli argomenti delle funzioni stringa nelle stack trace in formato stringa.

Deve essere compresa tra <literal>"0"</literal> e <literal>"1000000"</literal>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.hard-timeout">

<term>

<parameter>hard_timeout</parameter>

<type>int</type>

</term>

<listitem>

<para>

Quando il timeout impostato in <link linkend="ini.max-execution-time">max_execution_time</link>

è stato raggiunto, il runtime di PHP rilascerà le risorse in modo ordinato. Se

qualcosa si blocca mentre ciò accade, il timeout rigido verrà conteggiato

per il numero di secondi impostato. Quando il timeout rigido viene raggiunto, PHP

terminerà in modo anomalo. Se impostato su 0, il timeout rigido non verrà mai attivato.

</para>

<para>

Quando PHP si interrompe a causa di un timeout rigido, apparirà qualcosa del genere:

<screen>

<![CDATA[

Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0

]]>

</screen>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.exception-ignore-args">

<term>

<parameter>zend.exception_ignore_args</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Esclude gli argomenti dallo stack trace generati dalle eccezioni.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.multibyte">

<term>

<parameter>zend.multibyte</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Abilita l'analisi dei file sorgente con codifica multibyte. Quando si abilita zend.multibyte

è richiesto utilizzare codifiche di caratteri come SJIS, BIG5, ecc che contengono caratteri

speciali in dati di stringhe multibyte. Codifiche compatibili con ISO-8859-1 come UTF-8,

EUC, ecc non richiedono questa opzione.

</para>

<para>

L'abilitazione di zend.multibyte richiede che l'estensione mbstring sia disponibile.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.script-encoding">

<term>

<parameter>zend.script_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

Questo valore verrà utilizzato a meno che non sia presente una direttiva

<link linkend="control-structures.declare.encoding">declare(encoding=...)</link>

all'inizio dello script. Quando viene usata una codifica incompatibile

con ISO-8859-1, devono essere usati sia zend.multibyte che zend.script_encoding.

</para>

<para>

Le stringhe letterali verrano traslitterate da zend.script_encoding a

mbstring.internal_encoding, come se

fosse stata chiamata <function>mb_convert_encoding</function>.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.detect-unicode">

<term>

<parameter>zend.detect_unicode</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Conrolla il BOM (Byte Order Mark) e vede se il file contiene caratteri

multibyte validi.

Questo rilevamento viene eseguito prima dell'esecuzione di

<function>__halt_compiler</function>.

Disponibile solo in modalità Zend Multibyte.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.signal-check">

<term>

<parameter>zend.signal_check</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Controlla prima dello shutdown gli handler dei segnali che sono stati sostituiti.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.exit-on-timeout">

<term>

<parameter>exit_on_timeout</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Questa è una direttiva Apache1 mod_php-only che termina forzatamente un processo figlio di Apache in caso di ub timeout di esecuzione di PHP.

Questo timeout provoca una chiamata interna longjmp() Apache1 che può lasciare alcune estensioni in uno stato

inconsistente. Terminando il processo qualsiasi lock sulla memoria verrà rimosso.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</section>

<section xml:id="ini.sect.resource-limits">

<title>Limiti per le risorse</title>

<para>

<table>

<title>Limiti per le risorse</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.memory-limit">memory_limit</link></entry>

<entry>"128M"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.memory-limit">

<term>

<parameter>memory_limit</parameter>

<type>int</type>

</term>

<listitem>

<para>

Questo parametro imposta la dimensione massima in byte di memoria occupabile

dallo script. Questo aiuta a impedire che script scritti male

utilizzino tutta la memoria del server. Si noti che per non avere

limitazioni di memoria si deve impostare questo parametro a <literal>-1</literal>.

</para>

&ini.shorthandbytes;

</listitem>

</varlistentry>

</variablelist>

</para>

<para>

Vedi anche: <link linkend="ini.max-execution-time">max_execution_time</link>.

</para>

</section>

<section xml:id="ini.sect.performance">

<title>Regolazione della Performance</title>

<para>

<table>

<title>Regolazione della Performance</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.realpath-cache-size">realpath_cache_size</link></entry>

<entry>"4M"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry>Prima di PHP 7.0.16 e 7.1.2, il valore di default era <literal>"16K"</literal></entry>

</row>

<row>

<entry><link linkend="ini.realpath-cache-ttl">realpath_cache_ttl</link></entry>

<entry>"120"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

<note>

<para>

L'uso di <link linkend="ini.open-basedir">open_basedir</link>

<emphasis>disabiliterà</emphasis> la cache di realpath.

</para>

</note>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.realpath-cache-size">

<term>

<parameter>realpath_cache_size</parameter>

<type>int</type>

</term>

<listitem>

<para>

Determina la dimensione della cache di realpath usata da PHP. Questo

valore dovrebbe essere aumentato nei sistemi in cui PHP apre molti file, in modo da

rispecchiare la quantità di operazioni su file eseguite.

</para>

<para>

La dimensione rappresenta il numero totale di byte nelle stringhe di percorso

memorizzate, più la dimensione dei dati associati con la voce della cache. Questo

significa che al fine di memorizzare percorsi più lunghi nella cache, la dimensione della cache

deve essere più grande. Questo valore non controlla direttamente il numero di

percorsi distinti che possono essere salvati nella cache.

</para>

<para>

La dimensione richiesta per i dati delle voci della cache è dipendente dal sistema.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.realpath-cache-ttl">

<term>

<parameter>realpath_cache_ttl</parameter>

<type>int</type>

</term>

<listitem>

<para>

Durata temporale (in secondi) della validità della cache realpath

per un dato file o cartella. Per sistemi con file che cambiano raramente

valutare la possibilità di aumentare il valore.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</section>

<section xml:id="ini.sect.data-handling">

<title>Gestione dei dati</title>

<para>

<table>

<title>Parametri di configurazione per la gestione dei dati</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.arg-separator.output">arg_separator.output</link></entry>

<entry>"&amp;"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>

<entry>"&amp;"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.variables-order">variables_order</link></entry>

<entry>"EGPCS"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.request-order">request_order</link></entry>

<entry>""</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.post-max-size">post_max_size</link></entry>

<entry>"8M"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-prepend-file">auto_prepend_file</link></entry>

<entry>NULL</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-append-file">auto_append_file</link></entry>

<entry>NULL</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.default-mimetype">default_mimetype</link></entry>

<entry>"text/html"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.default-charset">default_charset</link></entry>

<entry>"UTF-8"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.input-encoding">input_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.output-encoding">output_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.internal-encoding">internal_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.arg-separator.output">

<term>

<parameter>arg_separator.output</parameter>

<type>string</type>

</term>

<listitem>

<para>

Il separatore degli argomenti utilizzato nelle URL genarate da PHP.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.arg-separator.input">

<term>

<parameter>arg_separator.input</parameter>

<type>string</type>

</term>

<listitem>

<para>

Lista dei separatori utilizzati da PHP per la siddivisione dell'URL di input nelle veriabili.

</para>

<note>

<para>

Qualsiasi carattere inserito in questo parametro sarà considerato un separatore!

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.variables-order">

<term>

<parameter>variables_order</parameter>

<type>string</type>

</term>

<listitem>

<para>

Imposta l'ordine di parsing delle variabili EGPCS (<literal>E</literal>nvironment,

<literal>G</literal>et, <literal>P</literal>ost,

<literal>C</literal>ookie e <literal>S</literal>erver).

Ad esempio, se variables_order

è impostato a <literal>"SP"</literal> il PHP creerà il

&link.superglobals; <varname>$_SERVER</varname> e

<varname>$_POST</varname>, ma non creerà

<varname>$_ENV</varname>, <varname>$_GET</varname> e

<varname>$_COOKIE</varname>. L'impostazione "" significa che

non verranno impostati $link.superglobals;.

</para>

<warning>

<para>

In entrambe le SAPI CGI e FastCGI,

<varname>$_SERVER</varname> è

popolato anche dai valori dell'environment; <literal>S</literal>

è sempre equivalente a <literal>ES</literal> a prescindere dalla

posizione di <literal>E</literal> nella direttiva.

</para>

</warning>

<note>

<para>

Anche il contenuto ed ordine di

<varname>$_REQUEST</varname> è

modificato da questa direttiva.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.request-order">

<term>

<parameter>request_order</parameter>

<type>string</type>

</term>

<listitem>

<para>

Descrive l'ordine in cui PHP registra le variabili GET, POST

e Cookie variables nell'array _REQUEST. La registrazione è fatta

da sinistra a destra, i nuovi valori sostituiscono quelli vecchi.

</para>

<para>

Se questa direttiva non è impostata, <link

linkend="ini.variables-order">variables_order</link> è utilizzata per i

contenuti di <varname>$_REQUEST</varname>.

</para>

<para>

Si noti che il file <filename>php.ini</filename> della distribuzione di default non contiene

il <literal>'C'</literal> per i cookie, per questioni di sicurezza.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-globals-jit">

<term>

<parameter>auto_globals_jit</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Quando abilitato, le variabili SERVER, REQUEST ed ENV sono create al momento

del primo utilizzo (Just In Time) invece che all'avvio dello script. Se queste

variabili non sono utilizzate dallo script, impostanto questo parametro ad on

si ha un beneficio in termini di performance.

</para>

<warning>

<para>

L'utilizzo delle variabili SERVER, REQUEST e ENV è impostato al momento della compilazione.

Quindi usarle attraverso, per esempio, <link

linkend="language.variables.variable">variabili dinamiche</link> non

porterà alla loro inizializzazione.

</para>

</warning>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.register-argc-argv">

<term>

<parameter>register_argc_argv</parameter>

<type>bool</type>

</term>

<listitem>

<simpara>

Indica al PHP se dichiarare le variabili argv &amp; argc

(che contengono le informazioni GET).

</simpara>

<simpara>

Vedere anche <link linkend="features.commandline">command line</link>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.enable-post-data-reading">

<term>

<parameter>enable_post_data_reading</parameter>

<type>bool</type>

</term>

<listitem>

<simpara>

Disabilitando questa opzione le variabili <varname>$_POST</varname> e

<varname>$_FILES</varname> <emphasis>non</emphasis> sono popolate.

L'unico modo per leggere i postdata è quindi quello di usare il

wrapper dello stream <link linkend="wrappers.php">php://input</link>.

Questa soluzione può essere utile nelle richieste via proxy o per processare

i dati POST in una maniera più efficiente per la memoria.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.post-max-size">

<term>

<parameter>post_max_size</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Imposta la dimensione massima dei dati post. Questa impostazione

influenza anche gli upload dei file. Per permettere upload di file di grandi dimensioni, il valore impostato deve essere maggiore

di <link linkend="ini.upload-max-filesize">upload_max_filesize</link>.

</simpara>

<simpara>

In termini generali

<link linkend="ini.memory-limit">memory_limit</link> dovrebbe essere

maggiore di <parameter>post_max_size</parameter>.

</simpara>

&ini.shorthandbytes;

<simpara>

Se la dimensione dei dati post è maggiore di post_max_size, le variabili

<link linkend="language.variables.superglobals">superglobale</link>

<varname>$_POST</varname> e <varname>$_FILES</varname>

sono vuote. Questo può essere rilevato in diversi modi, ad esempio passando

una variabile <varname>$_GET</varname> allo script che processa i dati,

tipo <literal>&lt;form action="edit.php?processed=1"&gt;</literal>,

e verificare se <varname>$_GET['processed']</varname> è impostata.

</simpara>

<para>

<note>

<para>

PHP permette di usare le abbreviazioni per i valori byte, tra cui K (kilo), M (mega)

e G (giga). PHP fa una conversione automatica quando si usano queste

abbreviazioni. Si presti attenzione a non eccedere il limite dell'intero signed 32 bit

(se si sta usando una versione a 32 bit) poiché questo farà fallire lo

script.

</para>

</note>

</para>

<para>

<table>

<title>Changelog per <literal>post_max_size</literal></title>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>5.3.4</entry>

<entry>

<parameter>post_max_size</parameter> = 0 non disabiliterà il limite quando il tipo di contenuto

è application/x-www-form-urlencoded o non è registrato con PHP.

</entry>

</row>

<row>

<entry>5.3.2 , 5.2.12</entry>

<entry>

Permette una dimensione post illimitata impostando <parameter>post_max_size</parameter> a 0.

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-prepend-file">

<term>

<parameter>auto_prepend_file</parameter>

<type>string</type>

</term>

<listitem>

<para>

Indica il nome del file che deve essere parsato

prima del file principale. Questo file viene incluso come se fosse

chiamato dalla funzione <function>include</function>, pertanto si utilizza

il parametro <link linkend="ini.include-path">include_path</link>.</para>

<para>

Il valore speciale <literal>none</literal>

disabilita la funzione.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-append-file">

<term>

<parameter>auto_append_file</parameter>

<type>string</type>

</term>

<listitem>

<para>

Specifica il file che deve essere analizzato in automatico

dopo il file principale. Il file è incluso come se fosse

chiamato dalla funzione <function>include</function> pertanto si utilizza

il parametro <link linkend="ini.include-path">include_path</link>.</para>

<para>

Il valore <literal>none</literal>

disabilita l'auto-appending.

<note>

<simpara>

Se lo script termina con <function>exit</function>,

l'auto-accodamento <emphasis>non</emphasis> viene eseguito.</simpara>

</note>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.default-mimetype">

<term>

<parameter>default_mimetype</parameter>

<type>string</type>

</term>

<listitem>

<para>

Per impostazione predefinita, PHP stamperà un media type usando l'header Content-Type.

Per disabilitare questo comportamento, semplicemente settarlo a vuoto.

</para>

<para>

Il media type predefinito di PHP è text/html.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.default-charset">

<term>

<parameter>default_charset</parameter>

<type>string</type>

</term>

<listitem>

<para>

"UTF-8" è il valore di default e il suo valore è usato

come codifica di caratteri predefinita per

<function>htmlentities</function>,

<function>html_entity_decode</function> e

<function>htmlspecialchars</function> se il

parametro <parameter>encoding</parameter> è omesso. Il valore di

<parameter>default_charset</parameter> sarà anche usato per impostare il

carattere predefinito per le funzioni <link linkend="book.iconv">iconv</link>

se le opzioni di configurazione

<link linkend="ini.iconv.input-encoding"><parameter>iconv.input_encoding</parameter></link>,

<link linkend="ini.iconv.output-encoding"><parameter>iconv.output_encoding</parameter></link> and

<link linkend="ini.iconv.internal-encoding"><parameter>iconv.internal_encoding</parameter></link>

non sono settate, e per le funzioni

<link linkend="book.mbstring">mbstring</link> se le opzioni di configurazione

<link linkend="ini.mbstring.http-input"><parameter>mbstring.http_input</parameter></link>

<link linkend="ini.mbstring.http-output"><parameter>mbstring.http_output</parameter></link>

<link linkend="ini.mbstring.internal-encoding"><parameter>mbstring.internal_encoding</parameter></link>

non sono settate.

</para>

<para>

Tutte le versioni di PHP useranno questo valore come codifica di caratteri all'interno

dell'header di default Content-Type inviato da PHP se l'header non è sovrascritto

da una chiamata a <function>header</function>.

</para>

<para>

Impostare <parameter>default_charset</parameter> ad una stringa vuota non

è raccomandato.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.input-encoding">

<term>

<parameter>input_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

Questa impostazione è usata per moduli multibyte

come mbstring e iconv. Il valore predefinito è vuoto.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.output-encoding">

<term>

<parameter>output_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

Questa impostazione è usata per moduli multibyte

come mbstring e iconv. Il valore predefinito è vuoto.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.internal-encoding">

<term>

<parameter>internal_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

Questa impostazione è usata per moduli multibyte

come mbstring e iconv. Il valore predefinito è vuoto. Se vuoto,

viene usato <link linkend="ini.default-charset">default_charset</link>.

</para>