PHP Installation · 12 min read · Nov 04, 2025

Como instalar PHP 7.1, 7.2 e 5.6 como PHP-FPM & FastCGI para ISPConfig 3 no Debian 9

O Debian 9 vem com PHP 7.0 como versão padrão do PHP. As principais versões do PHP não são 100% compatíveis entre si, então um site pode exigir uma versão do PHP mais nova ou mais antiga para funcionar. O ISPConfig suporta o uso de várias versões do PHP no mesmo servidor, a versão do PHP pode ser selecionada para cada site individualmente nas configurações do site. Este tutorial mostra como instalar PHP 7.1, 7.2 e 5.6 como FPM e FCGI ao lado do PHP 7.0 em um servidor Debian 9. As versões adicionais do PHP são instaladas na pasta /opt, portanto, sua instalação não afeta a versão padrão do PHP.

ATUALIZAÇÃO: É recomendado instalar versões adicionais do PHP no Debian e Ubuntu a partir de pacotes agora. O tutorial pode ser encontrado aqui: https://www.howtoforge.com/tutorial/how-to-install-php-7-for-ispconfig-3-from-debian-packages-on-debian-8-and-9/

1 Nota Preliminar

Vou instalar PHP 7.1, 7.2 e 5.6. Por favor, note que o PHP-FPM pode ser usado em servidores Apache e Nginx, enquanto o FastCGI está disponível apenas para servidores Apache.

2 Instalar os pré-requisitos

Instale os pré-requisitos para compilar o PHP e o editor nano que eu usarei para editar os arquivos de configuração:

apt-get install build-essential nano
apt-get install libfcgi-dev libfcgi0ldbl libjpeg62-turbo-dev libmcrypt-dev libssl-dev libc-client2007e libc-client2007e-dev libxml2-dev libbz2-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev libkrb5-dev libpq-dev libxml2-dev libxslt1-dev
ln -s /usr/lib/libc-client.a /usr/lib/x86_64-linux-gnu/libc-client.a
cd /usr/include  
ln -s x86_64-linux-gnu/curl

(O último comando é necessário se você compilar o PHP com –with-imap, porque caso contrário ./configure irá parar com o seguinte erro:

checking for crypt in -lcrypt... yes  
configure: error: Cannot find imap library (libc-client.a). Please check your c-client installation.  
root@server1:/usr/local/src/php5-build/php-7.1.14#

)

3 Compilar PHP 7.1 como PHP-FPM e Fastcgi

Baixe e extraia o arquivo do PHP:

mkdir -p /opt/php-7.1  
mkdir /usr/local/src/php7.1-build  
cd /usr/local/src/php7.1-build  
wget http://de2.php.net/get/php-7.1.14.tar.bz2/from/this/mirror -O php-7.1.14.tar.bz2  
tar jxf php-7.1.14.tar.bz2
cd php-7.1.14/

Configure e compile o PHP 7.1 da seguinte forma (você pode ajustar o comando ./configure conforme suas necessidades, dê uma olhada em

./configure --help

para ver todas as opções disponíveis; se você usar um comando ./configure diferente, é possível que bibliotecas adicionais sejam necessárias, ou o processo de compilação falhe):

./configure --prefix=/opt/php-7.1 --with-pdo-pgsql --with-zlib-dir --with-freetype-dir --enable-mbstring --with-libxml-dir=/usr --enable-soap --enable-calendar --with-curl --with-mcrypt --with-zlib --with-gd --with-pgsql --disable-rpath --enable-inline-optimization --with-bz2 --with-zlib --enable-sockets --enable-sysvsem --enable-sysvshm --enable-pcntl --enable-mbregex --enable-exif --enable-bcmath --with-mhash --enable-zip --with-pcre-regex --with-pdo-mysql --with-mysqli --with-mysql-sock=/var/run/mysqld/mysqld.sock --with-jpeg-dir=/usr --with-png-dir=/usr --enable-gd-native-ttf --with-openssl --with-fpm-user=www-data --with-fpm-group=www-data --with-libdir=/lib/x86_64-linux-gnu --enable-ftp --with-imap --with-imap-ssl --with-kerberos --with-gettext --with-xmlrpc --with-xsl --enable-opcache --enable-fpm

