Configure PASE FastCGI Support for PHP Processing

In this Topic ShowHide

The following two files are used to configure PASE FastCGI support for PHP processing on IBM HTTP Server on i:

1. IBM HTTP Server (powered by Apache) instance configuration file (httpd.conf)
2. A FastCGI configuration file (fastcgi.conf)

Both configuration files need to exist in the same configuration directory as your IBM HTTP Server instance configuration file.

For example:

/www/myserver/conf/httpd.conf

/www/myserver/conf/fastcgi.conf

Edit your IBM HTTP Server Instance Configuration File

To edit your IBM HTTP Server instance configuration file using the IBM Web Administration of i GUI Graphical user interface using the following steps:

1. Bring up the IBM Web Administration for i GUI on port 2001 using a web browser.
2. Sign in using a valid IBM i profile and password.
3. Click the Manage tab.
4. Click the HTTP Servers sub-tab.
5. Select your IBM HTTP Server instance from the Server drop down list.
6. Expand Tools.
7. Click Edit Configuration File
8. Add the following PASE FastCGI program (module):
   LoadModule zend_enabler_module /QSYS.LIB/QHTTPSVR.LIB/QZFAST.SRVPGM
9. Associate the .php file extension with the application/x-httpd-php MIME type AddType application/x-httpd-php .php
10. Specify the fastcgi-script handler for PHP
    AddHandler fastcgi-script .php (for all files within the directive scope with a .php extension)
    -or-
    SetHandler fastcgi-script(for all files within the directive scope)
11. Click Apply.
12. Click OK.

Create the FastCGI Configuration

To create the FastCGI configuration file using an editor of your choosing. Here is how to create it using Qshell:

For example:

QSYS/QSH CMD('/usr/bin/touch -C 819 /www/myserver/conf/fastcgi.conf')

Note:

The fastcgi.conf file needs to be in CCSID 819 (ASCII).

Edit the FastCGI Configuration File

To edit the FastCGI configuration file so it contains only two lines as follows:

Line 1:

Server type="application/x-httpd-php" CommandLine="/usr/local/ZendSvr/bin/php-cgi.bin" StartProcesses="1" SetEnv="LIBPATH=/usr/local/ZendSvr/lib" SetEnv="PHPRC=/usr/local/ZendSvr/etc/" SetEnv="PHP_FCGI_CHILDREN=5" SetEnv="PHP_FCGI_MAX_REQUESTS=0" ConnectionTimeout="30" RequestTimeout="60" SetEnv="CCSID=819" SetEnv="LANG=en_US" SetEnv="INSTALLATION_UID=20100314091923195088"

Note:

This must all be on a single line within file fastcgi.conf.
You may have multiple servers, one per line.

For additional language codes see National Language Support.

Line 2:

IpcDir /www/<server instance>/logs

where <server instance> is your server instance name

Note:

This IpcDir line must all be on a single line within file fastcgi.conf.

Line 3 (optional):

Language LANG=en_US CCSID=819

Note:

This must all be on a single line within file fastcgi.conf.

For additional language codes see National Language Support.

Restart Your IBM HTTP Server Instance

To restart your IBM HTTP Server instance using either start/stop Apache option in Zend Server for IBM i Setup menu or PHP Restart button in the Zend Server for IBM i Administration interface.

Note:

It is possible to use IBM commands to restart your IBM HTTP Server instance using either the ENDTCPSVR/STRTCPSVR commands or the IBM Web Administration for IBM i