PHP 설치 · 6 min read · Oct 28, 2025

Debian 8 (Jessie)에서 ISPConfig 3.1을 위한 PHP-FPM 및 FastCGI로 PHP 7.1.16 설치하기

최종 버전의 PHP 7.1은 Github 및 PHP 미러에서 다운로드할 수 있습니다. PHP 7.1은 PHP 프로그래밍 언어의 차세대 버전으로, 릴리스 노트에 따르면 PHP 5.6보다 최대 2배, PHP 5.0보다 14배 더 빠릅니다. 새로운 PHP 버전은 일부 사용 중단된 API가 제거되었기 때문에 PHP 5.x와 100% 호환되지 않으므로, 이 새로운 릴리스와의 호환성을 위해 웹사이트를 테스트하는 것이 좋습니다. 이는 ISPConfig 3의 다중 PHP 버전 기능을 사용하여 쉽게 수행할 수 있으며, 서버의 모든 사이트에 영향을 주지 않습니다. PHP 버전은 ISPConfig 3 웹사이트 설정에서 각 사이트별로 선택할 수 있습니다. 이 기능은 PHP-FPM 및 FastCGI와 함께 작동합니다. 이 튜토리얼은 Debian Jessie 서버에서 PHP-FPM 및 FastCGI 버전으로 새로운 PHP 7.1을 빌드하는 방법을 보여줍니다. 이 PHP 7.1 빌드는 많은 컴파일된 확장 및 Zend OPcache와 Memcached를 로드 가능한 모듈로 포함합니다.

1 사전 참고

저는 며칠 전에 최종 버전으로 출시된 PHP 7.1을 설치할 것입니다. PHP-FPM은 Apache 및 Nginx 서버 모두에서 사용할 수 있지만 FastCGI는 Apache 서버에서만 사용할 수 있습니다.

이전 PHP 버전에서는 PHP-FPM과 FastCGI가 상호 배타적이어서 FPM 및 FastCGI 바이너리를 별도로 빌드해야 했습니다. PHP 7.1에서는 FPM 및 FCGI 모드를 지원하는 단일 바이너리를 빌드할 수 있습니다.

2 PHP-FPM 및 Fastcgi로 PHP 7.1 컴파일하기

Github에서 PHP 7.1을 다운로드하고 추출합니다:

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

PHP 7.1을 빌드하기 위한 필수 패키지와 구성 파일을 편집하는 데 사용할 nano 편집기를 설치합니다:

apt-get install build-essential nano autoconf
apt-get install libfcgi-dev libfcgi0ldbl libjpeg62-turbo-dbg libmcrypt-dev libssl-dev libc-client2007e libc-client2007e-dev libxml2-dev libbz2-dev libcurl4-openssl-dev libjpeg-dev libpng12-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

(마지막 명령은 –with-imap으로 PHP를 빌드할 경우 필요합니다. 그렇지 않으면 ./configure가 다음 오류로 중단됩니다:

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.0.7#

)

다음과 같이 PHP 7.1을 구성하고 빌드합니다(./configure 명령을 필요에 맞게 조정할 수 있으며, 사용 가능한 모든 옵션을 보려면

./configure --help

를 참조하십시오. 다른 ./configure 명령을 사용하는 경우 추가 라이브러리가 필요하거나 빌드 프로세스가 실패할 수 있습니다):

./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

마지막 스위치(–enable-fpm)는 이 PHP 버전이 PHP-FPM과 함께 작동하도록 보장합니다.

make  
make install

php.ini 및 php-fpm.conf를 올바른 위치로 복사합니다:

cp /usr/local/src/php7-build/php-7.1.16/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

/opt/php-7.1/etc/php-fpm.conf를 열고 다음 설정을 조정합니다( pid 줄 앞의 ;를 제거합니다):

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

그런 다음 /opt/php-7.1/etc/php-fpm.d/www.conf를 열고 listen 줄을 조정합니다. 사용되지 않는 포트를 사용해야 합니다(예: 8999; 포트 9000은 Debian의 기본 PHP-FPM에서 이미 사용 중일 수 있습니다):

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