O último parâmetro ( –enable-fpm) garante que esta versão do PHP funcionará com o PHP-FPM.

make  
make install

Copie php.ini e php-fpm.conf para os locais corretos:

cp /usr/local/src/php7.1-build/php-7.1/php.ini-production /opt/php-7.1/lib/php.ini
cp /opt/php-7.1/etc/php-fpm.conf.default /opt/php-7.1/etc/php-fpm.conf  
cp /opt/php-7.1/etc/php-fpm.d/www.conf.default /opt/php-7.1/etc/php-fpm.d/www.conf

Abra /opt/php-7.1/etc/php-fpm.conf e ajuste a seguinte configuração (remova o ; na frente da linha pid):

nano /opt/php-7.1/etc/php-fpm.conf
[...]  
pid = run/php-fpm.pid  
[...]  

Em seguida, abra /opt/php-7.1/etc/php-fpm.d/www.conf e ajuste a linha listen, você deve usar uma porta não utilizada (por exemplo, 8999; a porta 9000 pode já estar em uso pelo PHP-FPM padrão do Debian):

nano /opt/php-7.1/etc/php-fpm.d/www.conf
[...]  
listen = 127.0.0.1:8999  
[...]  

3.1 Criar o arquivo de unidade systemd

Em seguida, criaremos o arquivo de unidade do sistema que é usado para iniciar e parar o daemon PHP-FPM.

nano /lib/systemd/system/php-7.1-fpm.service

com o seguinte conteúdo:

[Unit]  
Description=The PHP 7.1 FastCGI Process Manager  
After=network.target  
  
[Service]  
Type=simple  
PIDFile=/opt/php-7.1/var/run/php-fpm.pid  
ExecStart=/opt/php-7.1/sbin/php-fpm --nodaemonize --fpm-config /opt/php-7.1/etc/php-fpm.conf  
ExecReload=/bin/kill -USR2 $MAINPID  
  
[Install]  
WantedBy=multi-user.target

Ative o serviço e recarregue o systemd:

systemctl enable php-7.1-fpm.service  
systemctl daemon-reload

Finalmente, inicie o PHP-FPM.

systemctl start php-7.1-fpm.service

Para habilitar o Zend OPcache, abra /opt/php-7.1/lib/php.ini…

nano /opt/php-7.1/lib/php.ini

… e adicione a seguinte linha ao final:

[...]  
zend_extension=opcache.so

3.2 Habilitar Memcache (opcional)

Neste capítulo, vou compilar e habilitar a extensão PHP Memcached.

O primeiro passo é instalar o pacote libmemcached-dev do Debian.

apt-get install libmemcached-dev

Em seguida, crie um diretório, baixe a extensão PHP memcache do Github, descompacte o arquivo e entre no diretório que contém os arquivos descompactados.

mkdir /usr/local/src/php7.1-build/php-memcache  
cd /usr/local/src/php7.1-build/php-memcache  
wget https://github.com/php-memcached-dev/php-memcached/archive/php7.zip  
unzip php7.zip  
cd php-memcached-php7

Prepare os fontes executando o comando phpize do PHP 7.1.

/opt/php-7.1/bin/phpize

Configure e compile a extensão PHP memcache.

./configure --with-php-config=/opt/php-7.1/bin/php-config  
make  
make install

Para habilitar a extensão Memcache, abra /opt/php-7.1/lib/php.ini…

nano /opt/php-7.1/lib/php.ini

… e adicione a seguinte linha ao final:

[...]  
extension=memcached.so

3.3 Instalar a extensão xDebug (opcional)

O módulo xDebug é uma extensão de depuração para PHP. A instalação é opcional.

Instale o xDebug com estes comandos.

cd /opt/php-7.1/etc  
../bin/pecl -C ./pear.conf update-channels  
../bin/pecl -C ./pear.conf install xdebug

Em seguida, edite o arquivo php.ini com um editor:

nano /opt/php-7.1/lib/php.ini

e adicione a seguinte linha ao final do arquivo:

zend_extension=/opt/php-7.1/lib/php/extensions/no-debug-non-zts-20160303/xdebug.so

