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

--eduardcapell1123416986
Content-Type: text/plain

eduardcapell		Sun Aug  7 08:16:26 2005 EDT

  Added files:                 
    /phpdoc-ca/install/windows	iis.xml 
  Log:
  
  
--eduardcapell1123416986
Content-Type: text/plain
Content-Disposition: attachment; filename="eduardcapell-20050807081626.txt"


http://cvs.php.net/co.php/phpdoc-ca/install/windows/iis.xml?r=1.1&p=1
Index: phpdoc-ca/install/windows/iis.xml
+++ phpdoc-ca/install/windows/iis.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect1 id="install.windows.iis">
 <title>Microsoft IIS / PWS</title>
 <para>
  Aquesta secció contè notes i consells específics per IIS (Microsoft 
  Internet Information Server).
 </para>

 &warn.install.cgi;

 <sect2 id="install.windows.iis.general">
  <title>Consideracions generals per totes les instal·lacions de PHP en 
  IIS</title>
  <para>
   <itemizedlist>
    <listitem>
     <simpara>
      Primer, llegiu-vos el <link linkend="install.windows.manual">Manual
      d'Instruccions d'Instal·lació</link>. No us salteu aquest pas, ja que 
      us proporcionarà informació fonamental per la instal·lació sobre Windows.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Els usuaris de CGI han d'establir la directiva 
      <link linkend="ini.cgi.force-redirect">cgi.force_redirect</link> a 
      <literal>0</literal>, dins del fitxer &php.ini;. 
      Llegiu-vos les <link linkend="faq.installation.forceredirect">Preguntes 
      Més Freqüents sobre cgi.force_redirect</link> per detalls importants. A
      més, és molt probable que els usuaris de CGI vulguin establir el valor 
      de la directiva <link linkend="ini.cgi.redirect-status-env">
      cgi.redirect_status_env</link> directive. Quan utilitzeu directives, 
      assegureu-vos que aquestes directives no estan comentades al fitxer 
      &php.ini;.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     El CGI de PHP 4 s'anomena <filename>php.exe</filename>, i en PHP 5 és 
     <filename>php-cgi.exe</filename>. A PHP 5, el fitxer 
     <filename>php.exe</filename> correspon al CLI, i no al CGI.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Modifiqueu la variable d'entorn de Windows <literal>PATH</literal> per
      incloure-hi el directori de PHP. Així, les DLL, els executables PHP, i el
      fitxer &php.ini; poden romandre al directori de PHP sense fer nosa dins de
      la carpeta de sistema de Windows. Per més detalls, llegiu les Preguntes
      Més Freqüents sobre 
      <link linkend="faq.installation.addtopath">Especificar el PATH</link>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      L'usuari IIS (normalment IUSR_NOMMAQUINA) necessita permissos per a poder
      llegir diversos fitxers i directoris, com ara &php.ini;, docroot, i el
      directori tmp de sessions.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Assegureu-vos que les directives PHP 
      <link linkend="ini.extension-dir">extension_dir</link> 
      i <link linkend="ini.doc-root">doc_root</link> estan especificades 
      de manera apropiada en el fitxer &php.ini;. Aquestes directives depenen 
      del sistema on tenim instal·lat el PHP. A PHP 4, extension_dir (el 
      directori on tenim les extensions) és 
      <filename>extensions</filename> mentre que a PHP 5 aquest directori és  
      <filename>ext</filename>. Per tant, un valor correcte d'extension_dir 
      és <filename>"c:\php\ext"</filename> i un exemple de doc_root per IIS 
      podria ser <filename>"c:\Inetpub\wwwroot"</filename>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Els fitxers DLL d'extensions PHP, com ara 
      <filename>php_mysql.dll</filename> i   
      <filename>php_curl.dll</filename>, les trobem a l'arxiu zip descarregat de
      PHP (no a l'instal·lador). A PHP 5, moltes extensions són part de PECL i
      es poden descarregar al paquet "Col·lecció de mòduls PECL". Fitxers com
      ara <filename>php_zip.dll</filename> i <filename>php_ssh2.dll</filename>. 
      <ulink url="&url.php.downloads;">Descàrregues de fitxers PHP</ulink>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      En la definició de l'executable, es pot seleccionar el quadre 
      'comprovar que el fitxer existeixi'. Amb una petita penalització del
      rendiment, IIS (o PWS) comprovarà que el fitxer de l'script existeixi i 
      gestionarà l'autenticació abans d'executar el PHP. Això vol dir que el
      servidor web pot proporcionar missatges d'error 404 molt més entenedors
      que no els errors CGI que es queixen que el PHP no ha produït dades.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </sect2>

 <sect2 id="install.windows.iis.iis4">
  <title>Windows NT/200x/XP i IIS 4 o posterior</title>

  <simpara>
   El PHP es pot instal·lar com a binari CGI, o bé com a mòdul ISAPI.
   En qualsevol dels dos casos, necessiteu arrencar amb la Microsoft Management
    Console (potser ho veieu com a 'Internet Services Manager', que trobareu a
    la secció Opcion Pack del Windows NT 4.0, o bé al Tauler de
    Control=&gt;Eines d'Administració, en Windows 2000/XP). Llavors feu click
    amb el botó dret del node del servidor web que us interessi (probablement
    'Servidor Web per Defecte'), i trieu 'Propietats'.
  </simpara>

  <para>
   Si voleu utilitzar el binari CGI, feu el següent:
   <itemizedlist>
    <listitem>
     <simpara>
      Dins de 'Directori Principal (Home Directory)', 'Directori Virtual', o bé
      'Directori', feu el següent:
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Canvieu els Permissos d'Execució a 'Només Seqüències'
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Feu click en el botó de 'Configuració', i tireu la pestanya de mapatge
      d'Aplicacions. Feu click en Afegir i especifiqueu la ruta de l'Executable
      al valor del fitxer CGI que correspongui.
      Un exemple de valor per PHP 5 seria: 
      <filename>C:\php\php-cgi.exe</filename>
      Heu d'indicar <literal>.php</literal> com a extensió. Deixeu en blanc
      l'opció 'Exclusions de Mètodes' i marqueu el quadre de 'Motor de
      Seqüències'. Ara, clickeu en OK uns quants cops fins a sortir.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Establiu la seguretat més apropiada. (Això és fa en el Gestor del Servei
      d'Internet), i si el vostre Servidor NT utilitza el sistema de fitxers
      NTFS, afegiu permissos d'execució a I_USR_ pel directori que contingui el
      fitxer <filename>php.exe</filename> / <filename>php-cgi.exe</filename>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <para>
   Si voleu utilitzar el mòdul ISAPI, feu el següent:
   <itemizedlist>
    <listitem>
     <simpara>
      Si no voleu utilitzar l'Autenticació HTTP en PHP, podeu (i hauríeu de
      fer-ho així), saltar-vos aquest pas. En Filtres ISAPI, afegiu un nou 
      filtre ISAPI. Especifiqueu PHP com a nom de filtre, i proveïu una ruta pel
      fitxer <filename>php4isapi.dll</filename> / 
      <filename>php5isapi.dll</filename>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      En 'Directori Principal' (Home Directory), 'Directori Virtual', o
      'Directori', afegiu el següent:
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Canvieu els Permissos d'Execució a 'Només Seqüències'
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Feu click al botó de 'Configuració', i trieu la pestanya de Mapatges
      d'Aplicació. Feu click en Afegir i especifiqueu la ruta de l'Executable al
      valor apropiat per la DLL ISAPI. Un exemple de valor per PHP 5 seria: 
      <filename>C:\php\php5isapi.dll</filename>
      Indiqueu <literal>.php</literal> com a extensió. Deixeu en blanc l'opció
      'Exclusions de Mètodes', i marqueu la quadre 'Motor de Seqüències'. Ara,
      feu click en OK uns quants cops fins a sortir.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Atureu completament l'IIS (NET STOP iisadmin)
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Ara inicieu l'IIS (NET START w3svc)
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <para>
   En IIS 6 (2003 Server), obriu el gestor IIS (IIS Manager), aneu a les
   Extensions de Serveis Web, trieu "Afegir una nova extensió de Servei Web",
   introduïu un nom, com ara PHP, clickeu en el botó Afegir i navegueu fins que
   trieu un valor que serà o bé ISAPI (<filename>php4isapi.dll</filename> o
   <filename>php5isapi.dll</filename>) o bé CGI 
   (<filename>php.exe</filename> o <filename>php-cgi.exe</filename>), i llavors 
   marqueu el valor "Permetre les extensions" i feu click en OK.
  </para>
  <para>
   Per tal d'utilitzar <filename>index.php</filename> com a pàgina per defecte
   del context, feu el següent: Des de la pestanya de Documents, trieu Afegir.
   Introduïu el valor <filename>index.php</filename> i feu click en OK. 
   Ajusteu l'ordre, triant Moure cap Amunt o Moure cap Avall. Això és similar a
   l'especificació de DirectoryIndex en l'Apache.
  </para>
  <para>
   El pas anterior s'ha de repetir per cada extensió que es vulgui
   associar als scripts PHP. <literal>.php</literal> és l'extensió més habitual, 
   però potser per compatibilitat amb aplicacions antigues, és possible que hi 
   volgúessim afegir <literal>.php3</literal> .
  </para>
  <para>
   Si veieu que hi ha un ús del 100% de la CPU després d'un temps, poseu en
   blanc l'opció <literal>Guardar l'Aplicació ISAPI en Memòria Cauz</literal>.
  </para>
 </sect2>

 <sect2 id="install.windows.iis.pws4">
  <title>Windows i PWS 4</title>
  <simpara>
   El PWD 4 no suporta ISAPI, només es pot fer servir PHP CGI.
  </simpara>
  <para>
   <itemizedlist>
    <listitem>
     <simpara>
      Editeu l'arxiu <filename>pws-php4cgi.reg</filename> /
      <filename>pws-php5cgi.reg</filename> (busqueu-lo en la carpeta SAPI de PHP
      4, o a la carpeta principal de PHp 5) per tal d'indicar el valor apropiat 
      del fitxer <filename>php.exe</filename> / <filename>php-cgi.exe</filename>.
      Cal que escapeu les barres inverses, per exemple:
      <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script
       Map] ".php"="C:\\php\\php.exe"</literal> (canvieu-ho a
      <literal>C:\\php\\php-cgi.exe</literal> si utilitzeu PHP 5)
      Ara apliqueu els canivs d'aquest fitxer en el registre del sistema; això
      es fa fent doble click sobre el fitxer.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Al gestor de PWS, feu click amb el botó dret sobre la carpeta per la qual
      vulguem afegir suport PHP, i trieu Propietats. Marqueu el quadre
      'Executar', i confirmeu-ho.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </sect2>

 <sect2 id="install.windows.iis.iis3">
  <title>Windows i PWS/IIS 3</title>
  <simpara>
   El mètode recomanat per la configuració d'aquests servidors és l'ús del
   fitxer REG inclòs en la distribució
   (<filename>pws-php4cgi.reg</filename> al directori SAPI en PHP 4, o 
   <filename>pws-php5cgi.reg</filename> a la carpeta principal de PHP 5).
   Potser necessitareu editar aquest fitxer per assegurar-vos que les
   extensions i els directoris d'instal·lació del PHP coincideixen amb la vostra
   configuració. Si no voleu editar aquest fitxer, podeu seguir els passos
   següents.
  </simpara>
  <warning>
   <para>
    Aquests passos suposen que treballareu directament amb el registre de
    Windows. Qualsevol error en aquesta tasca us pot deixar amb un sistema
    inestable. És molt recomanable que feu una còpia de seguretat del registre
    abans de començar. L'Equip de Desenvolupament de PHP no es farà responsable
    del fet que danyeu el vostre registre.
   </para>
  </warning>

  <para>
   <itemizedlist>
    <listitem>
     <simpara>
      Executeu Regedit.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Navegueu a: <literal>HKEY_LOCAL_MACHINE /System
       /CurrentControlSet /Services /W3Svc /Parameters
       /ScriptMap</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Al menú Edició, seleccioneu: <literal>Nou->Valor de Cadena de 
      Text</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Teclegeu l'extensió que voleu utilitzar pels vostres scripts php. Per 
      exemple <literal>.php</literal>
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Feu doble click en el nou valor de cadena de text, i entreu la ruta al 
      <filename>php.exe</filename> el el camp pel valor. ex:
      <filename>C:\php\php.exe "%s" %s</filename> per PHP 4, o
      <filename>C:\php\php-cgi.exe "%s" %s</filename> per PHP 5.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Repetiu aquests passos per cada extensió que vulvueu associar amb
      seqüències PHP.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <para>
   Els següents passos no afectaran la instal·lació del servidor i només tindran
   efecte si voleu que les seqüències PHP s'executin quan siguin cridades des de
   la línia de comanda (ex. executant 
   <filename>C:\myscripts\test.php</filename>) o fent doble click sobre aquestes
   seqüències. Potser no us interessaran aquestes instruccions que venen a
   continuació, ja que és probable que preferiu de carregar els fitxers PHP en
   un editor de text quan hi feu doble click.
  </para>
  <para>
   <itemizedlist>
    <listitem>
     <simpara>
      Navegueu a: <literal>HKEY_CLASSES_ROOT</literal>
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Al menú Edició, seleccioneu: <literal>Nova->Clau</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Doneu-liu un nom a la clau, que serà el nom de l'extensió que hem acabat
      de configurar a la secció anterior. ex: <literal>.php</literal>
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Seleccioneu la nova clau, i a la banda esquerra de la pantalla, feuu doble
      click en "valor per defecte" i introduiu-hi <literal>phpfile</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Repetiu el darrer pas per cada extensió que he configurat en la seccio
      anterior.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Ara creeu una altra clau (<literal>Nova->Clau</literal>) en
      <literal>HKEY_CLASSES_ROOT</literal> i anomeneu-la
      <literal>phpfile</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Seleccioneu la nova clau <literal>phpfile</literal>, i, a la banda dreta
      de la pantalla, feu doble click en "valor per defecte" i introduiu-hi 
      <literal>PHP Script</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Feu click al botó dret en la clau <literal>phpfile</literal> i seleccioneu 
      <literal>Nova->Clau</literal>, i anomeneu-la <literal>Shell</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Feu click amb el botó dret en la clau <literal>Shell</literal> i 
      seleccioneu <literal>Nova->Clau</literal>, anomeneu-la 
      <literal>open</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Feu click amb el botó dret en la clau<literal>open</literal>, trieu 
      <literal>Nova->Clau</literal>, i anomeneu-la <literal>command</literal>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Seleccioneu la clau <literal>command</literal>, i, a la banda dreta de la
      pantalla, feu doble click en "valor per defecte" i introduiu-hi la ruta al
      fitxer <filename>php.exe</filename>. ex:
      <literal>c:\php\php.exe -q %1</literal>. (no us oblideu de 
      <literal>%1</literal>).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Sortiu del Regedit.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Si utilitzeu PWD en Windows, reinicieu la màquina per tal de recarregar 
      el registre.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <simpara>
   Els usuaris de PWS i IIS 3 ara ja teniu un sistema completament operatiu. Els
   usuaris de IIS 3 tenen una <ulink url="&url.iiscfg;">tool</ulink> interessant
   feta per en Steven Genusa que serveix per a configrar els mapatges dels 
   scripts.
  </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
-->

--eduardcapell1123416986--