<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Passos da Instalação Manual</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Manual do PHP" HREF="index.html"><LINK REL="UP" TITLE="Instalação em sistemas Windows" HREF="install.windows.html"><LINK REL="PREVIOUS" TITLE="Instalador do PHP para o Windows (PHP 5.1.0 e anterior)" HREF="install.windows.installer.html"><LINK REL="NEXT" TITLE="ActiveScript" HREF="install.windows.activescript.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="sect1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="install.windows.installer.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Capítulo 6. Instalação em sistemas Windows</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="install.windows.activescript.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="sect1" ><H1 CLASS="sect1" ><A NAME="install.windows.manual" >Passos da Instalação Manual</A ></H1 ><P > Esse guia de instalação ajudará você a instalar manualmente e configurar o PHP com um servidor web no Microsoft Windows. Para começar, você precisará baixar o zip com a distribuição binária da página de downloads em <A HREF="http://www.php.net/downloads.php" TARGET="_top" >http://www.php.net/downloads.php</A >. </P ><P > Embora existam muitos kits de instalação "completos", e nós também distribuímos um instalador do PHP para o Microsoft Windows, nós recomendamos que você se dê ao trabalho de instalar o PHP manualmente uma vez que isso lhe permitirá um melhor entendimento do sistema, e permite que você instale extensões do PHP facilmente quando precisar. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><A NAME="install.windows.manual.upgrade" ></A ><P ><B >Atualizar uma versão instalado do PHP: </B > Edições anteriores do manual sugeriam mover vários arquivo ini e <ACRONYM CLASS="acronym" >DLL</ACRONYM > para o seu diretório SYSTEM (ex.: <TT CLASS="filename" >C:\WINDOWS</TT >) e, embora isso simplifique o processo de instalação, torna a atualização difícil. Nós aconselhamos que você remova esses arquivos (como <TT CLASS="filename" >php.ini</TT > e DLLs relacionadas ao PHP da pasta SYSTEM do Windows) antes de continuar com uma instalação nova do PHP. Assegure-se de fazer um backup desses arquivos já que você pode corromper o sistema inteiro. O arquivo <TT CLASS="filename" >php.ini</TT > da versão anterior a que você quer instalar pode ser útil na versão nova. E, como você aprenderá a seguir, o método preferido para instalar o PHP é manter todos os arquivos relacionados ao PHP em um diretório e disponibilizar esse diretório no PATH do seu sistema. </P ></BLOCKQUOTE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Requerimentos MDAC: </B > Se você usa o Microsoft <SPAN CLASS="emphasis" ><I CLASS="emphasis" >Windows 98/NT4</I ></SPAN >, baixe a última versão do Microsoft Data Access Components (MDAC) para sua plataforma. MDAC está disponível em <A HREF="http://msdn.microsoft.com/data/" TARGET="_top" >http://msdn.microsoft.com/data/</A >. Esse requerimento existe porque <A HREF="missing-stuff.html#ref.uodbc" >ODBC</A > é compilado nos binários distribuídos para o Windows. </P ></BLOCKQUOTE ></DIV ><P > Os passos a seguite devem ser completados em todas as instalações antes de qualquer instruções específicas ao servidor sejam feitas: </P ><P > Extraia o arquivo da distribuição no diretório de sua escolha. Se você estiver instalando o PHP 4, extraia em <TT CLASS="filename" >C:\</TT >, uma vez que o arquivo zip expande para uma pasta de nome parecido com <TT CLASS="filename" >php-4.3.7-Win32</TT >. Se você estiver instalando o PHP 5, extraia em <TT CLASS="filename" >C:\php</TT > já que o arquivo zip não expande como no PHP 4. Você pode escolher uma localização diferente, desde que não tenha espaços no caminho (como <TT CLASS="filename" >C:\Program Files\PHP</TT >) já que alguns servidores web irão travar se tiver. </P ><P > A estrutura de diretório extraida do zip é diferente para as versões 4 e 5 e se parecem com as seguintes: </P ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN1132" ></A ><P ><B >Exemplo 6-1. Estrutura de diretório para o PHP 4</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="programlisting" >c:\php | +--cli | | | |-php.exe -- executável CLI - Só para uso na linha de comando. | +--dlls -- DLLs de suporte, necessárias para algumas extensões | | | |-expat.dll | | | |-fdftk.dll | | | |-... | +--extensions -- DLLs de extensões para o PHP | | | |-php_bz2.dll | | | |-php_cpdf.dll | | | |-.. | +--mibs -- arquivos de suporte para SNMP | +--openssl -- arquivos de suporte para Openssl | +--pdf-related -- arquivos de suporte para PDF | +--sapi -- DLLs de SAPI (suporte a módulo de servidor) | | | |-php4apache.dll | | | |-php4apache2.dll | | | |-.. | +--PEAR -- cópia inicial do PEAR | | |-go-pear.bat -- script de configuração do PEAR | |-.. | |-php.exe -- executável CGI | |-.. | |-php.ini-dist -- configurações padrão do php.ini | |-php.ini-recommended -- configurações recomendadas do php.ini | |-php4ts.dll -- DLL núcleo do PHP | |-...</PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ><P > Ou: </P ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN1136" ></A ><P ><B >Exemplo 6-2. Estrutura de diretório para o PHP 5</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="programlisting" >c:\php | +--dev | | | |-php5ts.lib | +--ext -- DLLs de extensões para o PHP | | | |-php_bz2.dll | | | |-php_cpdf.dll | | | |-.. | +--extras | | | +--mibs -- arquivos de suporte para SNMP | | | +--openssl -- arquivos de suporte para Openssl | | | +--pdf-related -- arquivos de suporte para PDF | | | |-mime.magic | +--pear -- cópia inicial do PEAR | | |-go-pear.bat -- script de configuração do PEAR | |-fdftk.dll | |-.. | |-php-cgi.exe -- executável CGI | |-php-win.exe -- executa scripts sem um prompt de comando aberto | |-php.exe -- CLI executável - Só para uso em linha de comando | |-.. | |-php.ini-dist -- configurações padrão do php.ini | |-php.ini-recommended -- configurações recomendadas do php.ini | |-php5activescript.dll | |-php5apache.dll | |-php5apache2.dll | |-.. | |-php5ts.dll -- DLL núcleo do PHP | |-...</PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ><P > Note as diferenças e similaridades. Tanto o PHP 4 quanto o 5 tem um executável <ACRONYM CLASS="acronym" >CGI</ACRONYM >, um executável <ACRONYM CLASS="acronym" >CLI</ACRONYM >, e módulos do servidor, mas eles estão localizados em pastas diferentes e/ou tem nomes diferentes. Enquanto no PHP 4 os módulos do servidor estão na pasta <TT CLASS="filename" >sapi</TT >, no PHP 5 não há tal diretório e, ao invés disso, eles estão na pasta principal do PHP. As DLLs de suporte para as extensões do PHP 5 também não estão em um diretório separado. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > No PHP 4, você deve mover todos os arquivos localizados nas pastas <TT CLASS="filename" >dll</TT > e <TT CLASS="filename" >sapi</TT > para a pasta principal (ex.: <TT CLASS="filename" >C:\php</TT >). </P ></BLOCKQUOTE ></DIV ><P > Aqui está uma lista dos módulos de servidor liberados com o PHP 4 e PHP 5: <P ></P ><UL ><LI ><P > <TT CLASS="filename" >sapi/php4activescript.dll (php5activescript.dll)</TT > - <A HREF="install.windows.activescript.html" >ActiveScript engine</A >, permitindo imbutir PHP em aplicações Windows. </P ></LI ><LI ><P > <TT CLASS="filename" >sapi/php4apache.dll (php5apache.dll)</TT > - Módulo do Apache 1.3.x. </P ></LI ><LI ><P > <TT CLASS="filename" >sapi/php4apache2.dll (php5apache2.dll)</TT > - Módulo do Apache 2.0.x. </P ></LI ><LI ><P > <TT CLASS="filename" >sapi/php5apache2_2.dll</TT > - Módulo do Apache 2.2.x. </P ></LI ><LI ><P > <TT CLASS="filename" >sapi/php4isapi.dll (php5isapi.dll)</TT > - Módulo do ISAPI para servidores que suportam ISAPI como IIS 4.0/PWS 4.0 ou superior. </P ></LI ><LI ><P > <TT CLASS="filename" >sapi/php4nsapi.dll (php5nsapi.dll)</TT > - Módulo dos servidores Sun/iPlanet/Netscape. </P ></LI ><LI ><P > <TT CLASS="filename" >sapi/php4pi3web.dll (não tem equivalente no PHP 5)</TT > - Módulo do servidor Pi3Web. </P ></LI ></UL > </P ><P > Módulos de servidor tem performance significativamente melhor e funcionalidades adiconais comparados com o binário CGI. A versão CLI é desenhada para permitir usar o PHP para scripts de linha de comando. Mais informação sobre CLI disponível no capítulo sobre <A HREF="features.commandline.html" >usando PHP da linha de comando</A >. </P ><DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Atenção</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > Os módulos SAPI foram melhorados significativamente a partir do release 4.1, no entanto, em sistemas mais antigos, você pode encontrar erros de servidor e outros módulos do servidor podem falhar, como ASP. </P ></TD ></TR ></TABLE ></DIV ><P > Os binários CGI e CLI, e os módulos de servidor web todos necessitam do arquivo <TT CLASS="filename" >php4ts.dll</TT > (<TT CLASS="filename" >php5ts.dll</TT >) para funcionar corretamente. Você tem que assegurar que esse arquivo pode se encontrado pela sua instalação do PHP. A ordem de busca para essa DLL é como segue: <P ></P ><UL ><LI ><P > O mesmo diretório onde o arquivo <TT CLASS="filename" >php.exe</TT > é chamado, ou no caso de usar um módulo SAPI, o diretório do servidor web (ex.: <TT CLASS="filename" >C:\Program Files\Apache Group\Apache2\bin</TT >). </P ></LI ><LI ><P > Qualquer diretório no na sua variável de ambiente <CODE CLASS="varname" >PATH</CODE > do Windows. </P ></LI ></UL > </P ><P > Para disponibilizar <TT CLASS="filename" >php4ts.dll</TT > / <TT CLASS="filename" >php5ts.dll</TT > você tem três opções: copiar o arquivo para o diretório system do Windows, copiar o arquivo para o diretório do servidor web, ou adicionar o diretório do PHP, <TT CLASS="filename" >C:\php</TT > no <CODE CLASS="varname" >PATH</CODE >. Para melhor manutenção, nós aconselhamos que você siga a última opção, adicione <TT CLASS="filename" >C:\php</TT > ao <CODE CLASS="varname" >PATH</CODE >, porque é mais simples atualizar o PHP no futuro. Leia mais sobre como adicionar o diretório ao <CODE CLASS="varname" >PATH</CODE > no <A HREF="faq.installation.html#faq.installation.addtopath" >FAQ correspondente</A > (e então, não esqueça de reiniciar o computador - fazer o logoff não é suficiente). </P ><P > O próximo passo é montar um arquivo de configuração para o PHP, <TT CLASS="filename" >php.ini</TT >. Existem dois arquivos ini distribuídos no arquivo zip, <TT CLASS="filename" >php.ini-dist</TT > e <TT CLASS="filename" >php.ini-recommended</TT >. Nós aconselhamos que você use <TT CLASS="filename" >php.ini-recommended</TT >, porque nós otimizamos as configurações padrões nesse arquivo para performance e segurança. Leia esse arquivo bem documentador cuidadosamente porque ele tem diferenças em relação a <TT CLASS="filename" >php.ini-dist</TT > que afetarão drasticamente sua configuração. Alguns exemplos são <A HREF="ref.errorfunc.html#ini.display-errors" > display_errors</A > está <TT CLASS="literal" >off</TT > e <A HREF="ref.info.html#ini.magic-quotes-gpc" >magic_quotes_gpc</A > está <TT CLASS="literal" >off</TT >. Além de ler isso, estude as <A HREF="configuration.html#configuration.file" >configurações ini</A > e configure cada elemento manualmente. Se você quiser alcança o máximo de segurança, então essa é a maneira que você deve fazer, embora o PHP funcione bem com os arquivos padrões. Copie o seu arquivo ini preferido para um diretódio que o PHP possa encontrar e renomei para <TT CLASS="filename" >php.ini</TT >. PHP procura pelo arquivo <TT CLASS="filename" >php.ini</TT > nas localidades descritas nessa <A HREF="configuration.html#configuration.file" >a seção <I >O arquivo de configuração</I > Capítulo 9</A > seção. </P ><P > Se você estiver executando o Apache 2, a opção mais simples é usar a diretiva PHPIniDir (leia a página <A HREF="install.windows.apache2.html" >instalação no Apache 2</A >). Caso contrário, sua melhor opção é criar a variável de ambiente <CODE CLASS="varname" >PHPRC</CODE >. Esse processo é explicado no seguinte <A HREF="faq.installation.html#faq.installation.phprc" >FAQ</A >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Se você estiver usando NTFS no Windows NT, 2000, XP ou 2003, assegure-se que o usuário executando o servidor web tem permissões de leitura ao seu arquivo <TT CLASS="filename" >php.ini</TT > (ex.: faça com que seja lido por Everyone (Todos) ). </P ></BLOCKQUOTE ></DIV ><P > Os passos a seguir são opcionais: <P ></P ><UL ><LI ><P > Edite seu no arquivo <TT CLASS="filename" >php.ini</TT >. Se você planeja usar <A HREF="install.windows.omnihttpd.html" >OmniHTTPd</A >, não faça o passo a seguir. Edite o <A HREF="ini.core.html#ini.doc-root" >doc_root</A > para apontar para o document_root do servidor web. Por exemplo: <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN1224" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="ini" >doc_root = c:\inetpub\wwwroot // para IIS/PWS doc_root = c:\apache\htdocs // para Apache</PRE ></TD ></TR ></TABLE ><P ></P ></DIV > </P ></LI ><LI ><P > Selecione as extensões que você quer que sejam carregadas quando o PHP iniciar. Veja a seção sobre <A HREF="install.windows.extensions.html" >extensões no Windows</A >, sobre como configurar uma, e quais já estão integradas. Note que em uma instalação nova, é aconselhável primeiro fazer o PHP funcionar e testá-lo sem extensões e depois habilitá-las no arquivo <TT CLASS="filename" >php.ini</TT >. </P ></LI ><LI ><P > No PWS e IIS, você pode editar a configuração <A HREF="ref.misc.html#ini.browscap" >browscap</A > para que ela aponte para: <TT CLASS="filename" >c:\windows\system\inetsrv\browscap.ini</TT > no Windows 9x/Me, <TT CLASS="filename" >c:\winnt\system32\inetsrv\browscap.ini</TT > no NT/2000, e <TT CLASS="filename" >c:\windows\system32\inetsrv\browscap.ini</TT > no XP. Para um arquivo <TT CLASS="filename" >browscap.ini</TT > atualizado, leia o seguinte <A HREF="faq.obtaining.html#faq.obtaining.browscap" >FAQ</A >. </P ></LI ></UL > </P ><P > O PHP agora está configurado no seu sistema. O próximo passo é escolher um servidor web, e habilitá-lo para executar o PHP. Escolha um servidor web da tabela de conteúdos. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="install.windows.installer.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="install.windows.activescript.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Instalador do PHP para o Windows (PHP 5.1.0 e anterior)</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="install.windows.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >ActiveScript</TD ></TR ></TABLE ></DIV ></BODY ></HTML >