cvs: phpdoc-ca /install/windows manual.xml
[email protected] ("Eduard Capell Brufau") Fri, 05 Aug 2005 09:05:31 -0000
| Newsgroups | php.doc.ca |
|---|---|
| Message-ID | <cvseduardcapell1123232731@cvsserver> |
--eduardcapell1123232731
Content-Type: text/plain
eduardcapell Fri Aug 5 05:05:31 2005 EDT
Added files:
/phpdoc-ca/install/windows manual.xml
Log:
--eduardcapell1123232731
Content-Type: text/plain
Content-Disposition: attachment; filename="eduardcapell-20050805050531.txt"
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
-->
--eduardcapell1123232731--