cvs: phpdoc-ca /install/windows manual.xml

eduardcapell Fri Aug 5 05:05:31 2005 EDT Added files: /phpdoc-ca/install/windows manual.xml Log:

http://cvs.php.net/co.php/phpdoc-ca/install/windows/manual.xml?r=1.1&p=1 Index: phpdoc-ca/install/windows/manual.xml +++ phpdoc-ca/install/windows/manual.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.18 Maintainer: eduardcapell Status: ready --> <sect1 id="install.windows.manual"> <title>Passos per la Instal·lació Manual</title> <para> Aquesta guia us ajudarà a instal·lar i configurar manualment el PHP amb un servidor web en Microsoft Windows. Per començar, caldrà que us descarregueu un fitxer zip amb la distribució binària de la pàgina de descàrregues a <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. </para> <para> Tot i que hi ha molts kits d'instal·lació "tot en un", i que nosaltres també distribuïm un instal·lador de PHP per Microsoft Windows, us recomanem que us prengueu el temps que calgui per tal de configurar el PHP per vosaltres mateixos, la qual cosa farà que entengueu millor el sistema, i us facilitarà la instal·lació d'extensions PHP quan faci falta. </para> <note id="install.windows.manual.upgrade"> <title>Actualitzacions des de versions anteriors de PHP</title> <para> Les edicions anteriors del manual us suggereixen que moveu diversos fitxers ini i <acronym>DLL</acronym> al directori SYSTEM (és a dir, <filename class="directory">C:\WINDOWS</filename>), i, tot i que això simplifica el procediment d'instal·lació, fa que l'actualització resulti més difícil. Us aconsellem que elimineu tots aquests fitxers (com ara &php.ini; i els fitxers DLL relacionats amb PHP del directori SYSTEM de Windows) abans de continuar amb una nova instal·lació de PHP. Assegureu-vos de fer còpies de seguretat d'aquests fitxers, perquè podríeu fer malbé el sistema. A més, l'antic fitxer &php.ini; us podria ser útil a l'hora de configurar el nou PHP. I, com aviat us adonareu, el mètode preferit d'instal·lació de PHP és guardar tots els fitxers que tenen a veure amb PHP en un directori, i tenir aquest directori disponible en el PATH del sistema. </para> </note> <note> <title>Requeriments MDAC</title> <para> Si utilitzeu Microsoft <emphasis>Windows 98/NT4</emphasis>, descarregueu-vos la versió més recent de Microsoft Data Access Components (MDAC, Components d'Accés a Dades de Microsoft) per la vostra plataforma. MDAC és a <ulink url="&url.mdac;">&url.mdac;</ulink>. Aquest requeriment existeix perquè l'<link linkend="ref.uodbc">ODBC</link> està muntat en els binaris de Windows que es distribueixen. </para> </note> <para> Els següents passos s'haurien de completar en totes les instal·lacions abans d'executar qualsevol instrucció específica per cada servidor: </para> <para> Extraieu el fitxer de la distribució en el directori que vulgueu. Si instal·leu PHP 4, extraieu-lo a <filename class="directory">C:\</filename>, ja que l'arxiu zip es descomprimirà a un nom de directori com <filename>php-4.3.7-Win32</filename>. Si esteu instal·lant PHP 5, extraieu l'arxiu a <filename class="directory">C:\php</filename>, ja que l'arxiu zip no es decomprimirà igual que en PHP 4. Podeu triar qualsevol ubicació que no tingui espais al nom de la ruta (com seria el cas de <filename class="directory">C:\Arxius de Programa\PHP</filename>) perquè alguns servidors web podrien fallar si ho féssiu així. </para> <para> L'estructura de directoris després d'extraure l'arxiu zip és diferent entre les versions 4 i 5, i s'hauria d'assemblar a: </para> <example> <title>Estructura de PHP 4</title> <programlisting> <![CDATA[ c:\php | +--cli | | | |-php.exe -- executable CLI (Interfície de Línia de Comandes, | TAN SOLS per seqüències en línia de comanda | +--dlls -- DLLs de suport requerides per algunes extensions | | | |-expat.dll | | | |-fdftk.dll | | | |-... | +--extensions -- DLLs d'extensions per PHP | | | |-php_bz2.dll | | | |-php_cpdf.dll | | | |-.. | +--mibs -- fitxers de suport per SNMP | +--openssl -- fitxers de suport per Openssl | +--pdf-related -- fitxers de suport per PDF | +--sapi -- DLLs de SAPI (suport pel mòdul de servidor) | | | |-php4apache.dll | | | |-php4apache2.dll | | | |-.. | +--PEAR -- còpia inicial de PEAR | | |-go-pear.bat -- seqüència de configuració de PEAR | |-.. | |-php.exe -- executable CGI | |-.. | |-php.ini-dist -- configuració per defecte de php.ini | |-php.ini-recommended -- configuració recomanada de php.ini | |-php4ts.dll -- DLL central de PHP | |-... ]]> </programlisting> </example> <para> O bé: </para> <example> <title>Estructura de PHP 5</title> <programlisting> <![CDATA[ c:\php | +--dev | | | |-php5ts.lib | +--ext -- DLLs d'extensions per PHP | | | |-php_bz2.dll | | | |-php_cpdf.dll | | | |-.. | +--extras | | | +--mibs -- fitxers de suport per SNMP | | | +--openssl -- fitxers de suport d'Openssl | | | +--pdf-related -- fitxers de suport per PDF | | | |-mime.magic | +--pear -- còpia inicial de PEAR | | |-go-pear.bat -- seqüència de configuració de PEAR | |-fdftk.dll | |-.. | |-php-cgi.exe -- executable CGI | |-php-win.exe -- executa seqüències sense una línia de comanda | oberta | |-php.exe -- executable CLI (Interfície de Línia de Comandes, | TAN SOLS per seqüències en línia de comanda | |-.. | |-php.ini-dist -- configuració per defecte per php.ini | |-php.ini-recommended -- configuració recomanada per php.ini | |-php5activescript.dll | |-php5apache.dll | |-php5apache2.dll | |-.. | |-php5ts.dll -- DLL central de PHP | |-... ]]> </programlisting> </example> <para> Observeu les diferències i similaritats. Tant el PHP 4 com el PHP 5 tenen un executable <acronym>CGI</acronym> un executable <acronym>CLI</acronym>, i mòduls de servidor, però estan situats en diferents carpetes i/o tenen noms diferents. Mentre que els paquets de PHP 4 tenen els mòduls del servidor en la carpeta <filename class="directory">sapi</filename>, les distribucions del PHP 5 no tenen aquest directori, sinó que els mòduls del servidor són al directori arrel del PHP. Les DLLs de suport per les extensions tampoc no són en una carpeta separada. </para> <note> <para> En PHP 4, hauríeu de moure tots els fitxers situats a les carpetes <filename class="directory">dll</filename> i <filename class="directory">sapi</filename> cap a la carpeta original, per exemple <filename class="directory">C:\php</filename>). </para> </note> <para> Aquí teniu una llista de mòduls de servidor que s'inclouen en el PHP 4 i el PHP 5: <itemizedlist> <listitem><para> <filename>sapi/php4activescript.dll (php5activescript.dll)</filename> - <link linkend="install.windows.activescript">El motor d'ActiveScript </link>, que us pemetrà d'incrustar PHP en les vostres aplicacions Windows. </para></listitem> <listitem><para> <filename>sapi/php4apache.dll (php5apache.dll)</filename> - El mòdul d'Apache 1.3.x. </para></listitem> <listitem><para> <filename>sapi/php4apache2.dll (php5apache2.dll)</filename> - El mòdul d'Apache 2.0.x. </para></listitem> <listitem><para> <filename>sapi/php4isapi.dll (php5isapi.dll)</filename> - El mòdul ISAPI per servidors ISAPI, com ara IIS 4.0/PWS 4.0 o posterior. </para></listitem> <listitem><para> <filename>sapi/php4nsapi.dll (php5nsapi.dll)</filename> - El mòdul de servidor per Sun/iPlanet/Netscape. </para></listitem> <listitem><para> <filename>sapi/php4pi3web.dll (sense equivalència en PHP 5)</filename> - El mòdul de servidor de Pi3Web. </para></listitem> <!-- TODO: servlets? --> </itemizedlist> </para> <para> Els mòduls de servidor proporcionen un rendiment significativament superior i funcionalitats addicionals, comparant-los amb el binari CGI. La versió CLI s'ha dissenyat per tal que utilitzeu el PHP per a seqüències en la línia de comanda. Teniu més informació sobre CLI al capítol sobre <link linkend="features.commandline">l'ús de PHP des de la línia de comanda</link>. </para> <warning> <simpara> Els mòduls SAPI s'han millorat força des de la versió 4.1. No obstant això, en sistemes antics podeu trobar-vos alguns errors del servidor o errors en d'altres mòduls, com ara ASP. </simpara> </warning> <para> Els binaris CGI i CLI, i els mòduls dels servidors web requereixen el fitxer <filename>php4ts.dll</filename> (<filename>php5ts.dll</filename>) per tal que funcionin correctament. La instal·lació de PHP ha de trobar aquest fitxer. L'ordre de cerca d'aquesta DLL és el següent: <itemizedlist> <listitem> <para> El mateix directori des d'on es crida el <filename>php.exe</filename>, o si utilitzeu un mòdul SAP, el directori del servidor web (per exemple, <filename>C:\Program Files\Apache Group\Apache2\bin</filename>). </para> </listitem> <listitem> <para> Qualsevol directori present a la variabla d'entorn de Windows <varname>PATH</varname>. </para> </listitem> </itemizedlist> </para> <para> Per tal que el fitxer <filename>php4ts.dll</filename> / <filename>php5ts.dll</filename> estigui disponible, teniu tres opcions: copiar el fitxer al directori de sistema de Windows, copiar el fitxer al directori del servidor web, o afegir el vostre directori de PHP, <filename class="directory">C:\php</filename> a la variable d'entorn <varname>PATH</varname>. Per a un millor manteniment, us aconsellem que opteu per la darrera opció, afegint <filename class="directory">C:\php</filename> al <varname>PATH</varname>, perquè serà més senzill d'actualitzar PHP en el futur. Per saber com afegir el vostre directori de PHP a la variable <varname>PATH</varname>, podeu llegir-ho a l'<link linkend="faq.installation.addtopath">entrada corresponent de les Preguntes Més Freqüents</link>. </para> <para> El següent pas consisteix en l'establiment d'un arxiu de configuració vàlid per PHP, &php.ini;. Hi ha dos fitxers ini que es distribueixen amb l'arxiu zip, <filename>php.ini-dist</filename> and <filename>php.ini-recommended</filename>. Us aconsellem que utilitzeu <filename>php.ini-recommended</filename>, perquè hem optimitzat els valors per defecte pel millor rendiment i la millor seguretat. Llegiu aquest fitxer, que està ben documentat, i llegiu-lo amb atenció, perquè té canvis respecte de <filename>php.ini-dist</filename>, canvis que afectaran dràsticament la configuració. Alguns exemples són <link linkend="ini.display-errors"> display_errors</link>, que està a <literal>off</literal>, i <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>, que també està a <literal>off</literal>. A més de llegir-vos aquests documents, estudieu els <link linkend="configuration.file">paràmetres ini</link> i especifiqueu cada element de forma manual. Si voleu la màxima seguretat, aquesta és l'opció més apropiada, tot i que el PHP funciona correctament amb els valors ini per defecte. Quan tingueu el fitxer ini tal com el volíeu, copieu-lo a un directori que PHP sigui capaç de trobar, i renomeneu-lo a &php.ini;. El PHP cerca el fitxer &php.ini; a les ubicacions que descrites a la secció de <xref linkend="configuration.file"/>. </para> <para> Si feu servir Apache 2, l'opció més simple és l'ús de la directiva PHPIniDir (llegiu la pàgina d' <link linkend="install.windows.apache2">instal·lació sobre Apache 2</link>),i si no, la millor opció és que creeu la variable d'entorn <varname>PHPRC</varname>. Aquest procés se us explica a la següent <link linkend="faq.installation.phprc">entrada de les Preguntes Més Freqüents</link>. </para> <note> <simpara> Si utilitzeu NTFS sobre Windows NT, 2000, XP o 2003, assegureu-vos que l'usuari que executa el servidor web té permissos de lectura sobre el fitxer &php.ini; (una opció seria fer-lo llegible per tothom). </simpara> </note> <para> Els següents passos són opcionals: <itemizedlist> <listitem> <para> Editeu el nou fitxer &php.ini;. Si teniu intenció d'utilitzar <link linkend="install.windows.omnihttpd">OmniHTTPd</link>, no seguiu el pas següent. El valor <link linkend="ini.doc-root">doc_root</link> ha d'apuntar a la carpeta document_root del servidor web. Per exemple: <informalexample> <programlisting role="ini"> <![CDATA[ doc_root = c:\inetpub\wwwroot // per IIS/PWS doc_root = c:\apache\htdocs // per Apache ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <simpara> Trieu les extensions que voleu que es carreguin quan s'iniciï el PHP. Vegeu la secció sobre <link linkend="install.windows.extensions">extensions en Windows</link>, sobre com configurar-les, i per saber quines ja es carreguen per defecte. Observeu que en una instal·lació nova, es recomana que provem abans que res que el PHP funciona sense afegir-hi cap extensió. Després, les anem afegint al fitxer &php.ini;. </simpara> </listitem> <listitem> <simpara> En PWD i IIS, podeu especificar el valor <link linkend="ini.browscap">browscap</link> per tal que apunti a: <filename>c:\windows\system\inetsrv\browscap.ini</filename> en Windows 9x/Me, <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> en NT/2000, i <filename>c:\windows\system32\inetsrv\browscap.ini</filename> en XP. Per un fitxer <filename>browscap.ini</filename> actualitzat, llegiu les següents <link linkend="faq.obtaining.browscap">Preguntes Més Freqüents</link>. </simpara> </listitem> </itemizedlist> </para> <para> El PHP ara està configurat pel vostre sistema. El següent pas és l'elecció d'un servidor web, i configurar-lo per a executar PHP. Trieu un servidor web de la taula de continguts. </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 -->