Finalmente, reinicie o daemon php-fpm:

systemctl start php-7.1-fpm.service

Teste a versão do PHP:

cd /opt/php-7.1/bin  
./php --version

A saída deve ser semelhante a esta captura de tela.

Por favor, note: A captura de tela é do PHP 7.1.14, o tutorial é atualizado continuamente para novas versões do PHP, mas não tiramos novas capturas de tela a cada vez, então a versão do PHP que você verá em seu servidor pode ser mais nova. A versão atual deste tutorial é para php-7.1.14.

3.4 Habilitar PHP 7.1 no ISPConfig

No ISPConfig 3.1, você pode configurar a nova versão do PHP em Sistema > Versões Adicionais do PHP. Na guia Nome, você apenas preenche um nome para a versão do PHP (por exemplo, PHP 7.1) - esta versão do PHP será listada sob este nome nas configurações do site no ISPConfig:

PHP 7.1

Vá para a guia Configurações do FastCGI e preencha os campos da seguinte forma:

Caminho para o binário PHP FastCGI: /opt/php-7.1/bin/php-cgi  
Caminho para o diretório php.ini: /opt/php-7.1/lib

PHP 7.1 FCGI

Em seguida, vá para a guia Configurações do PHP-FPM e preencha os campos da seguinte forma:

Caminho para o script init do PHP-FPM: php-7.1-fpm  
Caminho para o diretório php.ini: /opt/php-7.1/lib  
Caminho para o diretório do pool do PHP-FPM: /opt/php-7.1/etc/php-fpm.d  

PHP 7.1 FPM

4 Compilar PHP 7.2 como PHP-FPM e Fastcgi

Baixe e extraia o PHP do php.net e descompacte o arquivo tar.bz2:

mkdir -p /opt/php-7.2  
mkdir /usr/local/src/php7.2-build  
cd /usr/local/src/php7.2-build  
wget http://de2.php.net/get/php-7.2.2.tar.bz2/from/this/mirror -O php-7.2.2.tar.bz2  
tar jxf php-7.2.2.tar.bz2
cd php-7.2.2/

Configure e compile o PHP 7.2 da seguinte forma (você pode ajustar o comando ./configure conforme suas necessidades, dê uma olhada em

./configure --help

para ver todas as opções disponíveis; se você usar um comando ./configure diferente, é possível que bibliotecas adicionais sejam necessárias, ou o processo de compilação falhe):

./configure --prefix=/opt/php-7.2 --with-pdo-pgsql --with-zlib-dir --with-freetype-dir --enable-mbstring --with-libxml-dir=/usr --enable-soap --enable-calendar --with-curl --with-zlib --with-gd --with-pgsql --disable-rpath --enable-inline-optimization --with-bz2 --with-zlib --enable-sockets --enable-sysvsem --enable-sysvshm --enable-pcntl --enable-mbregex --enable-exif --enable-bcmath --with-mhash --enable-zip --with-pcre-regex --with-pdo-mysql --with-mysqli --with-mysql-sock=/var/run/mysqld/mysqld.sock --with-jpeg-dir=/usr --with-png-dir=/usr --with-openssl --with-fpm-user=www-data --with-fpm-group=www-data --with-libdir=/lib/x86_64-linux-gnu --enable-ftp --with-imap --with-imap-ssl --with-kerberos --with-gettext --with-xmlrpc --with-xsl --enable-opcache --enable-fpm

O último parâmetro ( –enable-fpm) garante que esta versão do PHP funcionará com o PHP-FPM.

make  
make install

Copie php.ini e php-fpm.conf para os locais corretos:

cp /usr/local/src/php7.2-build/php-7.2.2/php.ini-production /opt/php-7.2/lib/php.ini
cp /opt/php-7.2/etc/php-fpm.conf.default /opt/php-7.2/etc/php-fpm.conf  
cp /opt/php-7.2/etc/php-fpm.d/www.conf.default /opt/php-7.2/etc/php-fpm.d/www.conf

Abra /opt/php-7.2/etc/php-fpm.conf e ajuste a seguinte configuração (remova o ; na frente da linha pid):

