fastcgi and php with ispconfig

[tosser]

Howtos about fastcgi and php that are used or consulted:
http://www.debianhowto.de/de/howtos/sarge/apache2_php-fcgi
http://www.syscp.de/wiki/contrib/PHP-FCGI-ger




Apache2 Install
In the first step you install apache2-mpm-worker
apt-get install apache2-common apache2-mpm-worker apache2-threaded-dev

if you restart the apache, but without mod_php. Because mod_php runs not with apache2-mpm-worker!
/etc/init.d/apache2 restart



Build Suexec
then you load the apache sources to compile a new suexec for fastcgi

cd /root
apt-get source apache2-common
cd apache2-2.0.54
cd upstream
cd tarballs
tar zxf httpd-2.0.51.tar.gz
cd httpd-2.0.54
cd support
vi suexec.h

edit the follow lines:
#define AP_HTTPD_USER "www"
with
#define AP_HTTPD_USER "www-data"

#define AP_LOG_EXEC DEFAULT_EXP_LOGFILEDIR "/suexec_log" /* Need me? */
with
#define AP_LOG_EXEC "/var/log/apache2/suexec.log" /* Need me? */

#define AP_DOC_ROOT DEFAULT_EXP_HTDOCSDIR
with
#define AP_DOC_ROOT "/var/www"

edit suexec.c
vi suexec.c

then insert the red market text into
/* no file owner check
if ((uid != dir_info.st_uid) ||
(gid != dir_info.st_gid) ||


(uid != prg_info.st_uid) ||
(gid != prg_info.st_gid)) {
log_err("target uid/gid (%ld/%ld) mismatch "
"with directory (%ld/%ld) or program (%ld/%ld)\n",
uid, gid,
dir_info.st_uid, dir_info.st_gid,
prg_info.st_uid, prg_info.st_gid);
exit(120);
}
*/


You need the apache2-header-files to compile suexec
cp -p /usr/include/apache2/* .
cp -p /usr/include/apr-0/* .

make suexec

then you must have:
ls -l suexec
-rwxr-xr-x 1 root root 20565 Aug 5 23:37 suexec

copy the suexec for fcgi to /usr/lib/apache2

cp suexec /usr/lib/apache2/suexec-fcgi
chmod 4755 /usr/lib/apache2/suexec-fcgi

you can delete the files, that you has downloaded with apt-source



Compile PHP (next step you can install by debian packages without compiling)
$ cd
mkdir php5
cd php5
wget http://de3.php.net/get/php-5.1.4.tar.gz/from/a/mirror
tar zxf php-5.1.4.tar.gz
cd php-5.1.4.tar.gz

./configure --enable-memory-limit --enable-force-cgi-redirect \
--enable-track-vars --with-pcre-regex --with-mysql --without-sqlite \
--without-mm --enable-fastcgi --prefix=/home/_USER_/php5
make
make install

Important for php5 compilation and fastcgi:
apt-get install libmysqlclient14-dev libxml2-dev

./configure with: –enable-fastcgi –without-mm

if any packages missed use
apt-cache search "MISSED"
apt-get install "THE NEEDED PACKAGE



Inofficial Debain Packages for PHP5:
echo "deb http://people.debian.org/~dexter php5.1 sarge" >> /etc/apt/sources.list
echo "deb-src http://people.debian.org/~dexter php5.1 sarge" >> /etc/apt/sources.list
apt-get update
apt-get install php5.0 php5.0-common php5.0-fcgi apache2-mpm-worker

apt-get install apache2-mpm-worker because debian would like to remove it and install apache2-mpm-prefork again.



libapache2-mod-fastgi:
you musst edit the "/etc/apt/source.list" and include the non-free sector. It show like that:
deb http://ftp.de.debian.org/debian/ stable main non-free
then
apt-get update
apt-get install libapache2-mod-fastcgi

then you edit the "/etc/apache2/mods-avaible/fastcgi.conf" with you favorit editor
vi /etc/apache2/mods-available/fastcgi.conf
it musst show like:

<IfModule mod_fastcgi.c>

#temporary sockets are stored here, this must be at the top!
FastCgiIpcDir /var/lib/apache2/fastcgi

#config
FastCgiConfig -pass-header Authorization


FastCgiWrapper /usr/lib/apache2/suexec-fcgi


AddHandler php-fastcgi .php
<Location /php/php-fcgi-starter>
SetHandler fastcgi-script
Options +ExecCGI
</Location>
Action php-fastcgi /php/php-fcgi-starter

##ISPConfig add this by the installtion of it

##ISPConfig INSTALL## AddType ##ISPConfig INSTALL## application/x-httpd-php .php

<Directory "/var/www/">
AllowOverride None
Options +ExecCGI -MultiViews -Indexes
Order allow,deny
Allow from all
</Directory>
</IfModule>


-----------------------------------------------------------------------
now you must install ispconfig, if you didn't have it or you modify it by own
-----------------------------------------------------------------------


fast-cgi start script
You need a fast-cgi starter for all web hosts:
cd /root/ispconfig/standard_cgis
vi php-fcgi-starter

my php-fcgi-starter (with apache php5.1-fcgi package):
#!/bin/sh
PHPRC="/etc/php5.1/fcgi/"
export PHPRC
PHP_FCGI_CHILDREN=4
export PHP_FCGI_CHILDREN
exec /usr/bin/php5.1-fcgi

it must have root permissions:
-rwxr-xr-x 1 root root 151 2006-05-31 00:15 php-fcgi-starter
that the webuser can excute it (by suexec) but can't edit it!


-----------------------------------------------------------------------
ispconfig copy this to /var/www/web*/ if you activate the standard_cgis, it a way to use fastcgi, but certainly not the optimal with ispconfig!
------------------------------------------------------------------------


