<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Instalação em sistemas Unix</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 e Configuração"
HREF="install.html"><LINK
REL="PREVIOUS"
TITLE="Considerações Gerais sobre Instalação"
HREF="install.general.html"><LINK
REL="NEXT"
TITLE="Apache 2.0 em sistemas Unix"
HREF="install.unix.apache2.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="chapter"
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.general.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="install.unix.apache2.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="install.unix"
>Capítulo 4. Instalação em sistemas Unix</A
></H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Índice</B
></DT
><DT
><A
HREF="install.unix.html#install.unix.apache"
>Apache 1.3.x em sistemas Unix</A
></DT
><DT
><A
HREF="install.unix.apache2.html"
>Apache 2.0 em sistemas Unix</A
></DT
><DT
><A
HREF="install.unix.caudium.html"
>Caudium</A
></DT
><DT
><A
HREF="install.unix.fhttpd.html"
>Notas relacionadas à fhttpd</A
></DT
><DT
><A
HREF="install.unix.sun.html"
>Sun, iPlanet e servidores Netscape no Solaris da Sun</A
></DT
><DT
><A
HREF="install.unix.commandline.html"
>CGI e instalações de linha de comando</A
></DT
><DT
><A
HREF="install.unix.hpux.html"
>Notas expecificas da instalação em HP-UX</A
></DT
><DT
><A
HREF="install.unix.openbsd.html"
>Notas de instalação para o OpenBSD</A
></DT
><DT
><A
HREF="install.unix.solaris.html"
>Dicas de instalação específicas para o Solaris</A
></DT
><DT
><A
HREF="install.unix.debian.html"
>Notas de Instalação para o Debian GNU/Linux</A
></DT
></DL
></DIV
><P
> Essa seção é um guia geral para configuração e
instalação do PHP em sistemas Unix. Verifique se existe uma
seção específica para usa plataforma ou servidor web antes de
começar o processo.
</P
><P
> Como nosso manual destaca na seção <A
HREF="install.general.html"
>Considerações
Gerais sobre Instalação</A
>, nós estamos lidando principalmente com
configurações web do PHP nessa seção, embora cobriremos
instalação do PHP para uso em linha de comando também.
</P
><P
> Existem várias maneiras de instalar o PHP para a plataforma Unix, ou
com um processo de compilar e configurar, ou atráves de vários
métodos pré-empacotados. Essa documentação é focada principalmente no
processo de compilação e configuração do PHP. Muitos sistemas baseados no Unix
tem alguma forma de sistema de instalação de pacotes. Isso pode ajudar na
instalação de uma configuração padrão, mas se você precisar ter uma
série de características diferentes (como um servidor seguro, ou um driver
de banco de dados diferente), você pode precisar montar o PHP e/ou servidor web.
Se você não estiver familiarizado com o processo de montar e compilar seu próprio software,
vale a pena checar se alguém já montou um pacote
do PHP com as características que você precisa.
</P
><P
> Pre-requisitos de software e de conhecimento para compilar:
<P
></P
><UL
><LI
><P
> Conhecimento básico de Unix (ser capaz de operar o "make" e um
compilador C)
</P
></LI
><LI
><P
> Um compilador ANSI C
</P
></LI
><LI
><P
> flex: Versão 2.5.4
</P
></LI
><LI
><P
> bison: Versão 1.28 (preferida), 1.35, ou 1.75
</P
></LI
><LI
><P
> Um servidor web
</P
></LI
><LI
><P
> Qualquer componentes específicos para os módulos (como gd, bibliotecas pdf, etc.)
</P
></LI
></UL
>
</P
><P
> O processo inicial de configuração de instalação do PHP é controlado pelo
uso de opções de linha de comando do script <B
CLASS="command"
>configure</B
>.
Você pode pegar a lista de todas as opções disponíveis junto com uma pequena
explicação executando o comando <B
CLASS="command"
>./configure --help</B
>.
Nosso manual documenta as diferentes opções separadamente. Você encontrará
as <A
HREF="configure.html"
>opções principais no apêndice</A
>,
enquanto as opções específicas das diferentes extensões são descritas nas
páginas de referência.
</P
><P
> Quando o PHP é configurado, você está pronto para montá-lo como módulo e/ou
executável. O comando <B
CLASS="command"
>make</B
> deve
tomar conta disso. Se ele falhar e você não conseguir descobrir a razão, veja a
<A
HREF="install.problems.html"
>Seção de Problemas</A
>.
</P
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="install.unix.apache"
>Apache 1.3.x em sistemas Unix</A
></H1
><P
> Essa seção contem notas e dicas específicas para a instação do Apache
e do PHP em plataformas Unix. Também temos <A
HREF="install.unix.apache2.html"
>instruções e notas para o Apache 2
em uma página separada</A
>.
</P
><P
> Você pode selecionar argumentos para adicionar ao
<B
CLASS="command"
>configure</B
> na linha 10 abaixo através da <A
HREF="missing-stuff.html#install.configure"
>Lista completa de opções do configure
</A
> e das opções específicas das extensões em seus respectivos
lugares no manual. Os números de versões foram omitidos aqui, para assegurar
que as instruções não estejam incorretas. Você deverá trocar o
'xxx' aqui com os valores corretos dos seus arquivos.
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="install.unix.apache.example"
></A
><P
><B
>Exemplo 4-1.
Instruções de Instalação (Apache Versão de Módulo Compartilhado) para PHP
</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>1. gunzip apache_xxx.tar.gz
2. tar -xvf apache_xxx.tar
3. gunzip php-xxx.tar.gz
4. tar -xvf php-xxx.tar
5. cd apache_xxx
6. ./configure --prefix=/www --enable-module=so
7. make
8. make install
9. cd ../php-xxx
10. Agora, configure o seu PHP. É aqui que você personaliza seu PHP
com várias opções, como quais extensões serão habilitadas. Execute o
comando ./configure --help para uma lista das opções disponíveis. No nosso exemplo
nós faremos uma simples configuração com Apache 1 e suporte ao MySQL. Seu caminho
para o arquivo apxs pode ser diferente do exemplo.
./configure --with-mysql --with-apxs=/www/bin/apxs
11. make
12. make install
Se você decidir mudar as opções de seu configure depois da instalação
você precisará somente repetir os últimos 3 passos. Você somente precisará
reiniciar o Apache para o novo módulo funcionar. Não será necessário recompilar
o Apache.
Note que, por padrão, 'make install' também instalará PEAR, além
de várias ferramentas do PHP como phpize, instalar o CLI do PHP e mais.
13. Configurando seu arquivo php.ini:
cp php.ini-dist /usr/local/lib/php.ini
Você pode editar o seu arquivo .ini para configurar as opções do PHP. Se
você preferir que este arquivo fique em outro lugar, use a opção
--with-config-file-path=/caminho no passo 10.
Se ao invés de escolher o arquivo php.ini-dist, você escolher o arquivo php.ini-recommended,
leia a lista de mudanças dentro do mesmo, uma vez que elas afetam a maneira como o PHP se comporta.
14. Edite o seu arquivo httpd.conf para carregar o módulo do PHP. O caminho no lado direito
do comando LoadModule deve apontar para para o caminho do módulo PHP no seu sistema.
O comando make install acima já deve ter adicionado estas linhas, mas tenha certeza
de que as linhas abaixo foram adicionadas ao arquivo.
Para o PHP 4:
LoadModule php4_module libexec/libphp4.so
Para o PHP 5:
LoadModule php5_module libexec/libphp5.so
15. Em seguida, na seção AddModule do arquivo httpd.conf, em algum lugar
abaixo de ClearModuleList, adicione isto:
Para o PHP 4:
AddModule mod_php4.c
Para o PHP 5:
AddModule mod_php5.c
16. Diga ao Apache para avaliar certas extensões como PHP. Por exemplo,
vamos fazer o Apache interpretar a extensão .php como um script PHP. Você poderia
ter qualquer extensão(ões) avaliadas como PHP simplesmente adicionando-as, com
cada uma separada por um espaço. Vamos adicionar .phtml para demonstrar.
AddType application/x-httpd-php .php .phtml
Também é comum configurar a extensão .phps para mostrar o código-fonte
do script PHP com highlight, isso pode ser feito com:
AddType application/x-httpd-php-source .phps
17. Use seu procedimento normal para iniciar o servidor Apache. (Você deve
parar e reiniciar o servidor, não somente fazer um reinício enviando
um sinal HUP ou USR1.)</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> Outra maneira é instalar o PHP como um objeto estático:
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="install.unix.apache.example-static"
></A
><P
><B
>Exemplo 4-2.
Instruções de Instalação (Instalação como módulo estático do Apache) para o PHP
</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>1. gunzip -c apache_1.3.x.tar.gz | tar xf -
2. cd apache_1.3.x
3. ./configure
4. cd ..
5. gunzip -c php-5.x.y.tar.gz | tar xf -
6. cd php-5.x.y
7. ./configure --with-mysql --with-apache=../apache_1.3.x
8. make
9. make install
10. cd ../apache_1.3.x
11. ./configure --prefix=/www --activate-module=src/modules/php5/libphp5.a
(A linha acima está correta! Sim, sabemos que libphp4.a não existe nesse
estágio. E nem deveria. Ele será criado.)
12. make
(você deve agora ter um binário httpd que você pode copiar para o diretório bin do Apache. Se
for sua primeira instalação então você precisa executar "make install" também)
13. cd ../php-5.x.y
14. cp php.ini-dist /usr/local/lib/php.ini
15. Você pode editar o arquivo /usr/local/lib/php.ini para editar as opçso do PHP.
Edite o seu arquivo httpd.conf ou srm.conf e adicione:
AddType application/x-httpd-php .php</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Substitua <TT
CLASS="literal"
>php-5</TT
> por <TT
CLASS="literal"
>php-4</TT
> e
<TT
CLASS="literal"
>php5</TT
> por <TT
CLASS="literal"
>php4</TT
> no PHP 4.
</P
></BLOCKQUOTE
></DIV
><P
> Dependendo da sua instalação do Apache e das variações Unix, existem inúmeras
maneiras possíveis de parar e reiniciar o servidor. Abaixo estão algumas linhas típicas
usadas para reiniciar e o servidor, para instalações de versões de apache/unix.
Você deve trocar <TT
CLASS="literal"
>/caminho/para/</TT
> pelo
caminho destas aplicações nos seus sistemas.
</P
><P
> <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN421"
></A
><P
><B
>Exemplo 4-3. Exemplo de comandos para reinicialização do Servidor Apache</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="shell"
>1. Várias distribuições Linux e variantes do SysV:
/etc/rc.d/init.d/httpd restart
2. Usando os scripts apachectl:
/path/to/apachectl stop
/path/to/apachectl start
3. httpdctl and httpsdctl (Usando OpenSSL), igual ao apachectl:
/path/to/httpsdctl stop
/path/to/httpsdctl start
4. Usando mod_ssl, ou outro servidor SSL, você pode querer iniciar
ou reiniciar manualmente:
/path/to/apachectl stop
/path/to/apachectl startssl</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> As localizações dos binários apachectl e http(s)dctl geralmente
variam. Se o seu sistema tem os comandos <TT
CLASS="literal"
>locate</TT
> ou
<TT
CLASS="literal"
>whereis</TT
> ou <TT
CLASS="literal"
>which</TT
>,
estem podem lhe ajudar a encontrar os programas de controle do servidor.
</P
><P
> Exemplos diferentes de compilação do PHP para apache estão a seguir:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN429"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="shell"
>./configure --with-apxs --with-pgsql</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> Isso criará uma biblioteca compartilhada <TT
CLASS="filename"
>libphp5.so</TT
> (ou
<TT
CLASS="filename"
>libphp4.so</TT
> no PHP 4) que é carregada pelo
Apache ao adicionar uma linha LoadModule no arquivo <TT
CLASS="filename"
>httpd.conf</TT
> do Apache. O
suporte ao PostgreSQL é embutido nessa biblioteca.
</P
><P
> <DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN436"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="shell"
>./configure --with-apxs --with-pgsql=shared</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> Isto irá criar uma biblioteca compartilhada <TT
CLASS="filename"
>libphp4.so</TT
>
para o Apache, mas isto também criará uma biblioteca compartilhada
<TT
CLASS="filename"
>pgsql.so</TT
> que é carregada com o PHP
tanto ao usar a diretiva de extensão no arquivo
<TT
CLASS="filename"
>php.ini</TT
> ou então carregando ela explícitamente no script
usando a função <A
HREF="function.dl.html"
><B
CLASS="function"
>dl()</B
></A
>.
</P
><P
> <DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN444"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="shell"
>./configure --with-apache=/path/to/apache_source --with-pgsql</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> Isto irá criar uma biblioteca <TT
CLASS="filename"
>libmodphp5.a</TT
>, o arquivo
<TT
CLASS="filename"
>mod_php5.c</TT
> e vários arquivos dependentes e copiará
eles para o diretório <TT
CLASS="literal"
>src/modules/php5</TT
> na árvore de diretório
do código fonte do Apache. Então você compilará o Apache usando a opção
<TT
CLASS="literal"
>--activate-module=src/modules/php5/libphp5.a</TT
>
e o sistema de compilação do Apache irá criar o arquivo
<TT
CLASS="filename"
>libphp5.a</TT
> e fará um link estático dentro do binário
<TT
CLASS="filename"
>httpd</TT
> (substitua <TT
CLASS="literal"
>php5</TT
> por
<TT
CLASS="literal"
>php4</TT
> no PHP 4). O suporte ao PostgreSQL estará incluído
diretamente neste binário <TT
CLASS="filename"
>httpd</TT
>,
então o resultado final aqui será um único arquivo binário <TT
CLASS="filename"
>httpd</TT
>
que incluirá tudo do Apache e tudo do PHP.
</P
><P
> <DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN458"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="shell"
>./configure --with-apache=/path/to/apache_source --with-pgsql=shared</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> Mesmo que o anterior, exceto em vez de incluir o suporte ao PostgreSQL
diretamente no binário <TT
CLASS="filename"
>httpd</TT
> você terá
uma biblioteca compartilhada <TT
CLASS="filename"
>pgsql.so</TT
> que você poderá carregar
com o PHP tanto do arquivo <TT
CLASS="filename"
>php.ini</TT
> ou
diretamente usando a função <A
HREF="function.dl.html"
><B
CLASS="function"
>dl()</B
></A
>.
</P
><P
> Quanto estiver decidindo compilar o PHP com maneiras diferentes, você deverá considerar
as vantages e disvantagens de cada método. Complilando como uma biblioteca compartilhada
significará que você poderá compilar o apache separadamente, e não
terá que recompilar tudo quando quiser adicionar ou mudar o seu PHP.
compilando o PHP dentro do apache (método estático) significará que o PHP irá carregar e
rodar rapidamente. Para maiores informações, veja a página web do Apache que fala sobre
<A
HREF="http://httpd.apache.org/docs/1.3/dso.html"
TARGET="_top"
>Suporte a Objetos Dinâmicos Compartilhados</A
>.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
O arquivo <TT
CLASS="filename"
>httpd.conf</TT
> padrão do Apache atualmente já contém uma seção que se parece
com isso:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN470"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="apache-conf"
>User nobody
Group "#-1"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
>
A menos que você mude isto para "Group nogroup" ou algo assim ("Group daemon" é
também muito comum) o PHP não estará apto a abrir arquivos.
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Tenha certeza de especificar a versão instalada do apxs quando usar a opção
<CODE
CLASS="option"
>--with-apxs=/caminho/para/apxs</CODE
>.
Você NÂO deverá usar a versão do apxs que está nos fontes do apache e sim a
que está atualmente instalada no seu sistema.
</P
></BLOCKQUOTE
></DIV
></DIV
></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.general.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.unix.apache2.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Considerações Gerais sobre Instalação</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="install.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Apache 2.0 em sistemas Unix</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