nano /opt/php-7.2/etc/php-fpm.conf
[...]  
pid = run/php-fpm.pid  
[...]  

Em seguida, abra /opt/php-7.2/etc/php-fpm.d/www.conf e ajuste a linha listen, você deve usar uma porta não utilizada (por exemplo, 8998; a porta 9000 pode já estar em uso pelo PHP-FPM padrão do Debian):

nano /opt/php-7.2/etc/php-fpm.d/www.conf
[...]  
listen = 127.0.0.1:8998  
[...]  

4.1 Criar o arquivo de unidade systemd

Em seguida, criaremos o arquivo de unidade do sistema que é usado para iniciar e parar o daemon PHP-FPM.

nano /lib/systemd/system/php-7.2-fpm.service

com o seguinte conteúdo:

[Unit]  
Description=The PHP 7.2 FastCGI Process Manager  
After=network.target  
  
[Service]  
Type=simple  
PIDFile=/opt/php-7.2/var/run/php-fpm.pid  
ExecStart=/opt/php-7.2/sbin/php-fpm --nodaemonize --fpm-config /opt/php-7.2/etc/php-fpm.conf  
ExecReload=/bin/kill -USR2 $MAINPID  
  
[Install]  
WantedBy=multi-user.target

Ative o serviço e recarregue o systemd:

systemctl enable php-7.2-fpm.service  
systemctl daemon-reload

Finalmente, inicie o PHP-FPM.

systemctl start php-7.2-fpm.service

Para habilitar o Zend OPcache, abra /opt/php-7.2/lib/php.ini…

nano /opt/php-7.2/lib/php.ini

… e adicione a seguinte linha ao final:

[...]  
zend_extension=opcache.so

4.2 Habilitar Memcache (opcional)

Neste capítulo, vou compilar e habilitar a extensão PHP Memcached.

O primeiro passo é instalar o pacote libmemcached-dev do Debian.

apt-get install libmemcached-dev

Em seguida, crie um diretório, baixe a extensão PHP memcache do Github, descompacte o arquivo e entre no diretório que contém os arquivos descompactados.

mkdir /usr/local/src/php7.2-build/php-memcache  
cd /usr/local/src/php7.2-build/php-memcache  
wget https://github.com/php-memcached-dev/php-memcached/archive/php7.zip  
unzip php7.zip  
cd php-memcached-php7

Prepare os fontes executando o comando phpize do PHP 7.2.

/opt/php-7.2/bin/phpize

Configure e compile a extensão PHP memcache.

./configure --with-php-config=/opt/php-7.2/bin/php-config  
make  
make install

Para habilitar a extensão Memcache, abra /opt/php-7.2/lib/php.ini…

nano /opt/php-7.2/lib/php.ini

… e adicione a seguinte linha ao final:

[...]  
extension=memcached.so

4.3 Instalar a extensão xDebug (opcional)

O módulo xDebug é uma extensão de depuração para PHP. A instalação é opcional.

Instale o xDebug com estes comandos.

cd /opt/php-7.2/etc  
pecl -C ./pear.conf update-channels  
pecl -C ./pear.conf install xdebug

Em seguida, edite o arquivo php.ini com um editor:

nano /opt/php-7.2/lib/php.ini

e adicione a seguinte linha ao final do arquivo:

zend_extension=/opt/php-7.2/lib/php/extensions/no-debug-non-zts-20170718/xdebug.so

Finalmente, reinicie o daemon php-fpm:

systemctl start php-7.2-fpm.service

Teste a versão do PHP:

cd /opt/php-7.2/bin  
./php --version

A saída deve ser semelhante a esta captura de tela.

Por favor, note: A captura de tela é do PHP 7.2.2, o tutorial é atualizado continuamente para novas versões do PHP, mas não tiramos novas capturas de tela a cada vez, então a versão do PHP que você verá em seu servidor pode ser mais nova. A versão atual deste tutorial é para php-7.2.2.

4.4 Habilitar PHP 7.2 no ISPConfig

No ISPConfig 3.1, você pode configurar a nova versão do PHP em Sistema > Versões Adicionais do PHP. Na guia Nome, você apenas preenche um nome para a versão do PHP (por exemplo, PHP 7.2) - esta versão do PHP será listada sob este nome nas configurações do site no ISPConfig:

