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. |
Ejecute Regedit.
Navegue hasta: HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap.
En el menú de edición elija: New->String Value.
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"
Parar IIS completamente (NET STOP iisadmin)
Arrancar IIS de nuevo (NET START w3svc)