Instalando a partir de pacotes no Debian GNU/Linux e distribuições relacionadas

O PHP pode ser instalado a partir do código-fonte, mas também está disponível através de pacotes do » Debian GNU/Linux. Isto também vale para outras distribuições baseadas em Debian, como Ubuntu, Kali Linux, e Linux Mint.

Aviso

Compilações de terceiros são consideradas não oficiais e não são suportadas diretamente pelo projeto PHP. Quaisquer problemas encontrados devem ser relatados ao fornecedor dessas compilações não oficiais, a menos que possam ser reproduzidos usando as compilações da » área de download oficial.

Os pacotes podem ser instalados usando os comandos apt ou aptitude. Essa página do manual utilizará esses dois comandos intercambiavelmente.

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 módulos principais. É bem provável que módulos adicionais sejam 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

A lista de pacotes mostrará uma grande quantidade de pacotes incluindo componentes básicos do PHP, como php-cgi, php-cli e php-dev, assim como muitas extensões do PHP. Quando extensões estão instaladas, pacotes adicionais serão instalados automaticamente conforme necessário para satisfazer as dependências desses pacotes.

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.