Esta sección contiene información específica
sobre la instalación de PHP con IIS
(Microsoft Internet Information Server), versiones PWS/IIS 3, PWS 4 ó posterior y IIS 4 ó posterior
Importante para usuarios de la versión CGI:
Leer la faq sobre
cgi.force_redirect para más detalles. Esta
directiva debe de tener el valor 0.
El método recomendado para configurar estos servidores es
usar el archivo REG incluído con la distribución
(pws-php4cgi.reg). Quizás desee editar este archivo y
asegurarse que las extensiones y directorios de instalación
se ajustan a su configuración. O puede seguir los pasos que
siguen para hacerlo de forma manual.
Aviso
Estos pasos conllevan el trabajar directamente con el registro de
windows. Un error aquí puede dejar su sistema en un estado
inestable. Le recomendamos encarecidamente que haga una copia de
seguridad del registro con antelación. El equipo de
Desarrollo del PHP no se hará responsable si se
daña su registro.
Escriba la extensión que desea usar para sus script
PHP. P.ej.: .php
Haga una doble pulsación con el ratón en el nuevo valor de
cadena y escriba la localización de php.exe
en el campo del valor. P.ej.:
c:\php\php.exe.
Repita estos pasos para cada extensión que desee asociar
con los scripts PHP.
Los pasos siguientes no afectan a la instalación del servidor web y
solamente sirven si quereis ejecutar vuestros scripts en PHP desde
la linea de comandos (p.ej:
c:\myscripts\test.php) ó haciendo una
pulsación doble con el ratón desde una ventana del visualizador de
directorios. Podeis saltaros estos pasos si quereis que los
ficheros en PHP se abran en un editor cuando hagais una doble
pulsación sobre ellos.
Navegue hasta: HKEY_CLASSES_ROOT
En el menú de edición elija:
New->Key.
Déle a la clave el nombre de la extensión que
preparó en la sección anterior. P.ej.:
.php
Marque la nueva clave y en el panel del lado derecho haga una
doble pulsación en "default value" y escriba
phpfile.
Repita el último paso para cada extensión que
haya preparado en la sección previa.
Ahora cree otra New->Key bajo
HKEY_CLASSES_ROOT y denomínela
phpfile.
Marque la nueva clave phpfile, haga una
doble pulsación en el panel derecho sobre "default value" y
escriba PHP Script.
Pulse el botón derecho sobre la clave
phpfile, seleccione
New->Key y llámela
Shell.
Pulse el botón derecho sobre la clave
Shell ,elija New->Key y
llámela open.
Pulse el botón derecho sobre la clave
open y elija New->Key y
llámela command.
Marque la nueva clave command y en el panel
derecho haga una doble pulsación sobre "default value" y escriba
la localización de php.exe. P.ej.:
c:\php\php.exe -q %1. (no olvide el
%1).
Salga de Regedit.
Si está usando PWS en Windows, tendra que arrancar la maquina de
nuevo para que se carge el registro.
Los usuarios de PWS e IIS3 tienen ahora un sistema completamente
operativo. Los usuarios del IIS3 también pueden usar una
curiosa herramienta de Steven
Genusa para configurar sus mapeados de script.
Existen dos opciones para instalar PHP en Windows con PWS 4 ó
posterior. Una es el binario CGI de PHP y la otra el módulo DLL
ISAPI.
Si elegis el binario CGI, teneis que hacer lo siguiente:
Editar el fichero que se incluye con PHP llamado
pws-php4cgi.reg (mirar en el directorio
SAPI) para actualizarlo con la localización de vuestro
php.exe. Las barras invertidas tienen que
escaparse, p.ej:
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script
Map] ".php"="c:\\php\\php.exe". A continuación incluir
este registro en vuestro sistema; podeis hacer esto haciendo una
doble pulsación sobre el mismo, con el ratón.
En el administrador de PWS, hacer una doble pulsación con el
botón derecho del ratón, sobre el directorio donde quereis
añadir soporte para PHP, seleccionar "Properties", elegir
"Execute" y confirmar.
Si elegis el módulo ISAPI, teneis que hacer lo siguiente:
Editar el fichero que se incluye con PHP llamado
pws-php4isapi.reg (mirar en el directorio
SAPI) para actualizarlo con la localización de vuestro
php4isapi.dll. Las barras invertidas tienen
que escaparse, p.ej:
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script
Map] ".php"="c:\\php\\sapi\\php4isapi.dll". A
continuación incluir este registro en vuestro sistema; podeis
hacer esto haciendo una doble pulsación sobre el mismo, con el
ratón.
En el administrador de PWS, hacer una pulsación con el botón
derecho del ratón, sobre el directorio donde quereis
añadir soporte para PHP, seleccionar "Properties", elegir
"Execute" y confirmar.
Para instalar PHP en un servidor NT/2000/XP con IIS 4 ó posterior,
teneis que seguir estas instrucciones. Existen dos opciones para
instalar PHP, una es el binario CGI de PHP (php.exe) y la otra el
módulo ISAPI.
En ambos casos necesitais arrancar la "consola de administración de
Microsoft" (Puede encontrarse como 'Administrador de servicios
Internet", bien en vuestro "Windows NT 4.0 Option Pack" ó en el
Control Panel=>Herramientas de administración bajo Windows
2000/XP). Hacer una pulsación con el botón derecho del ratón en el
nodo perteneciente a vuestro servidor web (probablemente aparezca
como "Servidor web por defecto") y seleccionar "Propiedades".
Si elegis el binario CGI, teneis que hacer lo siguiente:
Bajo "Carpeta Inicial", "Directorio Virtual" ó "Directorio",
pulsar en el botón "Configuración" y entrar en la pestaña
"Mapas de aplicaciones".
Pulse en ""Añadir", y en la caja Programa, escriba:
c:\php\php.exe (suponemos que habeis
descomprimido PHP en c:\php\).
En la caja Extensión, escriba la extensión de
fichero que desea asociar a los script de PHP. Dejar
"Exclusiones de método" vacio y elegir "Motor de
scripts". Tambien podeis elegir "comprobar que el fichero
existe" - por una pequeña perdida en el rendimiento, IIS
(ó PWS) comprobará que el script existe antes de usar php. Esto
significa que obtendremos errores del tipo 404 en vez de errores
cgi diciendo que php no devolvio ningún dato.
Debereis de repetir el paso anterior por cada extensión que
querais asociar con PHP. .php y
.phtml son valores comunes, aunque
.php3 puede que sea necesaria para ejecutar
scripts antiguos.
Ajuste la seguridad apropiada (esto se realiza en el
Administrador de Servicio de Internet) y si su NT Server usa
el sistema de archivos NTFS, añada derechos de
ejecución para I_USR_ en el directorio que contenga el
php.exe.
Si elegis el módulo ISAPI, teneis que hacer lo siguiente:
Si no quereis utilizar Autentificación HTTP usando PHP, podeis
(y debeis) de saltaros este paso. Bajo "Filtros ISAPI",
añadir un nuevo filtro ISAPI. Usar PHP como nombre del
filtro y definir la localización del fichero php4isapi.dll.
Bajo "Carpeta Inicial" pulsar en el botón "Configuración" y
añadir un nuevo valor en "Mapas de aplicaciones". Definir
la localización del fichero php4isapi.dll como ejecutable y
.php como la extensión. Dejar "Exclusiones
de método" vacio y elegir "Motor de scripts"
