Manual do PHP
Anterior | Capítulo 4. Instalação em sistemas Unix | Próxima

# Notas de Instalação para usuários do Gentoo Linux

Essa seção contêm notas e dicas específicas para a instalação do PHP no Gentoo Linux.

## Usando o Portage (emerge)

Apesar de você poder apenas baixar os fontes do PHP e compilar por conta própria, usar o sistema de pacotes do Gentoo é o método mais simples e mais limpo de instalar o PHP. Se você não está familiarizado com o processo de compilar software no Linux, usar o Portage é a maneira recomendada.

Se você tiver montado seus sistema Gentoo até agora, você provavelmente já está habituado a usar o Portage. Instalar o Apache e o PHP não é diferente das outras ferramentas de sistema.

A primeira decisão que você precisará fazer é se você quer instalar o Apache 1.3.x ou o Apache 2.x. Enquanto ambos podem ser usado com o PHP, os passos abaixo serão para o uso do Apache 1.3.x. Outra coisa a ser considerada é se a sua árvore local do Portage está atualizada. Se você não atualizou-a recentemente, você precisa executar o comando emerge sync antes de mais nada. Dessa forma, você estará usando as versões estáveis mais recentes, tanto do Apache quanto do PHP.

Agora que tudo está no seu lugar, você pode usar o exemplo a seguir para instalar o Apache e o PHP:

Exemplo 4-7. Exemplo de Instalação com o Apache 1.3 no Gentoo
    # emerge \<apache-2
    # USE="-*" emerge php mod_php
    # ebuild /var/db/pkg/dev-php/mod_php-<your PHP version>/mod_php-<your PHP version>.ebuild config
    # nano /etc/conf.d/apache
      Add "-D PHP4" to APACHE_OPTS

    # rc-update add apache default
    # /etc/init.d/apache start

Você pode ler mais sobre o emerge no Manual do Portage que é excelente e está disponível no website do Gentoo.

Se você precisa usar o Apache 2, você pode simplesmente usar emerge apache no último exemplo.

## Controle apurado na configuração

Na seção anterior, o PHP foi emerged sem nenhum módulo. Até essa edição, o único módulo ativado por padrão com o Portage é o XML que é necessário para usar o PEAR. Isso pode não ser o que você quer e você perceberá que precisa de outros módulos, como MySQL, gettext, GD, etc.

Quando você compila o PHP a partir dos fontes, você precisa ativar os módulos pelo comando configure. Com o Gentoo, você pode simplesmente prover essas opções na variável de ambiente USE que será passada para o script configure automaticamente. Para ver quais opções usar em USE com o emerge, você pode tentar:

Exemplo 4-8. Vendo a lista de opções validas para a variável USE
    # USE="-*" emerge -pv php

    [ebuild  N    ] dev-php/php-4.3.6-r1  -X -berkdb -crypt -curl -debug -doc
    -fdftk -firebird -flash -freetds -gd -gd-external -gdbm -gmp -hardenedphp
    -imap -informix -ipv6 -java -jpeg -kerberos -ldap -mcal -memlimit -mssql
    -mysql -ncurses -nls -oci8 -odbc -pam -pdflib -png -postgres -qt -readline
    -snmp -spell -ssl -tiff -truetype -xml2 -yaz  3,876 kB

Como você pode ver do exemplo acima, o PHP considera várias opções para a variável USE. Preste bastante atenção nelas e escolha quais você precisa. Se você escolher uma opção e você não tiver as bibliotecas corretas, o Portage irá compilar elas para você. É uma boa idéia usar o comando emerge -pv novamente para ver o que o Portage irá compila de acordo com as opçõe que você colocar na variável USE. Como um exemplo, se você não tiver X instalado e escolher incluir X nas opções de USE, o Portage irá compilar X antes do PHP, o que pode levar algumas horas.

Se você escolher compilar o PHP com suporte à MySQL, cURL e GD, o comando se parecerá com algo assim:

Exemplo 4-9. Instalando o PHP usando opções na variável USE
    # USE="-* curl mysql gd" emerge php mod_php

Como no exemplo anterior, não esqueca de incluir mod_php no comando. php é responsável para a versão de linha de comando do PHP e mod_php é para a versão de módulo do Apache do mesmo.

## Problemas Comuns

- Se você ver o fonte do PHP ao invés do resultado que o script deveria produzir, você provavelmente esqueceu de editar o arquivo `/etc/conf.d/apache`. O Apache precisa ser iniciado com a opção -D PHP4. Para ver se a opção está presente, você deve ser capaz de verificar usando o comando ps ax | grep apache enquanto o Apache estiver rodando.

- Outro problema que pode ocorrer é de você acabar com mais de uma versão do PHP instalado no seu sistema. Nesse caso, você deve unmerge as versões mais velhas manualmente usando emerge unmerge mod_php-<versão velha>.

- Se você não pode fazer o emerge do PHP por causa de Java, tente colocar -* como primeira opção na variável USE, como nos exemplos acima.

- Se você estiver tendo problemas de configurando o Apache e o PHP, você sempre pode procurar os Fóruns do Gentoo. Tente procurar pelas palavras-chave "Apache PHP".

Anterior | Principal | Próxima
Dicas de instalação específicas para o Solaris | Acima | Instalação no Mac OS X