Notas de Instalação para o Debian GNU/Linux

    Essa seção contém notas e dicas específicas para a instalação do PHP no » Debian GNU/Linux.

    Aviso

    Compilações não oficiais de terceiros não são suportadas. Quaisquer bugs devem ser notificados para o Debian a não ser que possam ser reproduzidos utilizando as últimas compilações disponíveis na » área de download.

    As instruções de compilação do PHP no Unix se aplicam ao Debian, de forma que essa página contém informações específicas opções outras, como utilizar os comandos apt ou aptitude. Essa página utilizará esses dois comandos como opções alternativas.

    Usando APT

    Primeiro veja que outros pacotes relacionados podem ser desejados, como libapache-mod-php para integração com o Apache 2 e php-pear para o PEAR.

    Segundo, antes de instalar um pacote é melhor garantir que a lista de pacotes está atualizada. Isso é feito rodando o comando apt update.

    Exemplo #1 Exemplo de instalação no Debian com Apache 2

    # apt install php-common libapache2-mod-php php-cli

    APT instalará automaticamente o módulo do PHP para Apache 2 e todas as suas dependências, depois ativando-o. O Apache deve ser inicializado para que as modificações tenham efeito. Por exemplo:

    Exemplo #2 Parando e iniciando o Apache depois do PHP instalado

    # /etc/init.d/apache2 stop # /etc/init.d/apache2 start

    Controle melhor as configurações

    Até então o PHP foi instalado apenas com os meus módulos principais. É bem provável que módulos adicionais serão desejados, como MySQL, cURL, GD, etc. Estes também podem ser instalados pelo comando apt.

    Exemplo #3 Métodos listar pacotes adicionais do PHP

    # apt-cache search php # apt search php | grep -i mysql # aptitude search php

    Os exemplos mostrarão uma grande quantidade de pacotes incluindo vários específicos do PHP, como php-cgi, php-cli e php-dev. Determine quais serão necessários e instale como quaisquer outros via os comandos apt ou aptitude. Como o Debian verifica as dependências, ele perguntará sobre elas. Por exemplo, para instalar MySQL e cURL:

    Exemplo #4 Instalando PHP com MySQL e cURL

    # apt install php-mysql php-curl

    O APT irá automaticamente adicionar as linhas apropriadas a arquivos php.ini relacionados, como /etc/php/7.4/php.ini, /etc/php/7.4/conf.d/*.ini, etc., e dependendo da da extensão irá ainda acrescentar diretivas similares a extension=foo.so. Entretanto é necessário reiniciar o servidor web para que essas alterações tenham efeito.

    Problemas comuns

    • Se os scripts PHP não estão sendo interpretados pelo servidor web, então é provável que o PHP não tenha sido acrescentado aos arquivos de configuração do servidor web, que no Debian pode ser /etc/apache2/apache2.conf ou algo similar. Veja o manual do Debian para mais detalhes.
    • Se uma extensão parece ter sido instalada e ainda assim funções permanecem não definidas, verifique que o arquivo .ini apropriado está sendo carregado e/ou se o servidor web foi reiniciado após a instalação.
    • Há dois comandos básicos para instalar pacotes no Debian (e em outras variantes Linux): apt e aptitude. Entretanto explicar as sutis diferenças entre esses dois comandos vai além do escopo deste manual.
    To Top