Como Instalar suPHP Em Várias Distribuições Linux Para Uso Com ISPConfig (2.2.20 E Acima)

Versão 1.0
Autor: Falko Timme

A partir da versão 2.2.20, o ISPConfig melhorou o suporte ao suPHP. Este artigo explica como instalar o suPHP em várias distribuições suportadas pelo ISPConfig. (Se você usou suPHP com versões anteriores do ISPConfig, sua instalação ainda funcionará.)

Não dou nenhuma garantia de que isso funcionará para você!

1 Debian Etch / Ubuntu 7.10

Para Debian e Ubuntu, o pacote libapache2-mod-suphp existe, no entanto, o problema com este pacote é que ele não suporta a diretiva suPHP_UserGroup (que é usada pelo ISPConfig) porque não foi compilado usando a opção –with-setid-mode=paranoid. Portanto, devemos construir o mod_suphp manualmente.

Primeiro, desabilitamos o módulo PHP5 normal (como root):

a2dismod php5  
/etc/init.d/apache2 restart

Em seguida, instalamos os pré-requisitos necessários para construir o mod_suphp:

apt-get install php5-cgi apache2-prefork-dev

Agora podemos baixar e construir o suPHP da seguinte forma:

cd /tmp  
wget http://www.suphp.org/download/suphp-0.6.2.tar.gz  
tar xvfz suphp-0.6.2.tar.gz  
cd suphp-0.6.2  
./configure --prefix=/usr --sysconfdir=/etc --with-apache-user=www-data --with-setid-mode=paranoid --with-apxs=/usr/bin/apxs2  
make  
make install

Finalmente, adicionamos o módulo suPHP à nossa configuração do Apache…

vi /etc/apache2/httpd.conf

| LoadModule suphp_module /usr/lib/apache2/modules/mod_suphp.so |

… e reiniciamos o Apache:

/etc/init.d/apache2 restart

2 Fedora 8 / CentOS 5.1

No Fedora 8 e CentOS 5.1, devemos construir o mod_suphp manualmente pelos mesmos motivos que para Debian e Ubuntu (suPHP_UserGroup).

Primeiro, desabilitamos o módulo PHP5 normal:

vi /etc/httpd/conf.d/php.conf

Comente a linha LoadModule:

| [...] #LoadModule php5_module modules/libphp5.so [...] |

Em seguida, instalamos os pré-requisitos necessários para construir o mod_suphp:

yum install php-cli httpd-devel

Agora podemos baixar e construir o suPHP da seguinte forma:

cd /tmp  
wget http://www.suphp.org/download/suphp-0.6.2.tar.gz  
tar xvfz suphp-0.6.2.tar.gz  
cd suphp-0.6.2/  
./configure --prefix=/usr --sysconfdir=/etc --with-apr=/usr/bin/apr-1-config --with-apxs=/usr/sbin/apxs --with-apache-user=apache --with-setid-mode=paranoid --with-php=/usr/bin/php-cgi --with-logfile=/var/log/httpd/suphp_log --enable-SUPHP_USE_USERGROUP=yes  
make  
make install

Finalmente, adicionamos o módulo suPHP à nossa configuração do Apache…

vi /etc/httpd/conf.d/suphp.conf

| LoadModule suphp_module modules/mod_suphp.so |

… e reiniciamos o Apache:

/etc/init.d/httpd restart

3 Mandriva 2008.0

No Mandriva 2008.0, devemos construir o mod_suphp manualmente pelos mesmos motivos que para Debian e Ubuntu (suPHP_UserGroup).

Primeiro, desabilitamos o módulo PHP5 normal:

vi /etc/httpd/modules.d/70_mod_php.conf

Comente a linha LoadModule:

| #LoadModule php5_module extramodules/mod_php5.so [...] |

Em seguida, instalamos os pré-requisitos necessários para construir o mod_suphp:

urpmi php-cgi apache-devel

Agora podemos baixar e construir o suPHP da seguinte forma:

cd /tmp  
wget http://www.suphp.org/download/suphp-0.6.2.tar.gz  
tar xvfz suphp-0.6.2.tar.gz  
cd suphp-0.6.2/  
./configure --prefix=/usr --sysconfdir=/etc --with-apr=/usr/bin/apr-1-config --with-apxs=/usr/sbin/apxs --with-apache-user=apache --with-setid-mode=paranoid --with-php=/usr/bin/php-cgi --with-logfile=/var/log/httpd/suphp_log --enable-SUPHP_USE_USERGROUP=yes  
make  
make install

Finalmente, adicionamos o módulo suPHP à nossa configuração do Apache…

vi /etc/httpd/modules.d/A36_mod_suphp.conf

| LoadModule suphp_module modules/mod_suphp.so |

… e reiniciamos o Apache:

/etc/init.d/httpd restart

4 OpenSUSE 10.3

OpenSUSE 10.3 vem com um pacote suPHP que entende a diretiva suPHP_UserGroup, então não precisamos construí-lo nós mesmos.

Primeiro, desabilitamos o módulo PHP5 normal. Abra /etc/sysconfig/apache2 e remova php5 da linha APACHE_MODULES (para que fique semelhante a esta linha - seus módulos podem diferir, mas php5 não deve mais estar listado):

vi /etc/sysconfig/apache2

| [...] APACHE_MODULES="actions alias auth_basic authn_file authz_host authz_groupfile authz_default authz_user authn_dbm autoindex cgi dir env expires include log_config mime negotiation setenvif ssl suexec userdir rewrite ruby" [...] |

Execute

SuSEconfig

depois.

Agora instalamos o suPHP da seguinte forma:

yast -i suphp

Em seguida, adicionamos suphp à linha APACHE_MODULES em /etc/sysconfig/apache2, por exemplo, assim:

vi /etc/sysconfig/apache2

Os pacotes suPHP do OpenSUSE vêm com uma configuração suPHP que habilita o suPHP globalmente. Portanto, devemos desabilitar essa configuração agora para que possamos habilitar ou desabilitar o suPHP no ISPConfig em uma base por site:

vi /etc/apache2/conf.d/mod_suphp.conf

Nesse arquivo, comentamos tudo:

| # # suPHP_Engine on # # AddType application/x-httpd-php .php # AddType application/x-httpd-php .php3 # AddType application/x-httpd-php .php4 # AddType application/x-httpd-php .php5 # AddHandler application/x-httpd-php .php # # DirectoryIndex index.php index.php3 index.php4 index.php5 # # # suPHP_AddHandler application/x-httpd-php # # # no seu vhost você precisa: # # suPHP_UserGroup someuser somegroup # |

Finalmente, executamos:

SuSEconfig  
/etc/init.d/apache2 restart

5 Configurar ISPConfig

Finalmente, devemos informar ao ISPConfig que ele deve escrever uma configuração suPHP para os vhosts do Apache em vez da configuração PHP usual. Para fazer isso, abrimos o arquivo de configuração do ISPConfig /home/admispconfig/ispconfig/lib/config.inc.php e definimos $go_info[“server”][“apache2_php”] como suphp:

vi /home/admispconfig/ispconfig/lib/config.inc.php

| [...] $go_info["server"]["apache2_php"] = 'suphp'; [...] |

Agora, sempre que você habilitar o PHP para um site na ISPConfig, o ISPConfig escreverá uma configuração suPHP para a configuração do vhost desse site.

6 Links

suPHP: http://www.suphp.org
ISPConfig: http://www.ispconfig.org