PHP 7.2

Vá para a guia Configurações do FastCGI e preencha os campos da seguinte forma:

Caminho para o binário PHP FastCGI: /opt/php-7.2/bin/php-cgi  
Caminho para o diretório php.ini: /opt/php-7.2/lib

PHP 7.1 FCGI

Em seguida, vá para a guia Configurações do PHP-FPM e preencha os campos da seguinte forma:

Caminho para o script init do PHP-FPM: php-7.2-fpm  
Caminho para o diretório php.ini: /opt/php-7.2/lib  
Caminho para o diretório do pool do PHP-FPM: /opt/php-7.2/etc/php-fpm.d  

PHP 7.2 FPM

5 Compilar PHP 5.6 como PHP-FPM e Fastcgi

Baixe o PHP e descompacte o arquivo tar.bz2:

mkdir -p /opt/php-5.6  
mkdir /usr/local/src/php5.6-build  
cd /usr/local/src/php5.6-build  
wget http://de2.php.net/get/php-5.6.33.tar.bz2/from/this/mirror -O php-5.6.33.tar.bz2  
tar jxf php-5.6.33.tar.bz2

A versão do OpenSSL no Debian 9 é muito nova para o PHP 5.6, então teremos que compilar uma versão mais antiga em /opt/openssl para usá-la com o PHP 5.6.

cd /tmp  
wget "https://www.openssl.org/source/old/1.0.1/openssl-1.0.1t.tar.gz"  
tar xzf openssl-1.0.1t.tar.gz   
cd openssl-1.0.1t  
./config shared --prefix=/opt/openssl  
make -j $(nproc) && make install  
ln -s /opt/openssl/lib /opt/openssl/lib/x86_64-linux-gnu  
wget -O /opt/openssl/ssl/cert.pem "http://curl.haxx.se/ca/cacert.pem"

Crie um symlink para que o PHP encontre as bibliotecas freetype, libcrypto e libssl.

mkdir /usr/include/freetype2/freetype  
ln -s /usr/include/freetype2/freetype.h /usr/include/freetype2/freetype/freetype.h  
ln -s /opt/openssl/lib/libcrypto.so.1.0.0 /usr/lib/x86_64-linux-gnu/  
ln -s /opt/openssl/lib/libssl.so.1.0.0 /usr/lib/x86_64-linux-gnu/  
ln -fs /opt/openssl /usr/local/ssl

Entre na pasta que contém os arquivos fonte do PHP descompactados.

cd /usr/local/src/php5.6-build/php-5.6.33/

Configure e compile o PHP 5.6 da seguinte forma (você pode ajustar o comando ./configure conforme suas necessidades, dê uma olhada em

./configure --help

para ver todas as opções disponíveis; se você usar um comando ./configure diferente, é possível que bibliotecas adicionais sejam necessárias, ou o processo de compilação falhe):

./configure --prefix=/opt/php-5.6 --with-pdo-pgsql --with-zlib-dir --with-freetype-dir --enable-mbstring --with-libxml-dir=/usr --enable-soap --enable-calendar --with-curl --with-mcrypt --with-zlib --with-pgsql --disable-rpath --enable-inline-optimization --with-bz2 --with-zlib --enable-sockets --enable-sysvsem --enable-sysvshm --enable-pcntl --enable-mbregex --enable-exif --enable-bcmath --with-mhash --enable-zip --with-pcre-regex --with-pdo-mysql --with-mysqli --with-mysql-sock=/var/run/mysqld/mysqld.sock --with-jpeg-dir=/usr --with-png-dir=/usr --enable-gd-native-ttf --with-openssl=/opt/openssl --with-fpm-user=www-data --with-fpm-group=www-data --with-libdir=/lib/x86_64-linux-gnu --enable-ftp --with-kerberos --with-gettext --with-xmlrpc --with-xsl --enable-opcache --enable-fpm

O último parâmetro ( –enable-fpm) garante que esta versão do PHP funcionará com o PHP-FPM.

make  
make install

Copie php.ini e php-fpm.conf para os locais corretos:

