Configure PASE FastCGI Support for PHP Processing

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 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/zendsvr6/bin/php-cgi.bin" StartProcesses="1" SetEnv="LIBPATH=/usr/local/zendsvr6/lib" SetEnv="PHPRC=/usr/local/zendsvr6/etc/" SetEnv="PHP_FCGI_CHILDREN=5" SetEnv="PHP_FCGI_MAX_REQUESTS=0" ConnectionTimeout="30" RequestTimeout="60" SetEnv="CCSID=819" SetEnv="LANG=C" SetEnv="INSTALLATION_UID=100313092601" setEnv=="LDR_CNTRL=MAXDATA=0x40000000"

SetEnv=="ZEND_TMPDIR=/usr/local/zendsvr6/tmp SetEnv="TZ=<EST>-5"

Note:

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

Line 1: Parameter Information
Parameter Name	Description	Recommended Value
Server type	Needs to match the MIME type specified on directive AddType in file httpd.conf.
CommandLine	PASE FastCGI program name
StartProcesses	Monitor/Start PASE FastCGI worker jobsJobs contain information about a specific Job (script to run) that you have set to run in your environment.	“1”
SetEnv	Sets an environment variable
PHP_FCGI_CHILDREN	Number of FastCGI worker jobs
PHP_FCGI_MAX_REQUESTS	Number request before worker job recycles	0 never recycle or a large number to avoid job start/stop
Optional: SetEnv Lang/CCSID	Control FastCGI Lang/CCSID	Specify both or none. These settings will override the FastCGI Language default line.
Lang	FastCGI language	en_US
CCSID	FastCGI CCSID	819 (or 1208)
ConnectionTimeout	Number of seconds before web server receives timeout
RequestTimeout	Number of seconds before running PHP script receives timeout

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 2: Parameter Information
Parameter Name	Description	Recommended Value
IpcDir	Is used to create the FastCGI sockets file. Note the specified directory must be file read/write capable by the Web server.

 

Line 3 (optional):

Language LANG=en_US CCSID=819

Note:

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

Line 3: Parameter Information
Parameter Name	Description	Recommended Value
Language	Default language and CCSID for all servers
LANG	FastCGI default language	C
CCSID	FastCGI default CCSID	819 or 1208

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 Setup menu or PHP Restart button in the Zend Server Administration interface.

Note:

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