HOW-TO: Apache + (phpsuexec, not required) + php4 (mod_php4 or cgi) + php5 (cgi) *NEW 12/15/2005 - HOW-TO updated with php5 wrapper 11/24/2005 - HOW-TO updated to reflect 5.0.4 update to 5.0.5
This setup works!
I'm using Apache 1.3.34 + phpsuexec coming with cPanel + custom php 4.3.11 compiled as cgi (actually you may use the Apache Update via WHM to compile working php4 in cgi mode/phpsuexec) + custom php 5.0.5 compiled as cgi (it is easy to do as well, I will explain)
php5 works the same as php4 and it saves the permissions and etc. E.g. no problems with nobody as well.
HOW-TO
1. Make sure you has Apache installed and workind with php4. It doesn't matter if you run mod_php4 or php4/phpsuexec, but I recommend to have phpsuexec based install (Warning: if you are running mod_php4 and would like to switch to phpsuexec, read the threads in this forum or you may end up with numerous broken scripts!);
2. You would need to compile php 5. To do this use the SSH sessing logged as root. Then execute preparation commands (based on cPanel for better compatibility): Code:
/scripts/checkccompiler rm -rf /home/cpphpbuild mkdir /home/cpphpbuild cd /home/cpphpbuild wget http://layer1.cpanel.net/buildapache/1/php-5.0.5.tar.gz tar xfzv php-5.0.5.tar.gz cd php-5.0.5
Make sure that we do enabled Sendmail support: Code:
echo "#define HAVE_SENDMAIL 1" >> /home/cpphpbuild/php-5.0.5/main/php_config.h
It is recommended to apply the mail-header patch which allows to track the script which sent an email. You may skip this step. Code:
wget http://choon.net/opensource/php/php-5.0.5-mail-header.patch patch -p1 < /home/cpphpbuild/php-5.0.5/php-5.0.5-mail-header.patch Then one of the most important steps. It is the configuring of the php. It would be better if you undestand these options. You may use the configure from your existing php. To get them type the following: Code: php -i | grep configure | sed "s/'//g" | sed "s/'//g" As you may see there are two same sed, however they are diferent! The second single quote should looks like & # 0 3 9 ; (without spaces!!) and this is for some cases when single quote sign shown as the code. You will get the almost clean configure you are currently using. The several important hints on this. a) REMOVE the "--with-apxs=/usr/local/apache/bin/apxs" from the line. We are going to compile CGI version and it WILL broke the Apache! b) Make sure you have the following prefixes and suffixes to install to the proper directories - otherwise currently installed php could be broken: --prefix=/usr/local/php5 --exec-prefix=/usr/local/php5 --program-suffix=5 c) Add the necessary options for proper CGI redirects from Apache: --enable-force-cgi-redirect --enable-discard-path The result line will looks like this (please, do not use it - it has no CURL and PostgreSQL support - you better to follow steps above): Code: ./configure --prefix=/usr/local/php5 --exec-prefix=/usr/local/php5 --program-suffix=5 --with-xml --enable-bcmath --enable-calendar --enable-ftp --with-gd --enable-exif --with-jpeg-dir=/usr --with-png-dir=/usr --with-xpm-dir=/usr/X11R6 --with-imap --with-imap-ssl --with-kerberos --enable-mbstring --with-mbstring=all --enable-mbstr-enc-trans --with-mcrypt --with-mhash --enable-magic-quotes --with-mysql=/usr --with-openssl --enable-discard-path --with-pear --enable-sockets --enable-track-vars --with-ttf --with-freetype-dir=/usr --enable-versioning --with-zlib --with-pspell --with-gettext --enable-inline-optimization --disable-debug --enable-force-cgi-redirect --enable-discard-path So, we are ready to start the compiling. Execute "make install" and it starts... If the process fails for any reason, carefully read the errors - usually they are self-explaining. In MOST cases errors are because of the inproper configure params. Then run the cPanel script to complete: /scripts/findphpversion The compiled version of php should be copied to the cPanel cgi-sys: Code: cp -f /usr/local/php5/bin/php5 /usr/local/cpanel/cgi-sys/php5 chown root:wheel /usr/local/cpanel/cgi-sys/php5 Our installation has no php.ini file yet. On MOST systems Zend Optimizer installed. In this case you may just create the symlink: Code: ln -s /usr/local/Zend/etc/php.ini /usr/local/php5/lib/php.ini Otherwise copy the default php.ini and edit it if needed: Code: cp -p /home/cpphpbuild/php-5.0.5/php.ini-recommended /usr/local/php5/lib/php.ini chown root.root /usr/local/php5/lib/php.ini chmod 644 /usr/local/php5/lib/php.ini It is recommended to add the following line to the php.ini at the bottom (it is a MUST if you compile php4 instead php5!). Note that this line will broke regular php4. As a common rule - if you are using the same php.ini, do not add this line: Code: cgi.fix_pathinfo = 1 ; needed for CGI/FastCGI mode Now we need to add several lines to Apache. Run editor (you may use "vi" or "pico -w"): pico -w /usr/local/apache/conf/httpd.conf Scroll down (better use the built-in search) to the "
This to allow index.php5 as index file.
Continue editing. Find the "AddType application/x-httpd-php .phtml" and after it add this: Code:
Action application/x-httpd-php5 "/cgi-sys/php5" AddHandler application/x-httpd-php5 .php5
This is the directives for Apache to use own php5 for files with extensions .php5
Check if we could find this line "ScriptAlias /cgi-sys/ /usr/local/cpanel/cgi-sys/" If not - add it or our directive will not work. By default cPanel add this line. Just to warn you.
Save the file and quit.
Verify that you not broke the Apache config by running: Code:
service httpd configtest
You SHOULD to get "Syntax OK" at the end and possible some minor warnings about "NameVirtualHost directive" - it is OK. Warning: if you get ERROR - DO NOT RESTART APACHE AND LOCATE THE ISSUE. Otherwise Apache will not start at all!
When you make sure it is OK restart the Apache: Code:
service httpd stop service httpd startssl
Check that Apache come ok:
lynx --dump http://localhost/whm-server-status;
It will show you the Apache status.
Well, I should congratulate you - you have done it!
To test php5 upload the simple php file with the following content to any of your sites and name this file phpinfo.php AND ANOTHER COPY phpinfo.php5: Code:
Then launch browser and point to phpinfo.php file first to see that php4 still OK, then open phpinfo.php5 to see that php5 is OK.
DONE!
PHP5 WRAPPER:
As php5 compiled in the cgi mode customers cannot to use .htaccess directives like php_admin, php_value, php_flag. In phpsuexec setup (for main php) it is overriden by allowing customers place custom php.ini with the variables.
However if you build the php5 as the secondary php it will not have such ability. So how to solve it? To write very simple wrapper to pass php.ini line of the current directory if exists.
The steps to be done after php5 setup.
Moving php5 binary:
mv /usr/local/cpanel/cgi-sys/php5 /usr/local/cpanel/cgi-sys/php5.bin
Then creating wrapper file in the /usr/local/cpanel/cgi-sys/php5 with the following
#!/bin/bash # This will fake the name & path and hide the /usr/local/cpanel/cgi-sys/php5 path! export SCRIPT_NAME=$REQUEST_URI export SCRIPT_FILENAME=$PATH_TRANSLATED export PWD=$DOCUMENT_ROOT if [ -f "$DOCUMENT_ROOT/php.ini" ]; then exec /usr/local/cpanel/cgi-sys/php5.bin -c $DOCUMENT_ROOT else exec /usr/local/cpanel/cgi-sys/php5.bin fi
Save the file and change the permissons:
chown root:wheel /usr/local/cpanel/cgi-sys/php5*; chmod 755 /usr/local/cpanel/cgi-sys/php5*;
We are done! By default php5 will use the global php.ini, but if the customer has the own php.ini in its folder php5 will use it instead.
Simple as that!
ADDONS
If you need to use php5 for applications hardcoded with .php extensions you could to add the magic line to the VirtualHost directive of this account: AddHandler application/x-httpd-php5 .php .php4 .php3 .phtml (.php5 already using php5, but you may add it if you wish)
This will redirect all php, php3, php4 and php5 (as it set default globally) to the php5.
If you need to leave the option of running php4 on .php4 files do this: AddHandler application/x-httpd-php5 .php .php3 .phtml .php5
But for those lazy folks there are an option to have these AddHandlers in the .htaccess files! Just add the respective line (example, with no quotes: "AddHandler application/x-httpd-php5 .php .php4 .php3 .phtml") to the .htaccess and this directory and all its subdirectories would be able to use the php5 for chosen files!
This is awesome when you need to test some scripts. In this way create two directories: /public_html/directory1
/public_html/directory2
And in the directory2 place .htaccess with: AddHandler application/x-httpd-php5 .php .php4 .php3 .phtml
As a result you run php4 on .php in the directory1 and run php5 on .php in the directory2!
So it is very flexible and it all depends on how you would like to process php.
P.S. Anyone who would like this setup, but not sure how to proceed - I may perform the compile works for your server(s) at a low rate on the working server with no service interruption. mod_php4 + php5/cgi combo will works as well (tested). PM me for information.
No comments:
Post a Comment