cp /usr/local/src/php5.6-build/php-5.6.33/php.ini-production /opt/php-5.6/lib/php.ini
cp /opt/php-5.6/etc/php-fpm.conf.default /opt/php-5.6/etc/php-fpm.conf
mkdir -p /opt/php-5.6/etc/php-fpm.d

Abra /opt/php-5.6/etc/php-fpm.conf e ajuste a seguinte configuração:

nano /opt/php-5.6/etc/php-fpm.conf
[...]  
pid = run/php-fpm.pid  
[...]  
user = www-data  
group = www-data  
[...]  
listen = 127.0.0.1:8997  
[...]  
include=/opt/php-5.6/etc/php-fpm.d/*.conf

5.1 Criar o arquivo de unidade systemd

Em seguida, criaremos o arquivo de unidade do sistema que é usado para iniciar e parar o daemon PHP-FPM.

nano /lib/systemd/system/php-5.6-fpm.service

com o seguinte conteúdo:

[Unit]  
Description=The PHP 5.6 FastCGI Process Manager  
After=network.target  
  
[Service]  
Type=simple  
PIDFile=/opt/php-5.6/var/run/php-fpm.pid  
ExecStart=/opt/php-5.6/sbin/php-fpm --nodaemonize --fpm-config /opt/php-5.6/etc/php-fpm.conf  
ExecReload=/bin/kill -USR2 $MAINPID  
  
[Install]  
WantedBy=multi-user.target

Ative o serviço e recarregue o systemd:

systemctl enable php-5.6-fpm.service  
systemctl daemon-reload

Finalmente, inicie o PHP-FPM.

systemctl start php-5.6-fpm.service

Para habilitar o Zend OPcache, abra /opt/php-5.6/lib/php.ini…

nano /opt/php-5.6/lib/php.ini

… e adicione a seguinte linha ao final:

[...]  
zend_extension=opcache.so

5.2 Habilitar Memcache (opcional)

Neste capítulo, vou compilar e habilitar a extensão PHP Memcached.

O primeiro passo é instalar o pacote libmemcached-dev do Debian.

apt-get install libmemcached-dev

Em seguida, execute estes comandos para compilar a extensão memcache

cd /opt/php-5.6/etc  
pecl -C ./pear.conf update-channels  
pecl -C ./pear.conf install memcache

Para habilitar a extensão Memcache, abra /opt/php-5.6/lib/php.ini…

nano /opt/php-5.6/lib/php.ini

… e adicione a seguinte linha ao final:

[...]  
extension=memcache.so

Finalmente, reinicie o daemon php-fpm:

systemctl start php-5.6-fpm.service

Teste a versão do PHP:

cd /opt/php-5.6/bin  
./php --version

A saída deve ser semelhante a esta captura de tela.

Por favor, note: A captura de tela é do PHP 5.6.33, o tutorial é atualizado continuamente para novas versões do PHP, mas não tiramos novas capturas de tela a cada vez, então a versão do PHP que você verá em seu servidor pode ser mais nova. A versão atual deste tutorial é para php-5.6.33.

5.4 Habilitar PHP 5.6 no ISPConfig

No ISPConfig 3.1, você pode configurar a nova versão do PHP em Sistema > Versões Adicionais do PHP. Na guia Nome, você apenas preenche um nome para a versão do PHP (por exemplo, PHP 5.6) - esta versão do PHP será listada sob este nome nas configurações do site no ISPConfig:

PHP 5.6

Vá para a guia Configurações do FastCGI e preencha os campos da seguinte forma:

Caminho para o binário PHP FastCGI: /opt/php-5.6/bin/php-cgi  
Caminho para o diretório php.ini: /opt/php-5.6/lib

PHP 5.6 FCGI

Em seguida, vá para a guia Configurações do PHP-FPM e preencha os campos da seguinte forma:

Caminho para o script init do PHP-FPM: php-5.6-fpm  
Caminho para o diretório php.ini: /opt/php-5.6/lib  
Caminho para o diretório do pool do PHP-FPM: /opt/php-5.6/etc/php-fpm.d  

PHP 5.6 FPM

6 Links

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.