mirror of
https://github.com/php/php-src.git
synced 2024-09-21 09:57:23 +00:00
189 lines
6.9 KiB
Plaintext
189 lines
6.9 KiB
Plaintext
Installation Instructions for PHP 4.0
|
|
-------------------------------------
|
|
|
|
Note! As of 4.0b3, PHP will require GNU make.
|
|
|
|
For the impatient here is a quick set of steps that will build PHP as
|
|
an Apache module for Apache 1.3.x with MySQL support. A more verbose
|
|
explanation follows.
|
|
|
|
|
|
QUICK INSTALL
|
|
|
|
$ gunzip -c apache_1.3.x.tar.gz | tar xf -
|
|
$ cd apache_1.3.x
|
|
$ ./configure
|
|
$ cd ..
|
|
|
|
$ gunzip -c php-4.0.x.tar.gz | tar xf -
|
|
$ cd php-4.0.x
|
|
$ ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars
|
|
$ make
|
|
$ make install
|
|
|
|
$ cd ../apache_1.3.x
|
|
$ ./configure --prefix=/www --activate-module=src/modules/php4/libphp4.a
|
|
(The above line is correct! Yes, we know libphp4.a does not exist at this
|
|
stage. It isn't supposed to. It will be created.)
|
|
make
|
|
(you should now have an httpd binary which you can copy to your Apache bin dir)
|
|
cd ../php-4.0.x
|
|
cp php.ini-dist /usr/local/lib/php.ini
|
|
You can edit /usr/local/lib/php.ini file to set PHP options.
|
|
Edit your httpd.conf or srm.conf file and add:
|
|
AddType application/x-httpd-php .php
|
|
|
|
|
|
VERBOSE INSTALL
|
|
|
|
Installing PHP can be done in four simple steps:
|
|
|
|
1. Unpack your distribution file.
|
|
|
|
You will have downloaded a file named something like php4xn.tar.gz.
|
|
Unzip this file with a command like: gunzip php4xn.tar.gz
|
|
|
|
Next you have to untar it with: tar -xvf php4xn.tar
|
|
|
|
This will create a php-4.0.x directory. cd into this new directory.
|
|
|
|
2. Configure PHP.
|
|
|
|
You now have to choose the options you would like. There are quite
|
|
a few of them. To see a list, type: ./configure --help
|
|
|
|
You can also use the supplied 'setup' script, which will ask you
|
|
a series of questions and automatically run the configure script
|
|
for you.
|
|
|
|
The only options that you are likely to want to use are the ones in
|
|
the last section entitled, "--enable and --with options recognized:"
|
|
|
|
A popular choice is to build the Apache module version. You need
|
|
to know where the source code directory for your Apache server is
|
|
located. Then use an option like: --with-apache=/usr/local/src/apache
|
|
if that is your Apache source code directory. If you only specify
|
|
--with-apache, then it will default to look for your Apache source
|
|
in /usr/local/etc/httpd.
|
|
|
|
NOTE: The directory you specify should be the top-level of the
|
|
unpacked Apache (or Stronghold) distribution. The configure program
|
|
will automatically look for httpd.h in different directories under that
|
|
location depending on which version of Apache, including Stronghold,
|
|
you are running.
|
|
|
|
For MySQL support, since newer versions of MySQL installs its various
|
|
components under /usr/local, this is the default. If you have
|
|
changed the location you can specify it with: --with-mysql=/opt/local
|
|
for example. Otherwise just use: --with-mysql
|
|
|
|
*NOTE* If you are using Apache 1.3b6 or later, you should run the
|
|
Apache Configure script at least once before compiling PHP. It
|
|
doesn't matter how you have Apache configured at this point.
|
|
|
|
3. Compile and install the files. Simply type: make install
|
|
|
|
For the Apache module version this will copy the appropriate files
|
|
to the src/modules/php4 directory in your Apache distribution if
|
|
you are using Apache 1.3.x. If you are still running Apache 1.2.x
|
|
these files will be copied directly to the main src directory.
|
|
|
|
For Apache 1.3b6 and later, you can use the new APACI configuration
|
|
mechanism. To automatically build Apache with PHP support, use:
|
|
|
|
cd apache_1.3.x
|
|
./configure --prefix=/<path>/apache \
|
|
--activate-module=src/modules/php4/libphp4.a
|
|
make
|
|
make install
|
|
|
|
If you do not wish to use this new configuration tool, the old
|
|
install procedure (src/Configure) will work fine.
|
|
|
|
If you are using the old Apache ./Configure script, you will have to
|
|
edit the Apache src/Configuration file manually. If you do not have
|
|
this file, copy Configuration.tmpl to Configuration.
|
|
|
|
For Apache 1.3.x add:
|
|
|
|
AddModule modules/php4/libphp4.a
|
|
|
|
For Apache 1.3.x don't do anything else. Just add this line and then
|
|
run "./Configure" followed by "make".
|
|
|
|
For Apache 1.2.x add:
|
|
|
|
Module php4_module mod_php4.o
|
|
|
|
For Apache 1.2.x you will also have to look in the libphp4.module file,
|
|
which was copied to the src directory. The EXTRA_LIBS line in the Apache
|
|
Configuration file needs to be set to use the same libs as specified on
|
|
the LIBS line in libphp4.module. You also need to make sure to add
|
|
"-L." to the beginning of the EXTRA_LIBS line.
|
|
|
|
So, as an example, your EXTRA_LIBS line might look like:
|
|
|
|
EXTRA_LIBS=-L. -lphp4 -lgdbm -ldb -L/usr/local/mysql/lib -lmysqlclient
|
|
|
|
NOTE: You should not enclose the EXTRA_LIBS line in double-quotes, as it
|
|
is in the libphp4.module file.
|
|
|
|
Also, look at the RULE_WANTHSREGEX setting in the libphp4.module file
|
|
and set the WANTHSREGEX directive accordingly in your Configuration file.
|
|
This last step applies to versions of Apache prior to 1.3b3.
|
|
|
|
This is a bit of a hassle, but should serve as incentive to move to
|
|
Apache 1.3.x where this step has been eliminated.
|
|
|
|
Once you are satisfied with your Configuration settings, type: ./Configure
|
|
If you get errors, chances are that you forgot a library or made a typo
|
|
somewhere. Re-edit Configuration and try again. If it goes well,
|
|
type: make
|
|
|
|
4. Setting up the server.
|
|
|
|
You should now have a new httpd binary. Shut down your existing server,
|
|
if you have one, and copy this new binary overtop of it. Perhaps make
|
|
a backup of your previous one first. Then edit your conf/srm.conf file
|
|
and add the line:
|
|
|
|
AddType application/x-httpd-php .php
|
|
|
|
There is also an interesting feature which can be quite instructive and
|
|
helpful while debugging. That is the option of having colour syntax
|
|
highlighting. To enable this, add the following line:
|
|
|
|
AddType application/x-httpd-php-source .phps
|
|
|
|
Any file ending in .phps will now be displayed with full colour syntax
|
|
highlighting instead of being executed.
|
|
|
|
When you are finished making changes to your srm.conf file, you can
|
|
start up your server.
|
|
|
|
USING PHP3 AND PHP4 AS CONCURRENT APACHE MODULES
|
|
|
|
Recent operating systems provide the ability to perform versioning and
|
|
scoping. This features make it possible to let PHP3 and PHP4 run as
|
|
concurrent modules in one Apache server.
|
|
|
|
This feature is known to work on the following platforms:
|
|
|
|
- Linux with recent binutils (binutils 2.9.1.0.25 tested)
|
|
- Solaris 2.5 or better
|
|
- FreeBSD (3.2, 4.0 tested)
|
|
|
|
To enable it, configure PHP3 and PHP4 to use APXS (--with-apxs) and the
|
|
necessary link extensions (--enable-versioning). Otherwise, all standard
|
|
installations instructions apply. For example:
|
|
|
|
$ ./configure \
|
|
--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
|
|
|