여러 추가 PHP 버전을 사용하는 경우, 다음 버전에는 무료 포트를 사용해야 합니다(예: 8998, 8997 등).

3 초기화 스크립트 및 systemd 유닛 파일 생성하기

Debian은 Systemd와 전통적인 초기화 스크립트를 모두 지원합니다. 오늘날 대부분의 시스템은 Systemd를 사용하므로, 이 경우 3.2 장으로 진행하고, 전통적인 초기화 시스템이 있는 시스템은 3.1 장을 따르고 4 장으로 진행하십시오. 동일한 시스템에 systemd와 init.d 스크립트를 모두 설치하지 마십시오.

3.1 init.d 시작 스크립트 생성하기

먼저 php-fpm 서비스용 init 스크립트를 생성한 다음 systemd 유닛을 생성합니다.

먼저 PHP-FPM을 위한 init 스크립트를 생성합니다:

nano /etc/init.d/php-7.1-fpm
#! /bin/sh
### BEGIN INIT INFO
# Provides:          php-7.1-fpm
# Required-Start:    $all
# Required-Stop:     $all
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: starts php-7.1-fpm
# Description:       starts the PHP FastCGI Process Manager daemon
### END INIT INFO
php_fpm_BIN=/opt/php-7.1/sbin/php-fpm
php_fpm_CONF=/opt/php-7.1/etc/php-fpm.conf
php_fpm_PID=/opt/php-7.1/var/run/php-fpm.pid
php_opts="--fpm-config $php_fpm_CONF"
wait_for_pid () {
        try=0
        while test $try -lt 35 ; do
                case "$1" in
                        'created')
                        if [ -f "$2" ] ; then
                                try=''
                                break
                        fi
                        ;;
                        'removed')
                        if [ ! -f "$2" ] ; then
                                try=''
                                break
                        fi
                        ;;
                esac
                echo -n .
                try=`expr $try + 1`
                sleep 1
        done
}
case "$1" in
        start)
                echo -n "Starting php-fpm "
                $php_fpm_BIN $php_opts
                if [ "$?" != 0 ] ; then
                        echo " failed"
                        exit 1
                fi
                wait_for_pid created $php_fpm_PID
                if [ -n "$try" ] ; then
                        echo " failed"
                        exit 1
                else
                        echo " done"
                fi
        ;;
        stop)
                echo -n "Gracefully shutting down php-fpm "
                if [ ! -r $php_fpm_PID ] ; then
                        echo "warning, no pid file found - php-fpm is not running ?"
                        exit 1
                fi
                kill -QUIT `cat $php_fpm_PID`
                wait_for_pid removed $php_fpm_PID
                if [ -n "$try" ] ; then
                        echo " failed. Use force-exit"
                        exit 1
                else
                        echo " done"
                       echo " done"
                fi
        ;;
        force-quit)
                echo -n "Terminating php-fpm "
                if [ ! -r $php_fpm_PID ] ; then
                        echo "warning, no pid file found - php-fpm is not running ?"
                        exit 1
                fi
                kill -TERM `cat $php_fpm_PID`
                wait_for_pid removed $php_fpm_PID
                if [ -n "$try" ] ; then
                        echo " failed"
                        exit 1
                else
                        echo " done"
                fi
        ;;
        restart)
                $0 stop
                $0 start
        ;;
        reload)
                echo -n "Reload service php-fpm "
                if [ ! -r $php_fpm_PID ] ; then
                        echo "warning, no pid file found - php-fpm is not running ?"
                        exit 1
                fi
                kill -USR2 `cat $php_fpm_PID`
                echo " done"
        ;;
        *)
                echo "Usage: $0 {start|stop|force-quit|restart|reload}"
                exit 1
        ;;
esac

init 스크립트를 실행 가능하게 만들고 시스템 시작 링크를 생성합니다:

chmod 755 /etc/init.d/php-7.1-fpm  
insserv php-7.1-fpm

마지막으로 PHP-FPM을 시작합니다:

