Requirements

The packages below are necessary for the compilation and installation of php. You probably have most packages allready installed. Most packages can be obtained from www.sunfreeware.com.

* flex-2_5_4a-sol26-sparc-local
* gcc-2_95_2-sol26-sparc-local
* gzip-1.2.4-sol26-sparc-local
* perl-5_005_03-sol26-sparc-local
* bison-1_25-sol26-sparc-local
* make-3_76_1-sol26-sparc-local
* m4-1_4-sol26-sparc-local
* autoconf-2.13
* automake-1.4
* tar-1.13 (GNU tar)

For this tutourial you also need MySQL and Sablotron installed. The MySQL version I have used is 3.23.27-beta-sun-solaris2.7-sparc which you can obtain from www.mysql.com. The Sablotron is the binary distribution of version 0.44. Download it from www.gingerall.com. I will leave the installation of these packages to you since it is not the focus of the article.

Unpack php

Unpack php and go into the directory created.

gunzip php-4.0.4.tar.gz
tar -c php-4.0.4.tar
cd php-4.0.4

Preparing to compile

MySQL is installed in /usr/mysql and Sablotron in /usr/local. Netscape iPlanet Web Server (NES) is installed in the directory /data/nesdir/nes4.1/. The default installation directory for php is /usr/local
which normally is sufficient. (You can force it to install somewhere else with the prefix switch, for example: –prefix=/usr/www) . To configure php enter the following command (all on one line):

./configure --with-nsapi=/data/nesdir/nes4.1/ --with-mysql=/usr/mysql --with-sablot=/usr/local

Compiling

Before compiling we need to do some editing of the source. Php 4.0.4 have a bug regarding it’s use as a NSAPI module. The bug number is 7286. This is now fixed in CVS though. This will not be an issue the next release (current is 4.0.4). The workaround is to add a line to the file php_config.h. This file you will find in the directory php-4.0.4/main. Add the line below anywhere in the file.

#define HAVE_IEEEFP_H

Finally we can compile the php.

make && make install

Configuring iPlanet

For iPlanet to load and use php to parse php pages we need to do three separate things. First we need to make sure the web server find all the libaries it needs in order to load php. Then we need to add the php mime-type. Third we edit the configuration of the web server. The last step will make sure the web server loads the php module, initialises it and creaes a binding between the php mime type and the php module. In this example I have a server instance named myserver. All the relevant files then resides in /data/nesdir/nes4.1/https-myserver/.

All this is also described in a readme file that comes with the php distribution. This file is found in the directory php-4.0.4/sapi/nsapi/.

Include path for libraries We need to tell iPlanet where to look for shared libraries. This can be done by altering the environment variable LD_LIBRARY_PATH for the user the web server is run under. But it is easier to do in the start script by changing the variable LD_LIBRARY_PATH there. In our example, /data/nesdir/nes4.1/https-myserver/start

In our case we want to add /usr/local/lib to the path. Example (one line):

LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib: ${LD_LIBRARY_PATH}:/usr/local/lib;

And then export it:

export LD_LIBRARY_PATH

Add the mime-type

All that is left now is to configure the web server to load php and hand over php files. This is done in the file /data/nesdir/nes4.1/https-myserver/config/obj.conf. These two lines are to be added after mime types init. First line (one line):

Init fn="load-modules"
funcs="php4_init,php4_close,php4_execute,php4_auth_trans"
shlib="/usr/local/lib/libphp4.so"

Directly after that you write:

Init fn=php4_init errorString="Failed to initialize PHP!"

After that we will tell the Netscape Server to forward php files to the php-parser. This is done in the “default” object further down in the obj.conf file. The following line should be written after all ObjectType definitions and before all the AddLog definitions.

<object>
ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
Service fn=php4_execute
</object>

That’s it! Restart the server and hopefully you will have a working NSAPI installation of PHP.

Optional authenticaton

This step is not necessary for it to work but anyway, you might need it. PHP authentication cannot be used with any other authentication. All authentication is passed to the php script. To configure PHP Authentication for the entire server you add the following line in the default object definition:

AuthTrans fn=php4_auth_trans

However if you want to use PHP authentication on a signle directory you create a new directory like this:

<object phpath="/data/docs/php/*">
AuthTrans fn=php4_auth_trans
</object>

More bugs.

There is another bug that, no 7163 which you might encounter. Aki Hakkila developed this further in a mail to the php dev list. It seems that the web server never check to see that a php file really exists before handing the path over to php. This is not a big deal but you might run into it.

If you use software virtual servers you might encounter the same strange errors when including files. Aki provided a suggested solution for both of these issues. I’ll update this article when I’ve tested them.