cvs: phpdoc-it /chapters install.apache.xml install.apache2.xml install.caudium.xml install.commandline.xml install.configure.databases.xml
install.configure.graphics.xml install.configure.misc.xml install.configure.php.xml install.fhttpd.xml install.general.xml install.hpux.xml
install.iis.xml install.linux.xml
| From: | Andrioli Darvin | Date: | Fri, 11 Jul 2003 19:47:11 +0000 |
| Subject: | cvs: phpdoc-it /chapters install.apache.xml install.apache2.xml install.caudium.xml install.commandline.xml install.configure.databases.xml install.configure.graphics.xml install.configure.misc.xml install.configure.php.xml install.fhttpd.xml install.general.xml install.hpux.xml install.iis.xml install.linux.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-420@lists.php.net to get a copy of this message | ||
darvina Fri Jul 11 15:47:11 2003 EDT
Added files:
/phpdoc-it/chapters install.apache.xml install.apache2.xml
install.caudium.xml install.commandline.xml
install.configure.databases.xml
install.configure.graphics.xml
install.configure.misc.xml
install.configure.php.xml install.fhttpd.xml
install.general.xml install.hpux.xml
install.iis.xml install.linux.xml
Log:
Initail translation
Index: phpdoc-it/chapters/install.apache.xml +++ phpdoc-it/chapters/install.apache.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.18 Maintainer: darvina Status: ready --> <sect1 id="install.apache"> <title>Server-Apache</title> <para> Questa sezione contiene note e suggerimenti specifici dell'installazione di PHP con server Apache, sia per le versioni <link linkend="install.apache.unix">Unix</link> sia per le versioni <link linkend="install.apache.windows">Windows</link>. Esiste, inoltre, una pagina separata per le <link linkend="install.apache2">istruzioni e note su Apache 2</link>. </para> <sect2 id="install.apache.unix"> <title>Dettagli sull'installazione di PHP con Apache su Unix</title> <para> Si possono selezionare gli argomenti da aggiungere al comando <command>configure</command> di linea 10 dalla <link linkend="install.configure">Lista completa delle opzioni di configurazione</link>. In queste note viene omesso il numero di versione per evitare di avere istruzioni non corrette. Nella realtà occorre sostituire 'xxx' con i valori di versione corretti. </para> <example id="install.apache.unix.longer"> <title> Istruzioni per l'installazione (versione di Apache con modulo condiviso) di PHP 4. </title> <screen> <![CDATA[ 1. gunzip apache_xxx.tar.gz 2. tar -xvf apache_xxx.tar 3. gunzip php-xxx.tar.gz 4. tar -xvf php-xxx.tar 5. cd apache_xxx 6. ./configure --prefix=/www --enable-module=so 7. make 8. make install 9. cd ../php-xxx 10. ./configure --with-mysql --with-apxs=/www/bin/apxs 11. make 12. make install Se si decide di cambiare le opzioni di configurazione dopo l'installazione occorre ripere gli ultimi tre passi. Per attivare il nuovo modulo occorre riavviare Apache. Non è richiesta la ricompila di Apache. 13. cp php.ini-dist /usr/local/lib/php.ini Si può modificare il file .ini per impostare le opzioni di PHP. Se si desidera avere questo file in un'altra directory, utilizzare --with-config-file-path=/percorso al punto 10. 14. Modificare httpd.conf o srm.conf e verificare che le seguenti linee siano presenti e non commentate: AddType application/x-httpd-php .php LoadModule php4_module libexec/libphp4.so Qui si può selezionare qualsiasi estensione si esideri. .php è semplicemente quella che suggeriamo. Si possono includere anche le estensioni .html e .php3 per compatibilità verso il passato. Il percorso indicato nella parte destra dell'istruzione LoadModule deve puntare alla directory in cui è presente il modulo PHP. L'istruzione precedente è corretta rispetto ai passi illustrati sino qui. 15. Utilizzare le normali procedure per avviare il server Apache. (Occorre riavviare il server, e non forzare una ricarica tramite i segnali HUP o USR1.) ]]> </screen> </example> <para> In base all'installazione di Apache e al tipo di Unix, esistono vari modi per fermare e avviare il server. Di seguito saranno illustrati alcuni metodi tipici per riavviare il server in differenti configurazioni di Apache/unix. Si deve sostituire <literal>/path/to/</literal> con il percorso in cui risiedono queste applicazioni nel sistema. <informalexample> <screen> <![CDATA[ 1. Diverse varianti di Linux e SysV: /etc/rc.d/init.d/httpd restart 2. Utilizzando apachectl: /path/to/apachectl stop /path/to/apachectl start 3. httpdctl e httpsdctl (tramite OpenSSL), simile a apachectl: /path/to/httpsdctl stop /path/to/httpsdctl start 4. Usando mod_ssl, o un'altro server SSL, si può fermare e riavviare il server manualmente: /path/to/apachectl stop /path/to/apachectl startssl ]]> </screen> </informalexample> La directory degli eseguibili apachectl e http(s)dctl spesso varia. Se nel sistema esistono i comandi <literal>locate</literal> oppure <literal>whereis</literal> oppure <literal>which</literal>, si possono utilizzare per localizzare i programmi di controllo del server. </para> <para> Di seguito saranno illustrati differenti esempi di compila di PHP per Apache: <informalexample> <programlisting role="shell"> <![CDATA[ /configure --with-apxs --with-pgsql ]]> </programlisting> </informalexample> </para> <para> Questo crea la libreria condivisa <filename>libphp4.so</filename> che è il modulo caricato da Apache tramite la linea LoadModule del file &httpd.conf;. Il supporto a PostgreSQL è compreso nella libreria <filename>libphp4.so</filename>. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apxs --with-pgsql=shared ]]> </programlisting> </informalexample> </para> <para> Questo crea la libreria condivisa <filename>libphp4.so</filename> per Apache, ma crea anche una libreria condivisa <filename>pgsql.so</filename> che viene caricata in PHP o tramite le direttive del &php.ini; o caricata direttamente dallo script tramite la funzione <function>dl</function>. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql ]]> </programlisting> </informalexample> </para> <para> Questo crea una libreria <filename>libmodphp4.a</filename>, un file <filename>mod_php4.c</filename> e altri file di contorno e li copia nella directory <literal>src/modules/php4</literal> nell'albero dei sorgenti di Apache. Quindi si può compilare Apache utilizzando <literal>--activate-module=src/modules/php4/libphp4.a</literal> e quindi il sistema di compila di Apache creerà il file <filename>libphp4.a</filename> e lo includerà staticamente nell'eseguibile <filename>httpd</filename>. Il supporto per PostgreSQL verrà incluso direttamente in questo <filename>httpd</filename>, pertanto si avrà un unico eseguibile <filename>httpd</filename> comprendente tutto Apache e tutto il PHP. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql=shared ]]> </programlisting> </informalexample> </para> <para> Come l'istruzione precedente, tranne che invece di includere PostgreSQL direttamente nel file finale <filename>httpd</filename>, si avrà una libreria condivisa <filename>pgsql.so</filename> che può essere caricata in PHP o tramite le direttive del &php.ini; o direttamente dallo script tramite la funzione <function>dl</function>. </para> <para> Quando si compila il PHP nei differenti modi, si dovrebbe considerare i vantaggi e gli svantaggi di ciascun metodo. Compilarlo come libreria condivisa permette di compilare Apache separatamente, e quindi non si ha la necessità di ricompilarlo ogni volta che si desideri cambiare il PHP. Compilare il PHP all'interno di Apache (in modo statico) permette al PHP di essere caricato ed eseguito più velocemente. Per maggiori dettagli vedere la pagian di Apache sul <ulink url="&url.apachedso;">supporto DSO</ulink>. </para> <note> <para> Attaulmente il file &httpd.conf; fornito di default contiene una sezione come la seguente: <informalexample> <programlisting> <![CDATA[ User nobody Group "#-1" ]]> </programlisting> </informalexample> A meno che non venga cambiata in "Group nogroup" o qualcosa di simile (è anche comune l'uso di "Group daemon") il PHP non sarà in grado di aprire i file. </para> </note> <note> <para> Accertarsi di avere specificato la versione di apxs installate quando si usa <option role="configure">--with-apxs=/path/to/apxs</option>. NON usare la versione di apxs presente nei sorgenti di Apache, ma quella installata nel sistema. </para> </note> </sect2> <sect2 id="install.apache.windows"> <title>Installazione di PHP su Windows con Apache 1.3.x</title> <simpara> Esistono due metodi per installare PHP e Apache 1.3.x in Windows. Uno consiste nell'utilizzare l'eseguibile CGI (php.exe), la seconda consiste nell'usare il modulo DLL per Apache. In entrambi i casi occorre fermare il server Apache, editare il file &httpd.conf; per indicare ad Apache di utilizzare PHP. </simpara> <simpara> Occorre notare che ora il modulo SAPI sotto Windows è stato reso molto più stabile, noi raccomandiamo l'uso di questo piuttosto che l'eseguibile CGI poichè è molto più trasparente e sicuro. </simpara> <simpara> Sebbene vi possano essere alcune varianti nella configurazione di PHP con Apache, queste sono abbastanza semplici da essere utilizzate dai neofiti. Consultare la documentazione di Apache per maggiori dettagli sulle direttive di configurazione. </simpara> <para> Se si decomprime il pacchetto PHP nella directory <filename>c:\php\</filename> come descritto nella sezione <link linkend="install.windows.manual">Passi per l'installazione manuale</link>, occorre inserire queste linee nella configurazione di Apache per attivare l'eseguibile CGI: <itemizedlist> <listitem> <simpara> <literal> ScriptAlias /php/ "c:/php/" </literal> </simpara> </listitem> <listitem> <simpara> <literal> AddType application/x-httpd-php .php .phtml </literal> </simpara> </listitem> <listitem> <simpara> <literal> Action application/x-httpd-php "/php/php.exe" </literal> </simpara> </listitem> </itemizedlist> Occorre rilevare che la seconda riga può essere presente nelle nuove versioni di &httpd.conf;, ma è commentata. Ricordarsi, inoltre, di sostituire <filename>c:/php/</filename> con la corretta directory del PHP. </para> <warning> <para> Utilizzando la configurazione CGI, il server è aperto a possibili attacchi. Leggere il capitolo <link linkend="security.cgi-bin">CGI security </link> per imparare a difendersi da questi attacchi. </para> </warning> <para> Se si desidera utilizzare PHP come modulo di Apache, occorre copiare <filename>php4ts.dll</filename> nella directory <filename>windows/system</filename> (per Windows 9x/Me), <filename>winnt/system32</filename> (per Windows NT/2000) o <filename>windows/system32</filename> (per Windows XP) sostituendo ogni vecchio file. Quindi si deve aggiungere le seguenti linee al file &httpd.conf; <itemizedlist> <listitem> <simpara> Aprire &httpd.conf; con l'editor preferito e localizzare la direttiva <literal>LoadModule</literal> e aggiungere la seguente linea <emphasis>alla fine</emphasis> dell'elenco: <literal>LoadModule php4_module c:/php/sapi/php4apache.dll</literal> </simpara> </listitem> <listitem> <simpara> Si può rilevare che, dopo l'uso dell'installatore di Apache, occorre definire la direttiva <literal>AddModule</literal> per <filename>mod_php4.c</filename>. Questa è particolarmente importante se viene definita la direttiva <literal>ClearModuleList</literal>, che può essere trovata più sotto di qualche riga. Quando si troverà l'elenco delle istruzioni <literal>AddModule</literal>, aggiungere la seguente linea <emphasis>alla fine</emphasis> dell'elenco: <literal>AddModule mod_php4.c</literal>. </simpara> </listitem> <listitem> <simpara> Cercare una frase simile a <literal># AddType allows you to tweak mime.types</literal>. Si troverà alcune righe tipo <literal>AddType</literal>, aggiungere la seguente linea <emphasis>alla fine</emphasis> dell'elenco: <literal>AddType application/x-httpd-php .php</literal>. Si può scegliere qualsiasi estensione si desideri elaborare tramite PHP. Da parte nostra suggeriamo .php. Si può anche includere .html e .php3 per avere compatibilità con il passato. </simpara> </listitem> </itemizedlist> </para> <simpara> Dopo avere cambiato il file di configurazione, ricordarsi di riavviare il server, ad esempio, <command>NET STOP APACHE</command> seguito da <command>NET START APACHE</command>, se si esegue Apache come servizio di Windows, oppure utilizzare le opportune icone. </simpara> <simpara> Esistono due metodi per attivare la funzionalità di visualizzazione del sorgente; tuttavia il loro funzionamento dipende dall'installazione. Se si ha configurato Apache per utilizzare PHP come modulo SAPI, allora aggiungendo la seguente linea al file &httpd.conf; (nello stesso punto in cui si è inserito <literal>AddType application/x-httpd-php .php</literal>) si può attivare questa caratteristica: <literal>AddType application/x-httpd-php-source .phps</literal>. </simpara> <simpara> Se si è scelto di configurare Apache per utilizzare PHP come eseguibile CGI, allora occorre utilizzare la funzione <function>show_source</function>. Per ottenere ciò creare uno script PHP e aggiungere questa riga: <literal><?php show_source ("original_php_script.php"); ?></literal>. Sostituire <literal>original_php_script.php</literal> con il nome del file di cui si vuole vedere il sorgente. </simpara> <note> <simpara> Nella versione Windows di Apache tutti i backslash nelle righe con percorsi tipo "c:\directory\file.ext", devono essere sostituiti con lo slash, tipo "c:/directory/file.ext". </simpara> </note> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.apache2.xml +++ phpdoc-it/chapters/install.apache2.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.12 Maintainer: darvina Status: ready --> <sect1 id="install.apache2"> <title>Server-Apache 2.0</title> <para> Questa sezione contiene note e suggerimenti specifici per l'installazione di <literal>PHP</literal>, con Apache 2.0, sia per sistemi <link linkend="install.apache2.unix">Unix</link> sia per sistemi <link linkend="install.apache2.windows">Windows</link>. </para> <warning> <para> Non utilizzare Apache 2.0 e <literal>PHP</literal> in ambienti di produzione sia con Unix sia con Windows. </para> </warning> <para> Riteniamo sia opportuno dare uno sguardo alla <ulink url="&url.apache2.docs;">Documentazione di Apache</ulink> per avere le nozioni di base per comprendere Apache 2.0. </para> <sect2 id="compat.apache2"> <title>Note di compatibilità tra PHP e Apache 2.0</title> <para> Se seguente versioni di PHP funzionano correttamente con le ultime versioni di Apache 2.0: <itemizedlist spacing="compact"> <listitem> <simpara> PHP 4.3.0 o successive , disponibili a <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. </simpara> </listitem> <listitem> <simpara> l'ultima versione stabile dell'ambiente di sviluppo. Per ottenere il sorgente aggiornato <ulink url="&url.php.snapshots;php4-latest.tar.gz"> &url.php.snapshots;php4-latest.tar.gz</ulink> o per scaricare gli eseguibili per Windows <ulink url="&url.php.snapshots;win32/php4-win32-latest.zip"> &url.php.snapshots;win32/php4-win32-latest.zip</ulink>. </simpara> </listitem> <listitem> <simpara> la versione di pre-rilascio, disponibile in <ulink url="&url.php.prerelease;">&url.php.prerelease;</ulink>. </simpara> </listitem> <listitem> <simpara> inoltre si ha sempre la possibilità di avere il <literal>PHP</literal> tramite il <ulink url="&url.php.anoncvs;">CVS anonimo</ulink>. </simpara> </listitem> </itemizedlist> Queste versioni di <literal>PHP</literal> sono compatibili con Apache 2.0.40 e successive. </para> <note> <simpara> Il supporto tramite <literal>SAPI</literal> ad Apache 2.0 è cominciato da 4.2.0. PHP 4.2.3 funziona con Apache 2.0.39, non utilizzare nessuna altra versione di Apache con PHP 4.2.3. Tuttavia si raccomanda di utilizzare il PHP 4.3.0, o successivo, con la più recente versione di Apache2. </simpara> <simpara> Tutte le versioni di <literal>PHP</literal> menzionate, lavorano con Apache 1.3.x. </simpara> </note> </sect2> <sect2 id="install.apache2.unix"> <title>PHP e Apache 2 su Linux</title> <para> Scaricare la più recente versione di <ulink url= "&url.apache;"> Apache 2.0</ulink> e la versione di PHP dai siti menzionati in precendenza. Questa guida rapida copre soltanto le basi per partire con Apache 2.0 e <literal>PHP</literal>. Per maggiori dettagli leggere la <ulink url="&url.apache2.docs;">documentazione di Apache</ulink>. In questo esempio è stata omesso il numero di versione per evitare problemi nelle istruzioni presentate. Nell'installazione reale occorre sostituire 'NN' con il corretto numero della versione installata. </para> <example> <title> Istruzioni per l'installazione (Apache 2 con modulo condiviso) </title> <screen> <![CDATA[ 1. gzip -d httpd-2_0_NN.tar.gz 2. tar xvf httpd-2_0_NN.tar 3. gunzip php-NN.tar.gz 4. tar -xvf php-NN.tar 5. cd httpd-2_0_NN 6. ./configure --enable-so 7. make 8. make install A questo punto si ha Apache 2.0 disponibile in /usr/local/apache2, configurato con il supporto dei moduli caricabili. Per testare l'installazione utilizzare la solita procedura per attivare il server Apache, es.: /usr/local/apache2/bin/apachectl start e quindi fermare il server per attivare la configurazione con PHP: /usr/local/apache2/bin/apachectl stop. 9. cd ../php4-NN 10. ./configure --with-apxs2=/usr/local/apache2/bin/apxs 11. make 12. make install 13. cp php.ini-dist /usr/local/lib/php.ini Modificare il php.ini per impostare le opzioni di PHP. Se si desidera pozionare questo file in altra directory, utilizzare --with-config-file-path=/path al passo 10. 14. Modificare httpd.conf e verificare la presenza delle seguenti linee: LoadModule php4_module modules/libphp4.so AddType application/x-httpd-php .php Si può segliere qualsiasi estensione di desideri. Il nostro suggerimento è di utilizzare .php. Il percorso indicato nel lato destro della riga LoadModule deve puntare al percorso in cui si trova il modulo PHP. L'esempio illustrato è coerente con i parametri sin qui impostati. 15. Utilizzare la solita procedura per avviare Apache, es.: /usr/local/apache2/bin/apachectl start ]]> </screen> </example> <para> Seguendo i passi illustrati si ottiene un server Apache 2.0 funzionante con il supporto <literal>PHP</literal> come modulo <literal>SAPI</literal>. Ovviamente esistono molte altre opzioni di configurazione sia per Apache sia per <literal>PHP</literal>. Per maggiori dettagli utilizzare <command>./configure --help</command> nei sorgenti di ciascun prodotto. Nel caso si desideri compilare la versione multithread di Apache 2.0 occorre sovrascrivere il modulo MPM standard <filename>prefork</filename> con <filename>worker</filename> o con <filename>perchild</filename>. Per ottenere ciò accodare alla linea di configurazione indicata nel passo 6 l'opzione <option role="configure">--with-mpm=worker</option> o <option role="configure">--with-mpm=perchild</option>. Occorre essere consapevoli delle conseguenze di ciò che si sta facendo. Per maggiori dettagli leggere la documenatzione di Apache sul <ulink url="&url.apache2.mpm;"> modulo MPM</ulink>. </para> <note> <para> Per potere compilare la versione multithread di Apache occorre che il sistema supporti i thread. Questo implica la compila di <literal>PHP</literal> con il modulo sperimentale Zend Thread Safety (ZTS). Pertanto non tutte le estensioni potranno essere disponibili. Si raccomanda, quindi, di compilare Apache con il modulo MPM standard <filename>prefork</filename>. </para> </note> </sect2> <sect2 id="install.apache2.windows"> <title>PHP e Apache 2.0 su Windows</title> <para> Si consideri di leggere le <ulink url="&url.apache2.windows;"> note specifiche per Windows</ulink> di Apache 2.0. </para> <warning> <para> Apache 2.0 è concepito per essere eseguito su Windows NT 4.0, Windows 2000 oppure Windows XP. In questo momento il supporto per Windows 9x è incompleto. Al momento non ci si aspetta che Apache 2.0 funzioni su quest'ultime piattaforme. </para> </warning> <para> Scaricare la più recente versione di <ulink url= "&url.apache;"> Apache 2.0</ulink> e la versione di PHP dai siti menzionati in precendenza. Seguire i <link linkend="install.windows.manual">passi per l'installazione manuale</link> e tornare a questo pagina per integrare il <literal>PHP</literal> con Apache. </para> <para> Esistono due metodi per configurare <literal>PHP</literal> e Apache 2.0 su Windows. Uno consiste nell'uso dell'eseguibile CGI, l'altro consiste nell'utilizzo del modulo DLL per Apache. In entrambi i casi occorre fermare Apache, modificare il file &httpd.conf; per configurare Apache. </para> <para> Occorre inserire queste tre linee nel file di configurazione &httpd.conf; di Apache per impostare l'<emphasis>eseguibile CGI</emphasis>: <example> <title>PHP con Apache 2.0 come CGI</title> <programlisting role="apache"> <![CDATA[ ScriptAlias /php/ "c:/php/" AddType application/x-httpd-php .php Action application/x-httpd-php "/php/php.exe" ]]> </programlisting> </example> </para> <para> Se si desidera utilizzare il <literal>PHP</literal> come modulo di Apache 2.0, occorre copiare <filename>php4ts.dll</filename> nella directory <filename>winnt/system32</filename> (per Windows NT/2000) o <filename>windows/system32</filename> (per Windows XP), sovrascrivendo gli eventuali vecchi file. Quindi occorre inserire queste due righe nel file di configurazione di Apache &httpd.conf; per impostare il <emphasis>modulo PHP</emphasis> <example> <title>PHP su Apache 2.0 come Modulo</title> <programlisting role="apache"> <![CDATA[ LoadModule php4_module "c:/php/sapi/php4apache2.dll" AddType application/x-httpd-php .php ]]> </programlisting> </example> </para> <note> <simpara> Nei precedenti esempi ricordarsi di sostituire <filename>c:/php/</filename> con il percorso al<literal>PHP</literal>. Prestare attenzione di avere impostato <filename>php4apache2.dll</filename> nella direttiva LoadModule e <emphasis>non</emphasis><filename>php4apche.dll</filename>. Quest'ultimo è utilizzato per Apache 1.3.x. </simpara> </note> <warning> <simpara> Non mischiare i file dll da <emphasis>differenti versioni di PHP</emphasis>. Si ha solo la possibilità di utilizzare le dll e le estensioni fornite con la versione scaricata. </simpara> </warning> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.caudium.xml +++ phpdoc-it/chapters/install.caudium.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <sect1 id="install.caudium"> <title>Server-Caudium</title> <para> Il PHP 4 può essere compilato come module Pike per il <ulink url="&url.caudium;">server web Caudium</ulink>. Attenzione: non è supportato dal Php 3. Seguire le seguenti istruzioni per installare il PHP 4 con Caudium. </para> <example id="install.caudium.instructions"> <title>Istruzioni di installazione per Caudium</title> <screen> <![CDATA[ 1. Essere certi di avere installato Caudium prima di installare il PHP 4. Il Php per potere funzionare ha bisogno di Pike versione 7.0.268 o successive. Per praticità di illustrazione in questo esempio assumeremo che Caudium sia installato in /opt/caudium/server/. 2. Posizionarsi nella directory php-x.y.z (dove x.y.z è il numero di versione). 3. ./configure --with-caudium=/opt/caudium/server 4. make 5. make install 6. Riavviare Caudium se è attivo. 7. Entrare nell'interfaccia grafica di configurazione e andare nella sezione virtual server da dove si inserirà il PHP. 8. Cliccare su Add Module localizzare e aggiungere il modulo PHP 4 Script Suppor. 9. Se la documentazione informa che 'PHP 4 interpreter isn't available', verificare di avere riavviato il server. Se lo si è fatto, cercare nel file /opt/caudium/logs/debug/default.1 la presenza di errori collegati a <filename>PHP4.so</filename>. Verificare anche la presenza del file <filename>caudium/server/lib/[pike-version]/PHP4.so</filename>. 10. Configurare il modulo PHP Script Support se necessario.. ]]> </screen> </example> <para> Si può compilare il modulo per Caudium con il supporto dei vari moduli disponibili per PHP 4, Vedere la <link linkend="install.configure">lista completa delle opzioni di configurazione options</link> per maggiori informazioni. </para> <note> <para> Quando si compila il PHP con il supporto a MySQL occorre essere certi di utilizzare il normale client di MySQL. Altrimenti si possono verificare del conflitti se Pike supporta MySQL. Per fare ciò occorre specificare la directory di installazione di MySQL nell'opzione <option role="configure"> --with-mysql</option>. </para> </note> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.commandline.xml +++ phpdoc-it/chapters/install.commandline.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <sect1 id="install.commandline"> <title>Servers-CGI/linea di comando</title> <para> Per default il PHP viene compilato come programma CGI. Ciò crea un interprete di linea di comando che può essere utilizzato sia per elaborazioni CGI sia per script non connessi con il web. Se si utilizza un server web il PHP ha dei moduli atti allo scopo, questa dovrebbe essere la soluzione preferenziale per ragioni di performance. Tuttavia la versione CGI permette agli utenti di Apache di eseguire pagine PHP sotto differenti user id. Se si desidera utilizzare il PHP come CGI è opportuno leggere con attenzione il capitolo <link linkend="security.index">Security chapter</link> </para> <para> Dalla versione 4.3.0 di PHP sono state inserite nuove caratteristiche. Una nuova SAPI, chiamata CLI, è stata aggiunta è ha lo stesso nome dell'eseguibile CGI. Che cosa si installa nella directory <literal>{PREFIX}/bin/php</literal> dipende dalla line di configurazione, ciò è descritto dettagliatamente nel capitolo <link linkend="features.commandline">Uso del PHP da linea di comando </link>. Per maggiori dettagli leggere quel capitolo del manuale. </para> <sect2 id="install.commandline.testing"> <title>Testing</title> <simpara> Se si ha compilato il PHP come programma CGI, si può testare l'eseguibile eseguendo <command>make test</command>. E' sempre una buona norma testare l'eseguibile che si è appena compilato. In questo modo si possono intercettare immediatamente eventuali problemi relativi alla piattaforma e non impazzire in una fase successiva. </simpara> </sect2> <sect2 id="install.commandline.benchmarking"> <title>Benchmarking</title> <simpara> Se si compila il PHP 3 come programma CGI, si possono eseguire dei banchmark digitando <command>make bench</command>. Occorre notare che se si è abilitato il &safemode; il benchmark non è in grado di concludersi correttamente se richiede più di 30 secondi. Questo perchè la funzione &safemode; non può utilizzare la funzione <function>set_time_limit</function>. Utilizzare il parametro <link linkend="ini.max-execution-time">max_execution_time</link> per impostare il tempo massimo di esecuzione di uno script. Il comando <command>make bench</command> ignora il <link linkend="configuration.file">file di configurazione</link>. </simpara> <note> <simpara> <command>make bench</command> è soltanto disponibile per PHP 3. </simpara> </note> </sect2> <sect2 id="install.commandline.using-variables"> <title>Utilizzo delle variabili</title> <simpara> Alcuni server passano delle variabili d'ambiente che non sono definite nelle specifiche <ulink url="&url.cgispec;">CGI/1.1</ulink>. Soltanto le seguenti variabili sono standard, tutte le altre sono da considerarsi come estensioni del fornitore: AUTH_TYPE, CONTENT_LENGTH, CONTENT_TYPE, GATEWAY_INTERFACE, PATH_INFO, PATH_TRANSLATED, QUERY_STRING, REMOTE_ADDR, REMOTE_HOST, REMOTE_IDENT, REMOTE_USER, REQUEST_METHOD, SCRIPT_NAME, SERVER_NAME, SERVER_PORT, SERVER_PROTOCOL e SERVER_SOFTWARE </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.databases.xml +++ phpdoc-it/chapters/install.configure.databases.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.databases"> <title>Database options</title> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.graphics.xml +++ phpdoc-it/chapters/install.configure.graphics.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <sect3 id="install.configure.options.graphics"> <title>Opzioni grafiche</title> <variablelist> <varlistentry id="install.configure.with-imagick"> <term> <parameter>--with-imagick</parameter> </term> <listitem> <para> L'estensione imagick è stata spostata da PECL a PEAR e può essere reperita <ulink url="&url.php.pear;imagick">qui</ulink>. Le istruzioni per l'installazione possono essere reperite nel sito di PEAR. </para> <para> Soltanto l'opzione <literal>--with-imagick</literal> è supportata da PHP 3 a meno di non seguire le istruzioni presenti nel sito di PEAR. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.misc.xml +++ phpdoc-it/chapters/install.configure.misc.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <sect3 id="install.configure.options.misc"> <title>Opzioni varie</title> <variablelist> <varlistentry id="install.configure.enable-debug"> <term> <parameter>--enable-debug</parameter> </term> <listitem> <para> Compila con il simbolico per il debug. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-layout"> <term> <parameter>--with-layout=TYPE</parameter> </term> <listitem> <para> Imposta come dovranno essere disposti i file installati. Utilizzare PHP (default) o GNU. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pear"> <term> <parameter>--with-pear=DIR</parameter> </term> <listitem> <para> Installa PEAR in DIR (default PREFIX/lib/php). </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-pear"> <term> <parameter>--without-pear</parameter> </term> <listitem> <para> Non installa PEAR. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sigchild"> <term> <parameter>--enable-sigchild</parameter> </term> <listitem> <para> Abilita la gestione del segnale SIGCHLD da parte di un modulo proprio del PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> Disabilità il passaggio di directory addizionali per la ricerche delle librerie. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-libgcc"> <term> <parameter>--enable-libgcc</parameter> </term> <listitem> <para> Abilita esplicitamente il link nei confronti di libgcc. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-php-streams"> <term> <parameter>--enable-php-streams</parameter> </term> <listitem> <para> Include il modulo sperimentale degli streams. Non utilizzarlo a meno di non volere eseguire dei test. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> <parameter>--with-zlib-dir=<DIR></parameter> </term> <listitem> <para> Specificare la directory di installzaione di zlib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-trans-sid"> <term> <parameter>--enable-trans-sid</parameter> </term> <listitem> <para> Abilita la propagazione trasparente dell'id di sessione. Questa opzione è valida per il PHP 4.1.2 o precedenti. Dalla versione 4.2.0 l'opzione trans-sid è sempre compilata. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pthreads"> <term> <parameter>--with-tsrm-pthreads</parameter> </term> <listitem> <para> Utilizza i threads POSIX (default). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> Compila con librerie condivise [default=yes]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-static"> <term> <parameter>--enable-static[=PKGS]</parameter> </term> <listitem> <para> Compila con librerie statiche [default=yes]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> <parameter>--enable-fast-install[=PKGS]</parameter> </term> <listitem> <para> Ottimizza per un'installazione rapida [default=yes]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gnu-ld"> <term> <parameter>--with-gnu-ld</parameter> </term> <listitem> <para> Assume che il compilatore C utilizzi GNU ld [default=no]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-libtool-lock"> <term> <parameter>--disable-libtool-lock</parameter> </term> <listitem> <para> Impedisce il locking (può interrompere compile parallele). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pic"> <term> <parameter>--with-pic</parameter> </term> <listitem> <para> Tenta di utilizzare soltanto oggetti PIC/non-PIC [default=use both]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-memory-limit"> <term> <parameter>--enable-memory-limit</parameter> </term> <listitem> <para> Compila con il supporto al limite di memoria. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-url-fopen-wrapper"> <term> <parameter>--disable-url-fopen-wrapper</parameter> </term> <listitem> <para> Disabilita il supporto agli URL per fopen che permette l'accesso ai file via HTTP o FTP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning.php4"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> Esporta soltanto i simboli richiesti. Vedere INSTALL per maggiori dettagli. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ismp"> <term> <parameter>--with-imsp[=DIR]</parameter> </term> <listitem> <para> Include il supporto a IMSp (DIR indica la directory con gli include di IMSP's e con libimsp.a. Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mck"> <term> <parameter>--with-mck[=DIR]</parameter> </term> <listitem> <para> Include il supporto a Cybercash MCK. DIR è la directory di compila di cybercash mck, per default /usr/src/mck-3.2.0.3-linux, per informazioni vedere extra/cyberlib. Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> <parameter>--with-mod-dav=DIR</parameter> </term> <listitem> <para> Include il supporto DAV attraverso il mod_dav di Apache, DIR indica la directory di installazione di mod_dav (soltanto nella versione di PHP compilata come modulo di Apache!). Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debugger"> <term> <parameter>--enable-debugger</parameter> </term> <listitem> <para> Compila con le funzioni di debug remoto. Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning.php3"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> Utilizza il sistema di versioning e scoping fornito da Solaris 2.x e Linux. Soltanto PHP 3! </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.php.xml +++ phpdoc-it/chapters/install.configure.php.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <sect3 id="install.configure.options.php"> <title>Opzioni di PHP</title> <variablelist> <varlistentry id="install.configure.enable-maintainer-mode"> <term> <parameter>--enable-maintainer-mode</parameter> </term> <listitem> <para> Abilita la creazione di regole e dipendenze non utili (e qualche volta confuse) al normale utente. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> <parameter>--with-config-file-path=PATH</parameter> </term> <listitem> <para> Imposta il percorso nel quale cercare il &php.ini;, default PREFIX/lib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-safe-mode"> <term> <parameter>--enable-safe-mode</parameter> </term> <listitem> <para> Abilità la modalità sicura per default. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> <parameter>--with-exec-dir[=DIR]</parameter> </term> <listitem> <para> Abilita l'esecuzione in DIR quando la modalità sicura ha come default /usr/local/php/bin. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-magic-quotes"> <term> <parameter>--enable-magic-quotes</parameter> </term> <listitem> <para> Abilita magic quotes per default. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-short-tags"> <term> <parameter>--disable-short-tags</parameter> </term> <listitem> <para> Disabilita i tag abbreviati <? per default. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.fhttpd.xml +++ phpdoc-it/chapters/install.fhttpd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <sect1 id="install.fhttpd"> <title>Servers-fhttpd</title> <para> Per compilare il PHP come modulo fhttpd, rispondere "yes" alla domanda "Build as an fhttpd module?" (l'opzione di configurazione <link linkend="install.configure.with-fhttpd"> --with-fhttpd</link>=<replaceable>DIR</replaceable>) e specificare la directory base dei sorgenti di fhttpd. Per default la directory è <filename class="directory">/usr/local/src/fhttpd</filename>. Se si usa fhttpd, compilare il PHP come modulo da la possibilità di avere prestazioni migliori e la capacità dell'esecuzione remota. </para> <note> <simpara> Il supporto per fhttpd non è più disponibile a partire da PHP 4.3.0. </simpara> </note> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.general.xml +++ phpdoc-it/chapters/install.general.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <sect1 id="install.general"> <title>Considerazioni generali sull'installazione</title> <para> Prima di installare, occorre sapere che cosa dsi desidera fare con il PHP. Esistono tre campi principali in cui utilizzare il PHP, come descritto nella sezione <link linkend="intro-whatcando">Cosa può fare il PHP?</link>: <itemizedlist> <listitem><simpara>Scripting Server-side</simpara></listitem> <listitem><simpara>Scripting da linea di comando</simpara></listitem> <listitem><simpara>Applicazioni GUI Client-side</simpara></listitem> </itemizedlist> </para> <para> Per il primo, e più comune utilizzo, occorrono tre cose: il PHP, un server web ed un browser web. Probabilmente si possiede già un browser web, e, in base alla configurazione del sistema operativo, si potrebbe anche avere un server web (es. Apache su Linux, oppure IIS su Windows). Si potrebbe anche affittare dello spazio web da una azienda. In Questo caso non si ha nulla da impostare, ma soltanto scrivere gli script PHP, scaricarli sul server che si è affittato, e vedere il risultato. </para> <para> Nel caso si decida di attivare web ed PHP in autonomia, si hanno due metodologie per collegare il PHP al server web. Per molti server il PHP ha un modulo apposito (chiamato anche SAPI). Tra questi: Apache, Microsoft Internet Information Server, Netscape e iPlanet servers. Diversi altri server hanno il supporto per ISAPI, il modulo d'interfaccia Microsoft (OmniHTTPd ad esempio). Se il PHP non ha un modulo per il server web prescelto, si può sempre utilizzare il PHP come CGI. Ciò significa configurare il server per eseguira la versione da linea di comando di PHP (<filename>php.exe</filename> su Windows) per processare tutti i file PHP richiesti al server. </para> <para> Se si è interessati ad utilizzare PHP da linea di comando (es. sviluppare script che producano immagini offline, o che elaborino file di testo in base a parametri passati), occorre avere l'eseguibile per la linea di comando. Per maggiori dettagli, leggere la sezione su <link linkend="features.commandline">scrivere applicazioni PHP da linea di comando</link>. In questo caso non occorre ne il serve web, ne il browser. </para> <para> Con il PHP si possono anche scrivere applicazioni grafiche client-side utlizzando l'estensione PHP-GTK. In questo caso si ha un approccio completamente differente rispetto a scrivere una pagina web, dato che non si produce codice HTML, ma si gestiscono finestre e oggetti all'interno di queste. Per maggiori dettagli su PHP-GTK, <ulink url="&url.php.gtk;">visitare il sito dedicato a questa estensione</ulink>. PHP-GTK non è incluso nella distribuzione ufficiale di PHP. </para> <para> Da questo punto in poi, questo capitolo tratterà come settare il PHP con vari server web sia su Unix sia su Windows con i moduli per i server oppure come CGI. </para> <para> Si può scaricare i sorgenti e gli eseguibili per Windows da <ulink url="&url.php;">&url.php;</ulink>. Si suggerisce di utilizzare il <ulink url="&url.mirrors;">mirror</ulink> più vicino per scaricare le distribuzioni. </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.hpux.xml +++ phpdoc-it/chapters/install.hpux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <sect1 id="install.hpux"> <title>Installazione su Unix/HP-UX</title> <para> Questa sezione contiene note e suggerimenti per l'installazione di PHP su sistemi HP-UX. (Contributo di paul_mckay at clearwater-it dot co dot uk). </para> <note> <simpara> Queste note sono state scritte per PHP 4.0.4 e Apache 1.3.9. </simpara> </note> <para> <orderedlist> <listitem> <para> Occorre gzip, scaricare l'eseguibile da <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z</filename> decomprimere il file e installarlo con swinstall. </para> </listitem> <listitem> <para> Serve gcc, scaricare la distribuzione con l'eseguibile da <filename>http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz</filename>. decomprimere il file e installare gcc con swinstall. </para> </listitem> <listitem> <para> Occorrono le binutils GNU, si possono scaricare da <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz</filename>. decomprimere il file e installare le binutils con swinstall. </para> </listitem> <listitem> <para> A questo punto serve bison, scaricare la distribuzione con l'eseguibile da <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz</filename>, installare come i precedenti </para> </listitem> <listitem> <para> Ora serve flex, occorre scaricare il sorgente da uno dei mirror di http://www.gnu.org. Si trova in una directory non GNU del sito ftp. Scaricare il file, <command>gunzip</command>, quindi <command>tar -xvf</command>. Entrare nella directory di flex appena creata ed eseguire <command>./configure</command>, seguito da <command>make</command>, e quindi <command>make install</command>. </para> <para> Se si verifica un errore, probabilmente è dovuto al fatto che gcc o uno degli altri eseguibili non si trovano in PATH, pertanto aggiungerli in PATH. </para> </listitem> <listitem> <para> Scaricare i sorgenti di PHP e Apache. </para> </listitem> <listitem> <para> Eseguire <command>gunzip</command> e <command>tar -xvf</command>. Ora dobbiamo modificare un paio di file in modo da poterli compilare. </para> </listitem> <listitem> <para> Per primo il file configure, occorre modificarlo perchè sembra che perda traccia del fatto di essere su una macchina hpux, esistono metodi migliori per fare ciò, ma il più semplice consiste nel mettere <literal>lt_target=hpux10.20</literal> alla linea 47286 di configure. </para> </listitem> <listitem> <para> Quindi occorre intervenire sul file di Apache GuessOS. Nella directory <filename>apache_1.3.9/src/helpers</filename> cambiare la linea 89 da <literal>echo "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0</literal> a: <literal>echo "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0</literal> </para> </listitem> <listitem> <para> Non si può installare il PHP come oggetto condiviso in HP-UX, pertanto occorre compilarlo come statico, basta seguire le istruzioni alla pagina di Apache. </para> </listitem> <listitem> <para> PHP e Apache dovrebbero essersi compilati correttamente, ma Apache non parte. Occorre creare un nuovo utente per Apache, es www, o apache. Quindi cambiare le linee 252 e 253 del file <filename>conf/httpd.conf</filename> di Apache in questo modo: </para> <screen> User nobody Group nogroup </screen> <para> si dovrebbe avere qualcosa tipo </para> <screen> User www Group sys </screen> <para> Questo perchè non si può eseguire Apache come utente nobody in HP-UX. A questo punto Apache e PHP dovrebbero funzionare. </para> </listitem> </orderedlist> </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.iis.xml +++ phpdoc-it/chapters/install.iis.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <sect1 id="install.iis"> <title>Server IIS/PWS</title> <para> Questa sezione contiene note e suggerimenti specifici per IIS (Microsoft Internet Information Server). Installare il PHP su <link linkend="install.iis.iis3">PWS/IIS 3</link>, <link linkend="install.iis.pws4">PWS 4 o recenti</link> e <link linkend="install.iis.iis4">IIS 4 o recenti</link>. </para> <note> <title>Importante per utenti CGI</title> <para> Leggere la <link linkend="faq.installation.forceredirect">faq su cgi.force_redirect</link> per dettagli importanti. Questa direttiva deve essere impostata a <literal>0</literal>. </para> </note> <sect2 id="install.iis.iis3"> <title>Windows e PWS/IIS 3</title> <simpara> Il metodo raccomandato per l'installazione con questi server è di utilizzare il file REG incluso con la distribuzione (pws-php4cgi.reg). Può essere necessario modificare questo file per adeguarlo alle estensioni usate e alle directory in cui è installato il PHP-. Oppure si può seguire i seguenti passi per farlo manualmente. </simpara> <warning> <para> Queste istruzioni richiedono di lavorare direttamente sul registry di Windows. Un errore potrebbe lasciare il sistema in uno stato instabile. Si raccomanda di fare una copia di backup del registry prima di cominciare. Il gruppo di sviluppo di PHP non è responsabile se si danneggia il registry. </para> </warning> <para> <itemizedlist> <listitem> <simpara> Eseguire Regedit. </simpara> </listitem> <listitem> <simpara> Posizionarsi in: <literal>HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap</literal>. </simpara> </listitem> <listitem> <simpara> Nel menu modifica selezionare: <literal>Nuovo->Stringa</literal> (<literal>New->String Value</literal>). </simpara> </listitem> <listitem> <simpara> Digitare l'estensione che si desidera utilizzare per gli script PHP, Ad esempio <literal>.php</literal>. </simpara> </listitem> <listitem> <simpara> Fare un doppio click su 'nuovo valore stringa' e inserire il percorso a <literal>php.exe</literal> nel campo valore. es.: <literal>c:\php\php.exe</literal>. </simpara> </listitem> <listitem> <simpara> Ripetere questi passi per ciascuna estensione si desideri associare agli script PHP. </simpara> </listitem> </itemizedlist> </para> <para> I seguenti passi non influiscono sull'installazione del server web e si applicano solo se si desidera che gli script php vengano eseguiti quando sono lanciati da linea di comando (es. run <filename>c:\myscripts\test.php</filename>) o da un doppio click sugli stessi da esplora risorse. Si può anche saltare questi passi e optare per caricare i file PHP in un editor quando si fa un doppio click su di essi. </para> <para> <itemizedlist> <listitem> <simpara> Posizionarsi in: <literal>HKEY_CLASSES_ROOT</literal> </simpara> </listitem> <listitem> <simpara> Nel menu modifica selezionare: <literal>nuovo->chiave</literal> (<literal>New->Key</literal>). </simpara> </listitem> <listitem> <simpara> Dare come nome della chiave l'estensione che si desidera configurare es: <literal>.php</literal>. </simpara> </listitem> <listitem> <simpara> Evidenziare la nuova chiave e nel pannello di destra, fare un doppio click su "default value" e inserire <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Ripetere il passo precedente per ogni estensione che si desidera inserire. </simpara> </listitem> <listitem> <simpara> Ora crea un'altra chiave <literal>Nuovo->Chiave</literal> (<literal>New->Key</literal>) sotto <literal>HKEY_CLASSES_ROOT</literal> e chiamarla <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Evidenziare la nuova chiave <literal>phpfile</literal> e nel pannello di destra fare un doppio click su "default value" ed inserire <literal>PHP Script</literal>. </simpara> </listitem> <listitem> <simpara> Click destro sulla chiave <literal>phpfile</literal> e selezionare <literal>Nuovo->Chiave</literal>(<literal>New->Key</literal>), chiamarla <literal>Shell</literal>. </simpara> </listitem> <listitem> <simpara> Click destro sulla chiave <literal>Shell</literal> e selezionare <literal>Nuovo->Chiave</literal>(<literal>New->Key</literal>), chiamarla <literal>open</literal>. </simpara> </listitem> <listitem> <simpara> Click destro sulla chiave <literal>open</literal> e selezionare <literal>Nuovo->Chiave</literal>(<literal>New->Key</literal>), chiamarla <literal>command</literal>. </simpara> </listitem> <listitem> <simpara> Evidenziare la nuova chiave <literal>command</literal> e nel pannello di destra fare un doppio click su "default value" ed inserire il percorso a <literal>php.exe</literal>. es: <literal>c:\php\php.exe -q %1</literal>. (non dimenticarsi del <literal>%1</literal>). </simpara> </listitem> <listitem> <simpara> Uscire da Regedit. </simpara> </listitem> <listitem> <simpara> Se si usa PWS con Windows, riavviare il PC. </simpara> </listitem> </itemizedlist> </para> <simpara> A questo punto gli utenti di PWS ed IIS 3 hanno il sistema operante. Gli utenti di IIS3 possono utilizzare un <ulink url="&url.iiscfg;">tool</ulink> di Steven Genusa per configurare la mappatura degli script. </simpara> </sect2> <sect2 id="install.iis.pws4"> <title>Windows con PWS 4 e successivi</title> <simpara> Quando si installa il PHP su sistemi Windows con PWS 4 o versioni successive, si ha due opzioni. Una consiste nell'impostare il PHP come CGI, l'altra consiste nell'usare il modulo ISAPI. </simpara> <para> Se si sceglie la soluzione CGI, eseguire i seguenti passi: <itemizedlist> <listitem> <simpara> Modificare il file <filename>pws-php4cgi.reg</filename> (vedere nella directory SAPI) per inserire il percorso di <filename>php.exe</filename>. I backslash devono essere preceduti dal carattere di escape '\' ad esempio: <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\php.exe"</literal> Ora inserire questo file di registro nel sistema; dovrebbe bastare un doppio click sul file. </simpara> </listitem> <listitem> <simpara> Nel PWS Manager, click destro nella direttory a cui si vuole aggiungere il supporto PHP e selezionare Proprietà (Properties). Spuntare il checkbox 'Execute' e confermare. </simpara> </listitem> </itemizedlist> </para> <para> Se si opta per il modulo ISAPI, questi sono i passi: <itemizedlist> <listitem> <simpara> Modificare il file <filename>pws-php4cgi.reg</filename> (vedere nella directory SAPI) per inserire il percorso di <filename>php4isapi.dll</filename>. I backslash devono essere preceduti dal carattere di escape '\' ad esempio: <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\sapi\\php4isapi.dll"</literal> Ora inserire questo file di registro nel sistema; dovrebbe bastare un doppio click sul file. </simpara> </listitem> <listitem> <simpara> Nel PWS Manager, click destro nella direttory a cui si vuole aggiungere il supporto PHP e selezionare Proprietà (Properties). Spuntare il checkbox 'Execute' e confermare. </simpara> </listitem> </itemizedlist> </para> </sect2> <sect2 id="install.iis.iis4"> <title>Windows NT/2000/XP con IIS 4 o successivi</title> <simpara> Seguire queste istruzioni per installare il PHP su sistemi NT/2000/XP con IIS 4 o successivi. Si hanno a disposizione due opzioni. Una consiste nell'impostare il PHP come CGI, l'altra consiste nell'usare il modulo ISAPI. </simpara> <simpara> In emtranbi i casi occorre avviare la Microsoft Management Console (può essere presente come 'Internet Services Manager', sia nel Windows NT 4.0 Option Pack o nel Pannello di controllo (Control Panel)=>Administrative Tools sotto Windows 2000/XP). Quindi click destro sul nodo Web server (questo molto probabilmente comparirà come 'Default Web Server'), e selezionare 'Proprietà' ('Properties'). </simpara> <para> Se si desidera installare il PHP come CGI seguire i seguenti passi: <itemizedlist> <listitem> <simpara> Sotto 'Home Directory', 'Virtual Directory', o 'Directory', cliccare sul bottone 'Configuration', ed entrare in App Mappings. </simpara> </listitem> <listitem> <simpara> Premere Add, e nel box Executable digitare. <literal>c:\php\php.exe</literal> (assumendo che il PHP si trovi in c:\php\). </simpara> </listitem> <listitem> <simpara> Nel box Extension, digitare l'estensione dei file che si vuole associare come script PHP. Lasciare bianco 'Method exclusions' e selezionare il checkbox Script engine. Si potrebbe anche selezionare il box 'check that file exists', con una ridotta penalizzazione nella velocità, IIS (o PWS) controlleranno che lo script esista ed eseguiranno l'autentificazione prima di lanciare il PHP. Questo significa avere più errori di tipo 404 piuttosto che avere degli errori CGI dovuti al fatto che il PHP non ha dato in output alcun dato. </simpara> <simpara> Occorre eseguire il passo precedente per ogni estensione che si desideri associare al PHP. <literal>.php</literal> and <literal>.phtml</literal> sono le più comuni, anche <literal>.php3</literal> può essere richiesta per compatibilità verso il passato. </simpara> </listitem> <listitem> <simpara> Impostare le opzioni di sicurezza. (Può essere fatto dal Internet Service Manager), e se il server utilizza come file system NTFS, aggiungere i diritti di esecuzione per I_USR alla directory che contiene il <literal>php.exe</literal>. </simpara> </listitem> </itemizedlist> </para> <para> Per impostare il modulo ISAPI occorre: <itemizedlist> <listitem> <simpara> Se non si desidera eseguire l'autenticazione HTTP con il PHP, si può (si dovrebbe) saltare questo passo. Nei filtri ISAPI, aggiungere un nuovo filtro. Indicare PHP come nome del filtro, e indicare il percorso di php4isapi.dll. </simpara> </listitem> <listitem> <simpara> Nella 'Home Directory', cliccare sul bottone 'Configuration'. Aggiungere una nuova riga nel 'Application Mappings'. Indicare il percorso di php4isapi.dll come Executable, dare <literal>.php</literal> come estensione, lasciare bianco Method exclusions, e selezionare il checkbox Script engine. </simpara> </listitem> <listitem> <simpara> Fermare completamente IIS (NET STOP iisadmin) </simpara> </listitem> <listitem> <simpara> Attivare IIS (NET START w3svc) </simpara> </listitem> </itemizedlist> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.linux.xml +++ phpdoc-it/chapters/install.linux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <sect1 id="install.linux"> <title>Installazione su Unix/Linux</title> <para> Questa sezione contiene note e suggerimenti specifici dell'installazione di PHP su distribuzioni Unix. </para> <sect2 id="install.linux.packages"> <title>Uso dei pacchetti</title> <simpara> Diverse distribuzioni Linux hanno un qualche metodo per installare i pacchetti tipo RPM. Questo può aiutare nell'impostare una configurazione standard, ma se si desidera avere delle caratteristiche differenti (tipo un server sicuro, driver per database differenti) occorre compilare il PHP e/o il server web. Se non si è pratici nella compila del software, potrebbe essere conveniente cercare qualcuno che abbia già pacchettizzato una versione di PHP con le caratteristiche desiderate. </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-it/chapters/install.apache.xml +++ phpdoc-it/chapters/install.apache.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.18 Maintainer: darvina Status: ready --> <sect1 id="install.apache"> <title>Server-Apache</title> <para> Questa sezione contiene note e suggerimenti specifici dell'installazione di PHP con server Apache, sia per le versioni <link linkend="install.apache.unix">Unix</link> sia per le versioni <link linkend="install.apache.windows">Windows</link>. Esiste, inoltre, una pagina separata per le <link linkend="install.apache2">istruzioni e note su Apache 2</link>. </para> <sect2 id="install.apache.unix"> <title>Dettagli sull'installazione di PHP con Apache su Unix</title> <para> Si possono selezionare gli argomenti da aggiungere al comando <command>configure</command> di linea 10 dalla <link linkend="install.configure">Lista completa delle opzioni di configurazione</link>. In queste note viene omesso il numero di versione per evitare di avere istruzioni non corrette. Nella realtà occorre sostituire 'xxx' con i valori di versione corretti. </para> <example id="install.apache.unix.longer"> <title> Istruzioni per l'installazione (versione di Apache con modulo condiviso) di PHP 4. </title> <screen> <![CDATA[ 1. gunzip apache_xxx.tar.gz 2. tar -xvf apache_xxx.tar 3. gunzip php-xxx.tar.gz 4. tar -xvf php-xxx.tar 5. cd apache_xxx 6. ./configure --prefix=/www --enable-module=so 7. make 8. make install 9. cd ../php-xxx 10. ./configure --with-mysql --with-apxs=/www/bin/apxs 11. make 12. make install Se si decide di cambiare le opzioni di configurazione dopo l'installazione occorre ripere gli ultimi tre passi. Per attivare il nuovo modulo occorre riavviare Apache. Non è richiesta la ricompila di Apache. 13. cp php.ini-dist /usr/local/lib/php.ini Si può modificare il file .ini per impostare le opzioni di PHP. Se si desidera avere questo file in un'altra directory, utilizzare --with-config-file-path=/percorso al punto 10. 14. Modificare httpd.conf o srm.conf e verificare che le seguenti linee siano presenti e non commentate: AddType application/x-httpd-php .php LoadModule php4_module libexec/libphp4.so Qui si può selezionare qualsiasi estensione si esideri. .php è semplicemente quella che suggeriamo. Si possono includere anche le estensioni .html e .php3 per compatibilità verso il passato. Il percorso indicato nella parte destra dell'istruzione LoadModule deve puntare alla directory in cui è presente il modulo PHP. L'istruzione precedente è corretta rispetto ai passi illustrati sino qui. 15. Utilizzare le normali procedure per avviare il server Apache. (Occorre riavviare il server, e non forzare una ricarica tramite i segnali HUP o USR1.) ]]> </screen> </example> <para> In base all'installazione di Apache e al tipo di Unix, esistono vari modi per fermare e avviare il server. Di seguito saranno illustrati alcuni metodi tipici per riavviare il server in differenti configurazioni di Apache/unix. Si deve sostituire <literal>/path/to/</literal> con il percorso in cui risiedono queste applicazioni nel sistema. <informalexample> <screen> <![CDATA[ 1. Diverse varianti di Linux e SysV: /etc/rc.d/init.d/httpd restart 2. Utilizzando apachectl: /path/to/apachectl stop /path/to/apachectl start 3. httpdctl e httpsdctl (tramite OpenSSL), simile a apachectl: /path/to/httpsdctl stop /path/to/httpsdctl start 4. Usando mod_ssl, o un'altro server SSL, si può fermare e riavviare il server manualmente: /path/to/apachectl stop /path/to/apachectl startssl ]]> </screen> </informalexample> La directory degli eseguibili apachectl e http(s)dctl spesso varia. Se nel sistema esistono i comandi <literal>locate</literal> oppure <literal>whereis</literal> oppure <literal>which</literal>, si possono utilizzare per localizzare i programmi di controllo del server. </para> <para> Di seguito saranno illustrati differenti esempi di compila di PHP per Apache: <informalexample> <programlisting role="shell"> <![CDATA[ /configure --with-apxs --with-pgsql ]]> </programlisting> </informalexample> </para> <para> Questo crea la libreria condivisa <filename>libphp4.so</filename> che è il modulo caricato da Apache tramite la linea LoadModule del file &httpd.conf;. Il supporto a PostgreSQL è compreso nella libreria <filename>libphp4.so</filename>. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apxs --with-pgsql=shared ]]> </programlisting> </informalexample> </para> <para> Questo crea la libreria condivisa <filename>libphp4.so</filename> per Apache, ma crea anche una libreria condivisa <filename>pgsql.so</filename> che viene caricata in PHP o tramite le direttive del &php.ini; o caricata direttamente dallo script tramite la funzione <function>dl</function>. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql ]]> </programlisting> </informalexample> </para> <para> Questo crea una libreria <filename>libmodphp4.a</filename>, un file <filename>mod_php4.c</filename> e altri file di contorno e li copia nella directory <literal>src/modules/php4</literal> nell'albero dei sorgenti di Apache. Quindi si può compilare Apache utilizzando <literal>--activate-module=src/modules/php4/libphp4.a</literal> e quindi il sistema di compila di Apache creerà il file <filename>libphp4.a</filename> e lo includerà staticamente nell'eseguibile <filename>httpd</filename>. Il supporto per PostgreSQL verrà incluso direttamente in questo <filename>httpd</filename>, pertanto si avrà un unico eseguibile <filename>httpd</filename> comprendente tutto Apache e tutto il PHP. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql=shared ]]> </programlisting> </informalexample> </para> <para> Come l'istruzione precedente, tranne che invece di includere PostgreSQL direttamente nel file finale <filename>httpd</filename>, si avrà una libreria condivisa <filename>pgsql.so</filename> che può essere caricata in PHP o tramite le direttive del &php.ini; o direttamente dallo script tramite la funzione <function>dl</function>. </para> <para> Quando si compila il PHP nei differenti modi, si dovrebbe considerare i vantaggi e gli svantaggi di ciascun metodo. Compilarlo come libreria condivisa permette di compilare Apache separatamente, e quindi non si ha la necessità di ricompilarlo ogni volta che si desideri cambiare il PHP. Compilare il PHP all'interno di Apache (in modo statico) permette al PHP di essere caricato ed eseguito più velocemente. Per maggiori dettagli vedere la pagian di Apache sul <ulink url="&url.apachedso;">supporto DSO</ulink>. </para> <note> <para> Attaulmente il file &httpd.conf; fornito di default contiene una sezione come la seguente: <informalexample> <programlisting> <![CDATA[ User nobody Group "#-1" ]]> </programlisting> </informalexample> A meno che non venga cambiata in "Group nogroup" o qualcosa di simile (è anche comune l'uso di "Group daemon") il PHP non sarà in grado di aprire i file. </para> </note> <note> <para> Accertarsi di avere specificato la versione di apxs installate quando si usa <option role="configure">--with-apxs=/path/to/apxs</option>. NON usare la versione di apxs presente nei sorgenti di Apache, ma quella installata nel sistema. </para> </note> </sect2> <sect2 id="install.apache.windows"> <title>Installazione di PHP su Windows con Apache 1.3.x</title> <simpara> Esistono due metodi per installare PHP e Apache 1.3.x in Windows. Uno consiste nell'utilizzare l'eseguibile CGI (php.exe), la seconda consiste nell'usare il modulo DLL per Apache. In entrambi i casi occorre fermare il server Apache, editare il file &httpd.conf; per indicare ad Apache di utilizzare PHP. </simpara> <simpara> Occorre notare che ora il modulo SAPI sotto Windows è stato reso molto più stabile, noi raccomandiamo l'uso di questo piuttosto che l'eseguibile CGI poichè è molto più trasparente e sicuro. </simpara> <simpara> Sebbene vi possano essere alcune varianti nella configurazione di PHP con Apache, queste sono abbastanza semplici da essere utilizzate dai neofiti. Consultare la documentazione di Apache per maggiori dettagli sulle direttive di configurazione. </simpara> <para> Se si decomprime il pacchetto PHP nella directory <filename>c:\php\</filename> come descritto nella sezione <link linkend="install.windows.manual">Passi per l'installazione manuale</link>, occorre inserire queste linee nella configurazione di Apache per attivare l'eseguibile CGI: <itemizedlist> <listitem> <simpara> <literal> ScriptAlias /php/ "c:/php/" </literal> </simpara> </listitem> <listitem> <simpara> <literal> AddType application/x-httpd-php .php .phtml </literal> </simpara> </listitem> <listitem> <simpara> <literal> Action application/x-httpd-php "/php/php.exe" </literal> </simpara> </listitem> </itemizedlist> Occorre rilevare che la seconda riga può essere presente nelle nuove versioni di &httpd.conf;, ma è commentata. Ricordarsi, inoltre, di sostituire <filename>c:/php/</filename> con la corretta directory del PHP. </para> <warning> <para> Utilizzando la configurazione CGI, il server è aperto a possibili attacchi. Leggere il capitolo <link linkend="security.cgi-bin">CGI security </link> per imparare a difendersi da questi attacchi. </para> </warning> <para> Se si desidera utilizzare PHP come modulo di Apache, occorre copiare <filename>php4ts.dll</filename> nella directory <filename>windows/system</filename> (per Windows 9x/Me), <filename>winnt/system32</filename> (per Windows NT/2000) o <filename>windows/system32</filename> (per Windows XP) sostituendo ogni vecchio file. Quindi si deve aggiungere le seguenti linee al file &httpd.conf; <itemizedlist> <listitem> <simpara> Aprire &httpd.conf; con l'editor preferito e localizzare la direttiva <literal>LoadModule</literal> e aggiungere la seguente linea <emphasis>alla fine</emphasis> dell'elenco: <literal>LoadModule php4_module c:/php/sapi/php4apache.dll</literal> </simpara> </listitem> <listitem> <simpara> Si può rilevare che, dopo l'uso dell'installatore di Apache, occorre definire la direttiva <literal>AddModule</literal> per <filename>mod_php4.c</filename>. Questa è particolarmente importante se viene definita la direttiva <literal>ClearModuleList</literal>, che può essere trovata più sotto di qualche riga. Quando si troverà l'elenco delle istruzioni <literal>AddModule</literal>, aggiungere la seguente linea <emphasis>alla fine</emphasis> dell'elenco: <literal>AddModule mod_php4.c</literal>. </simpara> </listitem> <listitem> <simpara> Cercare una frase simile a <literal># AddType allows you to tweak mime.types</literal>. Si troverà alcune righe tipo <literal>AddType</literal>, aggiungere la seguente linea <emphasis>alla fine</emphasis> dell'elenco: <literal>AddType application/x-httpd-php .php</literal>. Si può scegliere qualsiasi estensione si desideri elaborare tramite PHP. Da parte nostra suggeriamo .php. Si può anche includere .html e .php3 per avere compatibilità con il passato. </simpara> </listitem> </itemizedlist> </para> <simpara> Dopo avere cambiato il file di configurazione, ricordarsi di riavviare il server, ad esempio, <command>NET STOP APACHE</command> seguito da <command>NET START APACHE</command>, se si esegue Apache come servizio di Windows, oppure utilizzare le opportune icone. </simpara> <simpara> Esistono due metodi per attivare la funzionalità di visualizzazione del sorgente; tuttavia il loro funzionamento dipende dall'installazione. Se si ha configurato Apache per utilizzare PHP come modulo SAPI, allora aggiungendo la seguente linea al file &httpd.conf; (nello stesso punto in cui si è inserito <literal>AddType application/x-httpd-php .php</literal>) si può attivare questa caratteristica: <literal>AddType application/x-httpd-php-source .phps</literal>. </simpara> <simpara> Se si è scelto di configurare Apache per utilizzare PHP come eseguibile CGI, allora occorre utilizzare la funzione <function>show_source</function>. Per ottenere ciò creare uno script PHP e aggiungere questa riga: <literal><?php show_source ("original_php_script.php"); ?></literal>. Sostituire <literal>original_php_script.php</literal> con il nome del file di cui si vuole vedere il sorgente. </simpara> <note> <simpara> Nella versione Windows di Apache tutti i backslash nelle righe con percorsi tipo "c:\directory\file.ext", devono essere sostituiti con lo slash, tipo "c:/directory/file.ext". </simpara> </note> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.apache2.xml +++ phpdoc-it/chapters/install.apache2.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.12 Maintainer: darvina Status: ready --> <sect1 id="install.apache2"> <title>Server-Apache 2.0</title> <para> Questa sezione contiene note e suggerimenti specifici per l'installazione di <literal>PHP</literal>, con Apache 2.0, sia per sistemi <link linkend="install.apache2.unix">Unix</link> sia per sistemi <link linkend="install.apache2.windows">Windows</link>. </para> <warning> <para> Non utilizzare Apache 2.0 e <literal>PHP</literal> in ambienti di produzione sia con Unix sia con Windows. </para> </warning> <para> Riteniamo sia opportuno dare uno sguardo alla <ulink url="&url.apache2.docs;">Documentazione di Apache</ulink> per avere le nozioni di base per comprendere Apache 2.0. </para> <sect2 id="compat.apache2"> <title>Note di compatibilità tra PHP e Apache 2.0</title> <para> Se seguente versioni di PHP funzionano correttamente con le ultime versioni di Apache 2.0: <itemizedlist spacing="compact"> <listitem> <simpara> PHP 4.3.0 o successive , disponibili a <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. </simpara> </listitem> <listitem> <simpara> l'ultima versione stabile dell'ambiente di sviluppo. Per ottenere il sorgente aggiornato <ulink url="&url.php.snapshots;php4-latest.tar.gz"> &url.php.snapshots;php4-latest.tar.gz</ulink> o per scaricare gli eseguibili per Windows <ulink url="&url.php.snapshots;win32/php4-win32-latest.zip"> &url.php.snapshots;win32/php4-win32-latest.zip</ulink>. </simpara> </listitem> <listitem> <simpara> la versione di pre-rilascio, disponibile in <ulink url="&url.php.prerelease;">&url.php.prerelease;</ulink>. </simpara> </listitem> <listitem> <simpara> inoltre si ha sempre la possibilità di avere il <literal>PHP</literal> tramite il <ulink url="&url.php.anoncvs;">CVS anonimo</ulink>. </simpara> </listitem> </itemizedlist> Queste versioni di <literal>PHP</literal> sono compatibili con Apache 2.0.40 e successive. </para> <note> <simpara> Il supporto tramite <literal>SAPI</literal> ad Apache 2.0 è cominciato da 4.2.0. PHP 4.2.3 funziona con Apache 2.0.39, non utilizzare nessuna altra versione di Apache con PHP 4.2.3. Tuttavia si raccomanda di utilizzare il PHP 4.3.0, o successivo, con la più recente versione di Apache2. </simpara> <simpara> Tutte le versioni di <literal>PHP</literal> menzionate, lavorano con Apache 1.3.x. </simpara> </note> </sect2> <sect2 id="install.apache2.unix"> <title>PHP e Apache 2 su Linux</title> <para> Scaricare la più recente versione di <ulink url= "&url.apache;"> Apache 2.0</ulink> e la versione di PHP dai siti menzionati in precendenza. Questa guida rapida copre soltanto le basi per partire con Apache 2.0 e <literal>PHP</literal>. Per maggiori dettagli leggere la <ulink url="&url.apache2.docs;">documentazione di Apache</ulink>. In questo esempio è stata omesso il numero di versione per evitare problemi nelle istruzioni presentate. Nell'installazione reale occorre sostituire 'NN' con il corretto numero della versione installata. </para> <example> <title> Istruzioni per l'installazione (Apache 2 con modulo condiviso) </title> <screen> <![CDATA[ 1. gzip -d httpd-2_0_NN.tar.gz 2. tar xvf httpd-2_0_NN.tar 3. gunzip php-NN.tar.gz 4. tar -xvf php-NN.tar 5. cd httpd-2_0_NN 6. ./configure --enable-so 7. make 8. make install A questo punto si ha Apache 2.0 disponibile in /usr/local/apache2, configurato con il supporto dei moduli caricabili. Per testare l'installazione utilizzare la solita procedura per attivare il server Apache, es.: /usr/local/apache2/bin/apachectl start e quindi fermare il server per attivare la configurazione con PHP: /usr/local/apache2/bin/apachectl stop. 9. cd ../php4-NN 10. ./configure --with-apxs2=/usr/local/apache2/bin/apxs 11. make 12. make install 13. cp php.ini-dist /usr/local/lib/php.ini Modificare il php.ini per impostare le opzioni di PHP. Se si desidera pozionare questo file in altra directory, utilizzare --with-config-file-path=/path al passo 10. 14. Modificare httpd.conf e verificare la presenza delle seguenti linee: LoadModule php4_module modules/libphp4.so AddType application/x-httpd-php .php Si può segliere qualsiasi estensione di desideri. Il nostro suggerimento è di utilizzare .php. Il percorso indicato nel lato destro della riga LoadModule deve puntare al percorso in cui si trova il modulo PHP. L'esempio illustrato è coerente con i parametri sin qui impostati. 15. Utilizzare la solita procedura per avviare Apache, es.: /usr/local/apache2/bin/apachectl start ]]> </screen> </example> <para> Seguendo i passi illustrati si ottiene un server Apache 2.0 funzionante con il supporto <literal>PHP</literal> come modulo <literal>SAPI</literal>. Ovviamente esistono molte altre opzioni di configurazione sia per Apache sia per <literal>PHP</literal>. Per maggiori dettagli utilizzare <command>./configure --help</command> nei sorgenti di ciascun prodotto. Nel caso si desideri compilare la versione multithread di Apache 2.0 occorre sovrascrivere il modulo MPM standard <filename>prefork</filename> con <filename>worker</filename> o con <filename>perchild</filename>. Per ottenere ciò accodare alla linea di configurazione indicata nel passo 6 l'opzione <option role="configure">--with-mpm=worker</option> o <option role="configure">--with-mpm=perchild</option>. Occorre essere consapevoli delle conseguenze di ciò che si sta facendo. Per maggiori dettagli leggere la documenatzione di Apache sul <ulink url="&url.apache2.mpm;"> modulo MPM</ulink>. </para> <note> <para> Per potere compilare la versione multithread di Apache occorre che il sistema supporti i thread. Questo implica la compila di <literal>PHP</literal> con il modulo sperimentale Zend Thread Safety (ZTS). Pertanto non tutte le estensioni potranno essere disponibili. Si raccomanda, quindi, di compilare Apache con il modulo MPM standard <filename>prefork</filename>. </para> </note> </sect2> <sect2 id="install.apache2.windows"> <title>PHP e Apache 2.0 su Windows</title> <para> Si consideri di leggere le <ulink url="&url.apache2.windows;"> note specifiche per Windows</ulink> di Apache 2.0. </para> <warning> <para> Apache 2.0 è concepito per essere eseguito su Windows NT 4.0, Windows 2000 oppure Windows XP. In questo momento il supporto per Windows 9x è incompleto. Al momento non ci si aspetta che Apache 2.0 funzioni su quest'ultime piattaforme. </para> </warning> <para> Scaricare la più recente versione di <ulink url= "&url.apache;"> Apache 2.0</ulink> e la versione di PHP dai siti menzionati in precendenza. Seguire i <link linkend="install.windows.manual">passi per l'installazione manuale</link> e tornare a questo pagina per integrare il <literal>PHP</literal> con Apache. </para> <para> Esistono due metodi per configurare <literal>PHP</literal> e Apache 2.0 su Windows. Uno consiste nell'uso dell'eseguibile CGI, l'altro consiste nell'utilizzo del modulo DLL per Apache. In entrambi i casi occorre fermare Apache, modificare il file &httpd.conf; per configurare Apache. </para> <para> Occorre inserire queste tre linee nel file di configurazione &httpd.conf; di Apache per impostare l'<emphasis>eseguibile CGI</emphasis>: <example> <title>PHP con Apache 2.0 come CGI</title> <programlisting role="apache"> <![CDATA[ ScriptAlias /php/ "c:/php/" AddType application/x-httpd-php .php Action application/x-httpd-php "/php/php.exe" ]]> </programlisting> </example> </para> <para> Se si desidera utilizzare il <literal>PHP</literal> come modulo di Apache 2.0, occorre copiare <filename>php4ts.dll</filename> nella directory <filename>winnt/system32</filename> (per Windows NT/2000) o <filename>windows/system32</filename> (per Windows XP), sovrascrivendo gli eventuali vecchi file. Quindi occorre inserire queste due righe nel file di configurazione di Apache &httpd.conf; per impostare il <emphasis>modulo PHP</emphasis> <example> <title>PHP su Apache 2.0 come Modulo</title> <programlisting role="apache"> <![CDATA[ LoadModule php4_module "c:/php/sapi/php4apache2.dll" AddType application/x-httpd-php .php ]]> </programlisting> </example> </para> <note> <simpara> Nei precedenti esempi ricordarsi di sostituire <filename>c:/php/</filename> con il percorso al<literal>PHP</literal>. Prestare attenzione di avere impostato <filename>php4apache2.dll</filename> nella direttiva LoadModule e <emphasis>non</emphasis><filename>php4apche.dll</filename>. Quest'ultimo è utilizzato per Apache 1.3.x. </simpara> </note> <warning> <simpara> Non mischiare i file dll da <emphasis>differenti versioni di PHP</emphasis>. Si ha solo la possibilità di utilizzare le dll e le estensioni fornite con la versione scaricata. </simpara> </warning> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.caudium.xml +++ phpdoc-it/chapters/install.caudium.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <sect1 id="install.caudium"> <title>Server-Caudium</title> <para> Il PHP 4 può essere compilato come module Pike per il <ulink url="&url.caudium;">server web Caudium</ulink>. Attenzione: non è supportato dal Php 3. Seguire le seguenti istruzioni per installare il PHP 4 con Caudium. </para> <example id="install.caudium.instructions"> <title>Istruzioni di installazione per Caudium</title> <screen> <![CDATA[ 1. Essere certi di avere installato Caudium prima di installare il PHP 4. Il Php per potere funzionare ha bisogno di Pike versione 7.0.268 o successive. Per praticità di illustrazione in questo esempio assumeremo che Caudium sia installato in /opt/caudium/server/. 2. Posizionarsi nella directory php-x.y.z (dove x.y.z è il numero di versione). 3. ./configure --with-caudium=/opt/caudium/server 4. make 5. make install 6. Riavviare Caudium se è attivo. 7. Entrare nell'interfaccia grafica di configurazione e andare nella sezione virtual server da dove si inserirà il PHP. 8. Cliccare su Add Module localizzare e aggiungere il modulo PHP 4 Script Suppor. 9. Se la documentazione informa che 'PHP 4 interpreter isn't available', verificare di avere riavviato il server. Se lo si è fatto, cercare nel file /opt/caudium/logs/debug/default.1 la presenza di errori collegati a <filename>PHP4.so</filename>. Verificare anche la presenza del file <filename>caudium/server/lib/[pike-version]/PHP4.so</filename>. 10. Configurare il modulo PHP Script Support se necessario.. ]]> </screen> </example> <para> Si può compilare il modulo per Caudium con il supporto dei vari moduli disponibili per PHP 4, Vedere la <link linkend="install.configure">lista completa delle opzioni di configurazione options</link> per maggiori informazioni. </para> <note> <para> Quando si compila il PHP con il supporto a MySQL occorre essere certi di utilizzare il normale client di MySQL. Altrimenti si possono verificare del conflitti se Pike supporta MySQL. Per fare ciò occorre specificare la directory di installazione di MySQL nell'opzione <option role="configure"> --with-mysql</option>. </para> </note> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.commandline.xml +++ phpdoc-it/chapters/install.commandline.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <sect1 id="install.commandline"> <title>Servers-CGI/linea di comando</title> <para> Per default il PHP viene compilato come programma CGI. Ciò crea un interprete di linea di comando che può essere utilizzato sia per elaborazioni CGI sia per script non connessi con il web. Se si utilizza un server web il PHP ha dei moduli atti allo scopo, questa dovrebbe essere la soluzione preferenziale per ragioni di performance. Tuttavia la versione CGI permette agli utenti di Apache di eseguire pagine PHP sotto differenti user id. Se si desidera utilizzare il PHP come CGI è opportuno leggere con attenzione il capitolo <link linkend="security.index">Security chapter</link> </para> <para> Dalla versione 4.3.0 di PHP sono state inserite nuove caratteristiche. Una nuova SAPI, chiamata CLI, è stata aggiunta è ha lo stesso nome dell'eseguibile CGI. Che cosa si installa nella directory <literal>{PREFIX}/bin/php</literal> dipende dalla line di configurazione, ciò è descritto dettagliatamente nel capitolo <link linkend="features.commandline">Uso del PHP da linea di comando </link>. Per maggiori dettagli leggere quel capitolo del manuale. </para> <sect2 id="install.commandline.testing"> <title>Testing</title> <simpara> Se si ha compilato il PHP come programma CGI, si può testare l'eseguibile eseguendo <command>make test</command>. E' sempre una buona norma testare l'eseguibile che si è appena compilato. In questo modo si possono intercettare immediatamente eventuali problemi relativi alla piattaforma e non impazzire in una fase successiva. </simpara> </sect2> <sect2 id="install.commandline.benchmarking"> <title>Benchmarking</title> <simpara> Se si compila il PHP 3 come programma CGI, si possono eseguire dei banchmark digitando <command>make bench</command>. Occorre notare che se si è abilitato il &safemode; il benchmark non è in grado di concludersi correttamente se richiede più di 30 secondi. Questo perchè la funzione &safemode; non può utilizzare la funzione <function>set_time_limit</function>. Utilizzare il parametro <link linkend="ini.max-execution-time">max_execution_time</link> per impostare il tempo massimo di esecuzione di uno script. Il comando <command>make bench</command> ignora il <link linkend="configuration.file">file di configurazione</link>. </simpara> <note> <simpara> <command>make bench</command> è soltanto disponibile per PHP 3. </simpara> </note> </sect2> <sect2 id="install.commandline.using-variables"> <title>Utilizzo delle variabili</title> <simpara> Alcuni server passano delle variabili d'ambiente che non sono definite nelle specifiche <ulink url="&url.cgispec;">CGI/1.1</ulink>. Soltanto le seguenti variabili sono standard, tutte le altre sono da considerarsi come estensioni del fornitore: AUTH_TYPE, CONTENT_LENGTH, CONTENT_TYPE, GATEWAY_INTERFACE, PATH_INFO, PATH_TRANSLATED, QUERY_STRING, REMOTE_ADDR, REMOTE_HOST, REMOTE_IDENT, REMOTE_USER, REQUEST_METHOD, SCRIPT_NAME, SERVER_NAME, SERVER_PORT, SERVER_PROTOCOL e SERVER_SOFTWARE </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.databases.xml +++ phpdoc-it/chapters/install.configure.databases.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.databases"> <title>Database options</title> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.graphics.xml +++ phpdoc-it/chapters/install.configure.graphics.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <sect3 id="install.configure.options.graphics"> <title>Opzioni grafiche</title> <variablelist> <varlistentry id="install.configure.with-imagick"> <term> <parameter>--with-imagick</parameter> </term> <listitem> <para> L'estensione imagick è stata spostata da PECL a PEAR e può essere reperita <ulink url="&url.php.pear;imagick">qui</ulink>. Le istruzioni per l'installazione possono essere reperite nel sito di PEAR. </para> <para> Soltanto l'opzione <literal>--with-imagick</literal> è supportata da PHP 3 a meno di non seguire le istruzioni presenti nel sito di PEAR. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.misc.xml +++ phpdoc-it/chapters/install.configure.misc.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <sect3 id="install.configure.options.misc"> <title>Opzioni varie</title> <variablelist> <varlistentry id="install.configure.enable-debug"> <term> <parameter>--enable-debug</parameter> </term> <listitem> <para> Compila con il simbolico per il debug. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-layout"> <term> <parameter>--with-layout=TYPE</parameter> </term> <listitem> <para> Imposta come dovranno essere disposti i file installati. Utilizzare PHP (default) o GNU. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pear"> <term> <parameter>--with-pear=DIR</parameter> </term> <listitem> <para> Installa PEAR in DIR (default PREFIX/lib/php). </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-pear"> <term> <parameter>--without-pear</parameter> </term> <listitem> <para> Non installa PEAR. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sigchild"> <term> <parameter>--enable-sigchild</parameter> </term> <listitem> <para> Abilita la gestione del segnale SIGCHLD da parte di un modulo proprio del PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> Disabilità il passaggio di directory addizionali per la ricerche delle librerie. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-libgcc"> <term> <parameter>--enable-libgcc</parameter> </term> <listitem> <para> Abilita esplicitamente il link nei confronti di libgcc. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-php-streams"> <term> <parameter>--enable-php-streams</parameter> </term> <listitem> <para> Include il modulo sperimentale degli streams. Non utilizzarlo a meno di non volere eseguire dei test. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> <parameter>--with-zlib-dir=<DIR></parameter> </term> <listitem> <para> Specificare la directory di installzaione di zlib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-trans-sid"> <term> <parameter>--enable-trans-sid</parameter> </term> <listitem> <para> Abilita la propagazione trasparente dell'id di sessione. Questa opzione è valida per il PHP 4.1.2 o precedenti. Dalla versione 4.2.0 l'opzione trans-sid è sempre compilata. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pthreads"> <term> <parameter>--with-tsrm-pthreads</parameter> </term> <listitem> <para> Utilizza i threads POSIX (default). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> Compila con librerie condivise [default=yes]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-static"> <term> <parameter>--enable-static[=PKGS]</parameter> </term> <listitem> <para> Compila con librerie statiche [default=yes]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> <parameter>--enable-fast-install[=PKGS]</parameter> </term> <listitem> <para> Ottimizza per un'installazione rapida [default=yes]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gnu-ld"> <term> <parameter>--with-gnu-ld</parameter> </term> <listitem> <para> Assume che il compilatore C utilizzi GNU ld [default=no]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-libtool-lock"> <term> <parameter>--disable-libtool-lock</parameter> </term> <listitem> <para> Impedisce il locking (può interrompere compile parallele). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pic"> <term> <parameter>--with-pic</parameter> </term> <listitem> <para> Tenta di utilizzare soltanto oggetti PIC/non-PIC [default=use both]. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-memory-limit"> <term> <parameter>--enable-memory-limit</parameter> </term> <listitem> <para> Compila con il supporto al limite di memoria. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-url-fopen-wrapper"> <term> <parameter>--disable-url-fopen-wrapper</parameter> </term> <listitem> <para> Disabilita il supporto agli URL per fopen che permette l'accesso ai file via HTTP o FTP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning.php4"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> Esporta soltanto i simboli richiesti. Vedere INSTALL per maggiori dettagli. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ismp"> <term> <parameter>--with-imsp[=DIR]</parameter> </term> <listitem> <para> Include il supporto a IMSp (DIR indica la directory con gli include di IMSP's e con libimsp.a. Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mck"> <term> <parameter>--with-mck[=DIR]</parameter> </term> <listitem> <para> Include il supporto a Cybercash MCK. DIR è la directory di compila di cybercash mck, per default /usr/src/mck-3.2.0.3-linux, per informazioni vedere extra/cyberlib. Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> <parameter>--with-mod-dav=DIR</parameter> </term> <listitem> <para> Include il supporto DAV attraverso il mod_dav di Apache, DIR indica la directory di installazione di mod_dav (soltanto nella versione di PHP compilata come modulo di Apache!). Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debugger"> <term> <parameter>--enable-debugger</parameter> </term> <listitem> <para> Compila con le funzioni di debug remoto. Soltanto PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning.php3"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> Utilizza il sistema di versioning e scoping fornito da Solaris 2.x e Linux. Soltanto PHP 3! </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.configure.php.xml +++ phpdoc-it/chapters/install.configure.php.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <sect3 id="install.configure.options.php"> <title>Opzioni di PHP</title> <variablelist> <varlistentry id="install.configure.enable-maintainer-mode"> <term> <parameter>--enable-maintainer-mode</parameter> </term> <listitem> <para> Abilita la creazione di regole e dipendenze non utili (e qualche volta confuse) al normale utente. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> <parameter>--with-config-file-path=PATH</parameter> </term> <listitem> <para> Imposta il percorso nel quale cercare il &php.ini;, default PREFIX/lib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-safe-mode"> <term> <parameter>--enable-safe-mode</parameter> </term> <listitem> <para> Abilità la modalità sicura per default. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> <parameter>--with-exec-dir[=DIR]</parameter> </term> <listitem> <para> Abilita l'esecuzione in DIR quando la modalità sicura ha come default /usr/local/php/bin. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-magic-quotes"> <term> <parameter>--enable-magic-quotes</parameter> </term> <listitem> <para> Abilita magic quotes per default. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-short-tags"> <term> <parameter>--disable-short-tags</parameter> </term> <listitem> <para> Disabilita i tag abbreviati <? per default. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.fhttpd.xml +++ phpdoc-it/chapters/install.fhttpd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <sect1 id="install.fhttpd"> <title>Servers-fhttpd</title> <para> Per compilare il PHP come modulo fhttpd, rispondere "yes" alla domanda "Build as an fhttpd module?" (l'opzione di configurazione <link linkend="install.configure.with-fhttpd"> --with-fhttpd</link>=<replaceable>DIR</replaceable>) e specificare la directory base dei sorgenti di fhttpd. Per default la directory è <filename class="directory">/usr/local/src/fhttpd</filename>. Se si usa fhttpd, compilare il PHP come modulo da la possibilità di avere prestazioni migliori e la capacità dell'esecuzione remota. </para> <note> <simpara> Il supporto per fhttpd non è più disponibile a partire da PHP 4.3.0. </simpara> </note> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.general.xml +++ phpdoc-it/chapters/install.general.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <sect1 id="install.general"> <title>Considerazioni generali sull'installazione</title> <para> Prima di installare, occorre sapere che cosa dsi desidera fare con il PHP. Esistono tre campi principali in cui utilizzare il PHP, come descritto nella sezione <link linkend="intro-whatcando">Cosa può fare il PHP?</link>: <itemizedlist> <listitem><simpara>Scripting Server-side</simpara></listitem> <listitem><simpara>Scripting da linea di comando</simpara></listitem> <listitem><simpara>Applicazioni GUI Client-side</simpara></listitem> </itemizedlist> </para> <para> Per il primo, e più comune utilizzo, occorrono tre cose: il PHP, un server web ed un browser web. Probabilmente si possiede già un browser web, e, in base alla configurazione del sistema operativo, si potrebbe anche avere un server web (es. Apache su Linux, oppure IIS su Windows). Si potrebbe anche affittare dello spazio web da una azienda. In Questo caso non si ha nulla da impostare, ma soltanto scrivere gli script PHP, scaricarli sul server che si è affittato, e vedere il risultato. </para> <para> Nel caso si decida di attivare web ed PHP in autonomia, si hanno due metodologie per collegare il PHP al server web. Per molti server il PHP ha un modulo apposito (chiamato anche SAPI). Tra questi: Apache, Microsoft Internet Information Server, Netscape e iPlanet servers. Diversi altri server hanno il supporto per ISAPI, il modulo d'interfaccia Microsoft (OmniHTTPd ad esempio). Se il PHP non ha un modulo per il server web prescelto, si può sempre utilizzare il PHP come CGI. Ciò significa configurare il server per eseguira la versione da linea di comando di PHP (<filename>php.exe</filename> su Windows) per processare tutti i file PHP richiesti al server. </para> <para> Se si è interessati ad utilizzare PHP da linea di comando (es. sviluppare script che producano immagini offline, o che elaborino file di testo in base a parametri passati), occorre avere l'eseguibile per la linea di comando. Per maggiori dettagli, leggere la sezione su <link linkend="features.commandline">scrivere applicazioni PHP da linea di comando</link>. In questo caso non occorre ne il serve web, ne il browser. </para> <para> Con il PHP si possono anche scrivere applicazioni grafiche client-side utlizzando l'estensione PHP-GTK. In questo caso si ha un approccio completamente differente rispetto a scrivere una pagina web, dato che non si produce codice HTML, ma si gestiscono finestre e oggetti all'interno di queste. Per maggiori dettagli su PHP-GTK, <ulink url="&url.php.gtk;">visitare il sito dedicato a questa estensione</ulink>. PHP-GTK non è incluso nella distribuzione ufficiale di PHP. </para> <para> Da questo punto in poi, questo capitolo tratterà come settare il PHP con vari server web sia su Unix sia su Windows con i moduli per i server oppure come CGI. </para> <para> Si può scaricare i sorgenti e gli eseguibili per Windows da <ulink url="&url.php;">&url.php;</ulink>. Si suggerisce di utilizzare il <ulink url="&url.mirrors;">mirror</ulink> più vicino per scaricare le distribuzioni. </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.hpux.xml +++ phpdoc-it/chapters/install.hpux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <sect1 id="install.hpux"> <title>Installazione su Unix/HP-UX</title> <para> Questa sezione contiene note e suggerimenti per l'installazione di PHP su sistemi HP-UX. (Contributo di paul_mckay at clearwater-it dot co dot uk). </para> <note> <simpara> Queste note sono state scritte per PHP 4.0.4 e Apache 1.3.9. </simpara> </note> <para> <orderedlist> <listitem> <para> Occorre gzip, scaricare l'eseguibile da <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z</filename> decomprimere il file e installarlo con swinstall. </para> </listitem> <listitem> <para> Serve gcc, scaricare la distribuzione con l'eseguibile da <filename>http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz</filename>. decomprimere il file e installare gcc con swinstall. </para> </listitem> <listitem> <para> Occorrono le binutils GNU, si possono scaricare da <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz</filename>. decomprimere il file e installare le binutils con swinstall. </para> </listitem> <listitem> <para> A questo punto serve bison, scaricare la distribuzione con l'eseguibile da <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz</filename>, installare come i precedenti </para> </listitem> <listitem> <para> Ora serve flex, occorre scaricare il sorgente da uno dei mirror di http://www.gnu.org. Si trova in una directory non GNU del sito ftp. Scaricare il file, <command>gunzip</command>, quindi <command>tar -xvf</command>. Entrare nella directory di flex appena creata ed eseguire <command>./configure</command>, seguito da <command>make</command>, e quindi <command>make install</command>. </para> <para> Se si verifica un errore, probabilmente è dovuto al fatto che gcc o uno degli altri eseguibili non si trovano in PATH, pertanto aggiungerli in PATH. </para> </listitem> <listitem> <para> Scaricare i sorgenti di PHP e Apache. </para> </listitem> <listitem> <para> Eseguire <command>gunzip</command> e <command>tar -xvf</command>. Ora dobbiamo modificare un paio di file in modo da poterli compilare. </para> </listitem> <listitem> <para> Per primo il file configure, occorre modificarlo perchè sembra che perda traccia del fatto di essere su una macchina hpux, esistono metodi migliori per fare ciò, ma il più semplice consiste nel mettere <literal>lt_target=hpux10.20</literal> alla linea 47286 di configure. </para> </listitem> <listitem> <para> Quindi occorre intervenire sul file di Apache GuessOS. Nella directory <filename>apache_1.3.9/src/helpers</filename> cambiare la linea 89 da <literal>echo "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0</literal> a: <literal>echo "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0</literal> </para> </listitem> <listitem> <para> Non si può installare il PHP come oggetto condiviso in HP-UX, pertanto occorre compilarlo come statico, basta seguire le istruzioni alla pagina di Apache. </para> </listitem> <listitem> <para> PHP e Apache dovrebbero essersi compilati correttamente, ma Apache non parte. Occorre creare un nuovo utente per Apache, es www, o apache. Quindi cambiare le linee 252 e 253 del file <filename>conf/httpd.conf</filename> di Apache in questo modo: </para> <screen> User nobody Group nogroup </screen> <para> si dovrebbe avere qualcosa tipo </para> <screen> User www Group sys </screen> <para> Questo perchè non si può eseguire Apache come utente nobody in HP-UX. A questo punto Apache e PHP dovrebbero funzionare. </para> </listitem> </orderedlist> </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.iis.xml +++ phpdoc-it/chapters/install.iis.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <sect1 id="install.iis"> <title>Server IIS/PWS</title> <para> Questa sezione contiene note e suggerimenti specifici per IIS (Microsoft Internet Information Server). Installare il PHP su <link linkend="install.iis.iis3">PWS/IIS 3</link>, <link linkend="install.iis.pws4">PWS 4 o recenti</link> e <link linkend="install.iis.iis4">IIS 4 o recenti</link>. </para> <note> <title>Importante per utenti CGI</title> <para> Leggere la <link linkend="faq.installation.forceredirect">faq su cgi.force_redirect</link> per dettagli importanti. Questa direttiva deve essere impostata a <literal>0</literal>. </para> </note> <sect2 id="install.iis.iis3"> <title>Windows e PWS/IIS 3</title> <simpara> Il metodo raccomandato per l'installazione con questi server è di utilizzare il file REG incluso con la distribuzione (pws-php4cgi.reg). Può essere necessario modificare questo file per adeguarlo alle estensioni usate e alle directory in cui è installato il PHP-. Oppure si può seguire i seguenti passi per farlo manualmente. </simpara> <warning> <para> Queste istruzioni richiedono di lavorare direttamente sul registry di Windows. Un errore potrebbe lasciare il sistema in uno stato instabile. Si raccomanda di fare una copia di backup del registry prima di cominciare. Il gruppo di sviluppo di PHP non è responsabile se si danneggia il registry. </para> </warning> <para> <itemizedlist> <listitem> <simpara> Eseguire Regedit. </simpara> </listitem> <listitem> <simpara> Posizionarsi in: <literal>HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap</literal>. </simpara> </listitem> <listitem> <simpara> Nel menu modifica selezionare: <literal>Nuovo->Stringa</literal> (<literal>New->String Value</literal>). </simpara> </listitem> <listitem> <simpara> Digitare l'estensione che si desidera utilizzare per gli script PHP, Ad esempio <literal>.php</literal>. </simpara> </listitem> <listitem> <simpara> Fare un doppio click su 'nuovo valore stringa' e inserire il percorso a <literal>php.exe</literal> nel campo valore. es.: <literal>c:\php\php.exe</literal>. </simpara> </listitem> <listitem> <simpara> Ripetere questi passi per ciascuna estensione si desideri associare agli script PHP. </simpara> </listitem> </itemizedlist> </para> <para> I seguenti passi non influiscono sull'installazione del server web e si applicano solo se si desidera che gli script php vengano eseguiti quando sono lanciati da linea di comando (es. run <filename>c:\myscripts\test.php</filename>) o da un doppio click sugli stessi da esplora risorse. Si può anche saltare questi passi e optare per caricare i file PHP in un editor quando si fa un doppio click su di essi. </para> <para> <itemizedlist> <listitem> <simpara> Posizionarsi in: <literal>HKEY_CLASSES_ROOT</literal> </simpara> </listitem> <listitem> <simpara> Nel menu modifica selezionare: <literal>nuovo->chiave</literal> (<literal>New->Key</literal>). </simpara> </listitem> <listitem> <simpara> Dare come nome della chiave l'estensione che si desidera configurare es: <literal>.php</literal>. </simpara> </listitem> <listitem> <simpara> Evidenziare la nuova chiave e nel pannello di destra, fare un doppio click su "default value" e inserire <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Ripetere il passo precedente per ogni estensione che si desidera inserire. </simpara> </listitem> <listitem> <simpara> Ora crea un'altra chiave <literal>Nuovo->Chiave</literal> (<literal>New->Key</literal>) sotto <literal>HKEY_CLASSES_ROOT</literal> e chiamarla <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Evidenziare la nuova chiave <literal>phpfile</literal> e nel pannello di destra fare un doppio click su "default value" ed inserire <literal>PHP Script</literal>. </simpara> </listitem> <listitem> <simpara> Click destro sulla chiave <literal>phpfile</literal> e selezionare <literal>Nuovo->Chiave</literal>(<literal>New->Key</literal>), chiamarla <literal>Shell</literal>. </simpara> </listitem> <listitem> <simpara> Click destro sulla chiave <literal>Shell</literal> e selezionare <literal>Nuovo->Chiave</literal>(<literal>New->Key</literal>), chiamarla <literal>open</literal>. </simpara> </listitem> <listitem> <simpara> Click destro sulla chiave <literal>open</literal> e selezionare <literal>Nuovo->Chiave</literal>(<literal>New->Key</literal>), chiamarla <literal>command</literal>. </simpara> </listitem> <listitem> <simpara> Evidenziare la nuova chiave <literal>command</literal> e nel pannello di destra fare un doppio click su "default value" ed inserire il percorso a <literal>php.exe</literal>. es: <literal>c:\php\php.exe -q %1</literal>. (non dimenticarsi del <literal>%1</literal>). </simpara> </listitem> <listitem> <simpara> Uscire da Regedit. </simpara> </listitem> <listitem> <simpara> Se si usa PWS con Windows, riavviare il PC. </simpara> </listitem> </itemizedlist> </para> <simpara> A questo punto gli utenti di PWS ed IIS 3 hanno il sistema operante. Gli utenti di IIS3 possono utilizzare un <ulink url="&url.iiscfg;">tool</ulink> di Steven Genusa per configurare la mappatura degli script. </simpara> </sect2> <sect2 id="install.iis.pws4"> <title>Windows con PWS 4 e successivi</title> <simpara> Quando si installa il PHP su sistemi Windows con PWS 4 o versioni successive, si ha due opzioni. Una consiste nell'impostare il PHP come CGI, l'altra consiste nell'usare il modulo ISAPI. </simpara> <para> Se si sceglie la soluzione CGI, eseguire i seguenti passi: <itemizedlist> <listitem> <simpara> Modificare il file <filename>pws-php4cgi.reg</filename> (vedere nella directory SAPI) per inserire il percorso di <filename>php.exe</filename>. I backslash devono essere preceduti dal carattere di escape '\' ad esempio: <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\php.exe"</literal> Ora inserire questo file di registro nel sistema; dovrebbe bastare un doppio click sul file. </simpara> </listitem> <listitem> <simpara> Nel PWS Manager, click destro nella direttory a cui si vuole aggiungere il supporto PHP e selezionare Proprietà (Properties). Spuntare il checkbox 'Execute' e confermare. </simpara> </listitem> </itemizedlist> </para> <para> Se si opta per il modulo ISAPI, questi sono i passi: <itemizedlist> <listitem> <simpara> Modificare il file <filename>pws-php4cgi.reg</filename> (vedere nella directory SAPI) per inserire il percorso di <filename>php4isapi.dll</filename>. I backslash devono essere preceduti dal carattere di escape '\' ad esempio: <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\sapi\\php4isapi.dll"</literal> Ora inserire questo file di registro nel sistema; dovrebbe bastare un doppio click sul file. </simpara> </listitem> <listitem> <simpara> Nel PWS Manager, click destro nella direttory a cui si vuole aggiungere il supporto PHP e selezionare Proprietà (Properties). Spuntare il checkbox 'Execute' e confermare. </simpara> </listitem> </itemizedlist> </para> </sect2> <sect2 id="install.iis.iis4"> <title>Windows NT/2000/XP con IIS 4 o successivi</title> <simpara> Seguire queste istruzioni per installare il PHP su sistemi NT/2000/XP con IIS 4 o successivi. Si hanno a disposizione due opzioni. Una consiste nell'impostare il PHP come CGI, l'altra consiste nell'usare il modulo ISAPI. </simpara> <simpara> In emtranbi i casi occorre avviare la Microsoft Management Console (può essere presente come 'Internet Services Manager', sia nel Windows NT 4.0 Option Pack o nel Pannello di controllo (Control Panel)=>Administrative Tools sotto Windows 2000/XP). Quindi click destro sul nodo Web server (questo molto probabilmente comparirà come 'Default Web Server'), e selezionare 'Proprietà' ('Properties'). </simpara> <para> Se si desidera installare il PHP come CGI seguire i seguenti passi: <itemizedlist> <listitem> <simpara> Sotto 'Home Directory', 'Virtual Directory', o 'Directory', cliccare sul bottone 'Configuration', ed entrare in App Mappings. </simpara> </listitem> <listitem> <simpara> Premere Add, e nel box Executable digitare. <literal>c:\php\php.exe</literal> (assumendo che il PHP si trovi in c:\php\). </simpara> </listitem> <listitem> <simpara> Nel box Extension, digitare l'estensione dei file che si vuole associare come script PHP. Lasciare bianco 'Method exclusions' e selezionare il checkbox Script engine. Si potrebbe anche selezionare il box 'check that file exists', con una ridotta penalizzazione nella velocità, IIS (o PWS) controlleranno che lo script esista ed eseguiranno l'autentificazione prima di lanciare il PHP. Questo significa avere più errori di tipo 404 piuttosto che avere degli errori CGI dovuti al fatto che il PHP non ha dato in output alcun dato. </simpara> <simpara> Occorre eseguire il passo precedente per ogni estensione che si desideri associare al PHP. <literal>.php</literal> and <literal>.phtml</literal> sono le più comuni, anche <literal>.php3</literal> può essere richiesta per compatibilità verso il passato. </simpara> </listitem> <listitem> <simpara> Impostare le opzioni di sicurezza. (Può essere fatto dal Internet Service Manager), e se il server utilizza come file system NTFS, aggiungere i diritti di esecuzione per I_USR alla directory che contiene il <literal>php.exe</literal>. </simpara> </listitem> </itemizedlist> </para> <para> Per impostare il modulo ISAPI occorre: <itemizedlist> <listitem> <simpara> Se non si desidera eseguire l'autenticazione HTTP con il PHP, si può (si dovrebbe) saltare questo passo. Nei filtri ISAPI, aggiungere un nuovo filtro. Indicare PHP come nome del filtro, e indicare il percorso di php4isapi.dll. </simpara> </listitem> <listitem> <simpara> Nella 'Home Directory', cliccare sul bottone 'Configuration'. Aggiungere una nuova riga nel 'Application Mappings'. Indicare il percorso di php4isapi.dll come Executable, dare <literal>.php</literal> come estensione, lasciare bianco Method exclusions, e selezionare il checkbox Script engine. </simpara> </listitem> <listitem> <simpara> Fermare completamente IIS (NET STOP iisadmin) </simpara> </listitem> <listitem> <simpara> Attivare IIS (NET START w3svc) </simpara> </listitem> </itemizedlist> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/chapters/install.linux.xml +++ phpdoc-it/chapters/install.linux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <sect1 id="install.linux"> <title>Installazione su Unix/Linux</title> <para> Questa sezione contiene note e suggerimenti specifici dell'installazione di PHP su distribuzioni Unix. </para> <sect2 id="install.linux.packages"> <title>Uso dei pacchetti</title> <simpara> Diverse distribuzioni Linux hanno un qualche metodo per installare i pacchetti tipo RPM. Questo può aiutare nell'impostare una configurazione standard, ma se si desidera avere delle caratteristiche differenti (tipo un server sicuro, driver per database differenti) occorre compilare il PHP e/o il server web. Se non si è pratici nella compila del software, potrebbe essere conveniente cercare qualcuno che abbia già pacchettizzato una versione di PHP con le caratteristiche desiderate. </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->