/etc/init.d/php-7.1-fpm start

결과는 다음과 같아야 합니다:

/etc/init.d/php-7.1-fpm start  
Starting php-fpm done

3.2 PHP 7.1을 위한 Systemd 스크립트 생성하기

이제 systemd 유닛 파일을 생성합니다:

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

다음 내용을 입력합니다:

[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

서비스를 활성화하고 systemd를 다시 로드합니다:

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

마지막으로 PHP-FPM을 시작합니다:

systemctl start php-7.1-fpm.service

4 Zend OPcache 활성화하기

Zend OPcache를 활성화하려면 /opt/php-7.1/lib/php.ini를 엽니다…

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

… 그리고 마지막에 다음 줄을 추가합니다:

[...]  
zend_extension=opcache.so

Memcache 및 APCu 확장은 아직 PHP 7.1에 설치할 수 없으므로, 지금은 설치를 건너뛰겠습니다. PECL 확장이 PHP 7.1과 호환될 때 튜토리얼을 업데이트할 것입니다.

PHP 버전을 테스트합니다:

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

출력은 이 스크린샷과 유사해야 합니다.

참고: 스크린샷은 PHP 7.1.16에서 찍은 것이며, 튜토리얼은 새로운 PHP 7.1 버전에 대해 지속적으로 업데이트되지만, 매번 새로운 스크린샷을 찍지는 않으므로, 서버에서 볼 수 있는 PHP 7.1 버전은 더 최신일 수 있습니다. 이 튜토리얼의 현재 버전은 php-7.1.16에 대한 것입니다.

5 Memcache 활성화 (선택 사항)

이 장에서는 PHP Memcached 확장을 컴파일하고 활성화합니다.

첫 번째 단계는 Debian에서 libmemcached-dev 패키지를 설치하는 것입니다.

apt-get install libmemcached-dev

그런 다음 디렉토리를 만들고, Github에서 PHP memcache 확장을 다운로드하고, 아카이브를 풀고, 압축 해제된 파일이 포함된 디렉토리로 이동합니다.

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

PHP 7.1의 phpize 명령을 실행하여 소스를 준비합니다.

/opt/php-7.1/bin/phpize

PHP memcache 확장을 구성하고 빌드합니다.

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

Memcache 확장을 활성화하려면 /opt/php-7.1/lib/php.ini를 엽니다…

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

… 그리고 마지막에 다음 줄을 추가합니다:

[...]  
extension=memcached.so

2.1 xDebug 확장 설치 (선택 사항)

xDebug 모듈은 PHP용 디버깅 확장입니다. 설치는 선택 사항입니다.

다음 명령으로 xDebug를 설치합니다.

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

그런 다음 편집기로 php.ini 파일을 편집합니다:

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

마지막에 다음 줄을 추가합니다:

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

마지막으로 php-fpm 데몬을 재시작합니다:

service php-7.1-fpm restart

7 ISPConfig에서 PHP 7.1 활성화하기

ISPConfig 3에서 시스템 > 추가 PHP 버전에서 새로운 PHP 버전을 구성할 수 있습니다. 이름 탭에서 PHP 버전의 이름을 입력하면(예: PHP 7.1) 이 PHP 버전은 ISPConfig의 웹사이트 설정에서 이 이름으로 나열됩니다:

사용자 정의 PHP 버전의 이름 입력하기

FastCGI 설정 탭으로 이동하여 다음과 같이 필드를 작성합니다:

PHP FastCGI 바이너리 경로: /opt/php-7.1/bin/php-cgi  
php.ini 디렉토리 경로: /opt/php-7.1/lib

PHP 7.1 FastCGI

그런 다음 PHP-FPM 설정 탭으로 이동하여 다음과 같이 필드를 작성합니다:

PHP-FPM init 스크립트 경로: /etc/init.d/php-7.1-fpm  
php.ini 디렉토리 경로: /opt/php-7.1/lib  
PHP-FPM 풀 디렉토리 경로: /opt/php-7.1/etc/php-fpm.d  

PHP 7.1 FPM 설정

7 링크

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.