modify ISPConfig
you must edit the vhost.conf.master
vi /root/ispconfig/isp/conf/vhost.conf.master
insert the red text:
...
######################################
# Vhost: {SERVERNAME}
######################################
#
#
<VirtualHost {IP}>
{HTTPD_INCLUDE}
{SUEXEC}
ServerName {SERVERNAME}
ServerAdmin {SERVERADMIN}
DocumentRoot {DOCUMENTROOT}
{SERVERALIAS}
{DIRECTORYINDEX}
ScriptAlias /php/ {HTTPD_ROOT}/{WEB}/
{CGI}
ErrorLog {WEB_ERROR_LOG}
{PHP}
{SSI}
{WAP}
{ERRORALIAS}
{ERROR}
AliasMatch ^/~([^/]+)(/(.*))? {HTTPD_ROOT}/{WEB}/user/$1/web/$3
AliasMatch ^/users/([^/]+)(/(.*))? {HTTPD_ROOT}/{WEB}/user/$1/web/$3
{REWRITE_RULE}
{FRONTPAGE}
</VirtualHost>
#
{SSL}
#
....



-----------------------------------------------------------------------------
It's a simple way for fastcgi, php and ispconfig. But i searched a way without edit ispconfig files because updates of ispconfig.

I'm pleased to get feedback and better solutions ;)
and I hope that fastcgi find a way into the default installation of ispconfig :)

[till]

Hi,

thanks for the ISPCOnfig FastCGI howto. We will integrate PHP FastCGI support in one of the next dev releases.

[tosser]

I have update the howto, with a better solution.
so you can can activate or disable it with the php button.

Link to the current howto with the patchfile (http://www.howtoforge.com/forums/showthread.php?t=4606&highlight=fastcgi)

[falko]

The current version of tosser's tutorial can be found here: http://www.howtoforge.com/forums/showthread.php?t=4606
I close this thread (so that tosser does not need to update two threads); if you need the current version of the tutorial or have questions, please go to the other thread. :)