Mercurial > hg > nginx-site
view xml/it/docs/configure.xml @ 1821:4639fa9d7e0a
Alex Kapranoff's book added.
author | Igor Sysoev <igor@sysoev.ru> |
---|---|
date | Wed, 19 Oct 2016 12:11:16 +0000 |
parents | 6303d4e343a8 |
children |
line wrap: on
line source
<!-- Copyright (C) Igor Sysoev Copyright (C) Nginx, Inc. --> <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> <article name="Compilare i sorgenti di nginx" link="/it/docs/configure.html" lang="it" translator="Angelo Papadia" rev="4"> <section> <para> La compilazione si configura tramite il comando <command>configure</command>, che definisce vari aspetti del sistema, fra cui i metodi che nginx puo' usare per processare le connessioni; alla fine viene creato un <path>Makefile</path>. Il comando <command>configure</command> supporta, fra gli altri, i seguenti parametri: <list type="bullet"> <listitem> <para> <literal>--prefix=<value>path</value></literal>— definisce la directory che conterra' i file del server. La medesima directory sara' pure usata per tutti i path relativi definiti da <command>configure</command> (a parte i path ai sorgenti delle librerie) e nel file di configurazione <path>nginx.conf</path>. Per default vale <path>/usr/local/nginx</path>. </para> </listitem> <listitem> <para> <literal>--sbin-path=<value>path</value></literal>— stabilisce il nome del file eseguibile di nginx. Tale valore e' usato solo nel corso dell'installazione. Per default il file eseguibile e' chiamato <path><value>prefix</value>/sbin/nginx</path>. </para> </listitem> <listitem> <para> <literal>--conf-path=<value>path</value></literal>— stabilisce il nome del file di configurazione <path>nginx.conf</path>. In ogni caso, nginx puo' sempre essere avviato con un file di configurazione differente, specificando quest'ultimo tramite il parametro a linea di comando <nobr><literal>-c <value>file</value></literal></nobr>. Per default il file di configurazione e' <path><value>prefix</value>/conf/nginx.conf</path>. </para> </listitem> <listitem> <para> <literal>--pid-path=<value>path</value></literal>— stabilisce il nome del file nginx.pid in cui e' registrato l'ID del processo principale. Dopo l'installazione, il nome del file puo' sempre essere modificato tramite la direttiva <link doc="ngx_core_module.xml" id="pid"/> del file di configurazione <path>nginx.conf</path>. Per default il file contenente il pid e' <path><value>prefix</value>/logs/nginx.pid</path>. </para> </listitem> <listitem> <para> <literal>--error-log-path=<value>path</value></literal>— stabilisce il nome del principale file di diagnostica in cui sono registrati gli errori e gli avvisi. Dopo l'installazione, il nome del file puo' sempre essere modificato tramite la direttiva <link doc="ngx_core_module.xml" id="error_log"/> del file di configurazione <path>nginx.conf</path>. Per default il file degli errori e' <path><value>prefix</value>/logs/error.log</path>. </para> </listitem> <listitem> <para> <literal>--http-log-path=<value>path</value></literal>— stabilisce il nome del principale file di log delle richieste al server HTTP. Dopo l'installazione, il nome del file puo' sempre essere modificato tramite la direttiva <link doc="http/ngx_http_log_module.xml" id="access_log"/> del file di configurazione <path>nginx.conf</path>. Per default il file di log delle richieste e' <path><value>prefix</value>/logs/access.log</path>. </para> </listitem> <listitem> <para> <literal>--user=<value>name</value></literal>— stabilisce il nome di un utente non privilegiato le cui credenziali saranno usate dai processi worker. Dopo l'installazione, l'utente puo' sempre essere modificato tramite la direttiva <link doc="ngx_core_module.xml" id="user"/> del file di configurazione <path>nginx.conf</path>. L'utente di default e' nobody. </para> </listitem> <listitem> <para> <literal>--group=<value>name</value></literal>— stabilisce il nome di un gruppo le cui credenziali saranno usate dai processi worker. Dopo l'installazione, il gruppo puo' sempre essere modificato tramite la direttiva <link doc="ngx_core_module.xml" id="user"/> del file di configurazione <path>nginx.conf</path>. Per default il gruppo e scelto fra uno di quelli degli utenti non priviliegiati. </para> </listitem> <listitem> <para> <literal>--with-select_module</literal><br/> <literal>--without-select_module</literal>— abilita o disabilita la compilazione del modulo che consente al server di utilizzare il metodo <c-func>select</c-func>. Tale modulo e' compilato automaticamente nel caso in cui la piattaforma non supporti metodi piu' appropriati, quali kqueue, epoll, rtsig, o /dev/poll. </para> </listitem> <listitem> <para> <literal>--with-poll_module</literal><br/> <literal>--without-poll_module</literal>— abilita o disabilita la compilazione del modulo che consente al server di utilizzare il metodo <c-func>poll</c-func>. Tale modulo e' compilato automaticamente nel caso in cui la piattaforma non supporti metodi piu' appropriati, quali kqueue, epoll, rtsig, o /dev/poll. </para> </listitem> <listitem> <para> <literal>--without-http_gzip_module</literal>— disabilita la compilazione del modulo che <link doc="http/ngx_http_gzip_module.xml">comprime le risposte</link> del server HTTP. Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria zlib. </para> </listitem> <listitem> <para> <literal>--without-http_rewrite_module</literal>— disabilita la compilazione del modulo che consente al server HTTP di <link doc="http/ngx_http_rewrite_module.xml">redirigere e cambiare l'URI delle richieste</link>. Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria PCRE. </para> </listitem> <listitem> <para> <literal>--without-http_proxy_module</literal>— disabilita la compilazione del <link doc="http/ngx_http_proxy_module.xml">modulo di proxy</link> del server HTTP. <!-- The MD5 library is required to build and run this module. --> </para> </listitem> <listitem> <para> <literal>--with-http_ssl_module</literal>— abilita la compilazione del modulo che aggiunge al server HTTP il <link doc="http/ngx_http_ssl_module.xml">supporto al protocollo HTTPS</link>. Per default tale modulo non e' compilato. Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria OpenSSL. </para> </listitem> <listitem> <para> <literal>--with-pcre=<value>path</value></literal>— indica il path ai sorgenti della libreria PCRE. E' necessario scaricare dal sito di <link url="http://www.pcre.org">PCRE</link> la distribuzione della libreria (versioni da 4.4 a 8.32), ed estrarla. Al resto ci pensano i comandi <command>./configure</command> e <command>make</command> di nginx. La libreria e' richiesta per il supporto alle espressioni regolari nella direttiva <link doc="http/ngx_http_core_module.xml" id="location"/> e per il modulo <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>. </para> </listitem> <listitem> <para> <literal>--with-pcre-jit</literal>— compila la libreria PCRE con il supporto “just-in-time" (1.1.12, direttiva <link doc="ngx_core_module.xml" id="pcre_jit"/>). </para> </listitem> <listitem> <para> <literal>--with-zlib=<value>path</value></literal>— indica il path ai sorgenti della libreria zlib. E' necessario scaricare dal sito di <link url="http://zlib.net">zlib</link> la distribuzione della libreria (versioni da 1.1.3 a 1.2.7), ed estrarla. Al resto ci pensano i comandi <command>./configure</command> e <command>make</command> di nginx. La libreria e' richiesta per il modulo <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>. </para> </listitem> <listitem> <para> <literal>--with-cc-opt=<value>parameters</value></literal>— definisce i parametri che saranno aggiunti alla variabile CFLAGS. Nel caso in cui si stia usando la libreria PCRE in ambiente FreeBSD, bisognerebbe specificare <literal>--with-cc-opt="-I /usr/local/include"</literal>. Se il numero di file supportati da <c-func>select</c-func> deve essere incrementato, e' possibile farlo anche con questo parametro, ad esempio con: <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. </para> </listitem> <listitem> <para> <literal>--with-ld-opt=<value>parameters</value></literal>— definisce i parametri aggiuntivi che saranno usati durante il linking. Nel caso in cui si stia usando la libreria PCRE in ambiente FreeBSD, bisognerebbe specificare <literal>--with-ld-opt="-L /usr/local/lib"</literal>. </para> </listitem> </list> </para> <para> Un esempio d'uso dei parametri (da scrivere tutti su un'unica linea): <programlisting> ./configure --sbin-path=/usr/local/nginx/nginx --conf-path=/usr/local/nginx/nginx.conf --pid-path=/usr/local/nginx/nginx.pid --with-http_ssl_module --with-pcre=../pcre-4.4 --with-zlib=../zlib-1.1.3 </programlisting> </para> <para> Dopo la configurazione, nginx e' compilato ed installato tramite il comando <command>make</command>. </para> </section> </article>