cvs: php4 / INSTALL

imajes Wed Jan 23 21:06:20 2002 EDT Modified files: /php4 INSTALL Log: updated INSTALL to be more relevant.. more fixes coming (at some point) Index: php4/INSTALL diff -u php4/INSTALL:1.21 php4/INSTALL:1.22 --- php4/INSTALL:1.21 Sun Dec 16 11:46:18 2001 +++ php4/INSTALL Wed Jan 23 21:06:20 2002 @@ -1,9 +1,17 @@ Installation Instructions for PHP 4.1 ------------------------------------- -For the impatient here is a quick set of steps that will build PHP as -first a dynamic Apache module (DSO) for Apache 1.3.x with MySQL support -and then a static module. A more verbose explanation follows. +STOP! + +Before going any further, please remember you are going to find more +up to date instructions in the online manual, located here: + +http://www.php.net/manual/en/install.apache.php + +It is strongly recommended that you read the manual page before going +further. However, for the impatient, here is a quick set of steps that +will build PHP as (first) a dynamic Apache module (DSO) for Apache 1.3.x +with MySQL support and then a static module. A more verbose explanation follows. For installing PHP on other web servers, refer to one of the following files: @@ -14,24 +22,26 @@ sapi/thttpd/README README.Zeus -Note! Only install either the static module or the dynamic one. Do not -install both. +Some notes: + +1: Only install either the static module or the dynamic one. Do not + install both. -Note 2! If you are recompiling PHP to add new extensions or upgrading -something like GD, remove the config.cache file before you re-run -configure. +2: If you are recompiling PHP to add new extensions or upgrading + something like GD, remove the config.cache file before you re-run + configure. -Note 3! If you are on Linux and have installed shared libraries, make -sure the location of these shared libraries are listed in your -/etc/ld.so.conf file. For example, if you have: +3: If you are on Linux and have installed shared libraries, make + sure the location of these shared libraries are listed in your + /etc/ld.so.conf file. For example, if you have: - /usr/local/lib/mysql/libmysqlclient.so + /usr/local/lib/mysql/libmysqlclient.so -Make sure /etc/ld.so.conf contains: + Make sure /etc/ld.so.conf contains: - /usr/local/lib/mysql + /usr/local/lib/mysql -Then run ldconfig. + Then run ldconfig. If you want both PHP 3 and 4 modules in the same Apache server, check the bottom of this file for instructions. @@ -85,7 +95,7 @@ $ gunzip -c php-4.1.x.tar.gz | tar xf - $ cd php-4.1.x -$ ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars +$ ./configure --with-mysql --with-apache=../apache_1.3.x $ make $ make install @@ -380,16 +390,11 @@ USING PHP 3 AND PHP 4 AS CONCURRENT APACHE MODULES - Recent operating systems provide the ability to perform versioning and - scoping. This features make it possible to let PHP 3 and PHP 4 run as - concurrent modules in one Apache server. - - This feature is known to work on the following platforms: + With some (newer) installations of Apache, it's possible to compile both + PHP 3 and PHP 4, and run them concurrently. - - Linux with recent binutils (binutils 2.9.1.0.25 tested) - - Solaris 2.5 or better - - FreeBSD (3.2, 4.0 tested) - - IRIX64 6.5 + Note, it's only really wise to do this if you need to use the PHP 3 engine + to maintain backwards compatibility. To enable it, configure PHP 3 and PHP 4 to use APXS (--with-apxs) and the necessary link extensions (--enable-versioning). Otherwise, all standard @@ -399,8 +404,8 @@ --with-apxs=/apache/bin/apxs \ --enable-versioning \ --with-mysql \ - --enable-track-vars - If this also works on your platform or if you know a way to do it, please - report it to our bug database at http://bugs.php.net + + +