PHP modes
In ISPmanager you can enable PHP-scripts for a website. To do so, enable the PHP option and enter its parameters when creating or editing a WWW-domain. Learn more under Add a website.
Supported PHP modes:
- for the Apache web server:
- Apache module;
- CGI;
- FastCGI (Apache);
- for the Nginx web server:
FastCGI (Nginx + PHP-FPM);
- for the OpenLiteSpeed web server:
- LSAPI.
For more information about PHP settings in different modes please refer to the article PHP settings.
Apache module
Peculiarities:
- dynamic content is handled by the PHP module of the Apache web-server;
- PHP parameters are set globally for all WWW-domains of the users with this mode. Only an administrator can modify the settings in Web-server settings → PHP → Extended settings;
- you can select only one PHP version that will be applied to all ISPmanager users;
- a fast mode. However, the fastest one is "FastCGI (Nginx + PHP-FPM)".
Perform the following operations to activate the module:
- Install Apache-MPM-ITK or Apache MPM-Prefork, the PHP module. Learn more under Set up a web-server .
- Go to Accounts → Users → Edit enable the option PHP as Apache module.
- Select the mode when creating or editing the WWW-domain. Learn more under Add a website.
The Apache configuration file of the WWW-domain:
Apache configuration file
<FilesMatch "\.ph(p[3-5]?|tml)$">
SetHandler application/x-httpd-php
</FilesMatch>
<FilesMatch "\.phps$">
SetHandler application/x-httpd-php-source
</FilesMatch>
<IfModule php5_module>
php_admin_value sendmail_path "/usr/sbin/sendmail -t -i -f <administrator email>"
php_admin_value upload_tmp_dir "/var/www/www-root/data/mod-tmp"
php_admin_value session.save_path "/var/www/www-root/data/mod-tmp"
php_admin_value open_basedir "/var/www/www-root/data:."
</IfModule>
<IfModule php7_module>
php_admin_value sendmail_path "/usr/sbin/sendmail -t -i -f <administrator email>"
php_admin_value upload_tmp_dir "/var/www/www-root/data/mod-tmp"
php_admin_value session.save_path "/var/www/www-root/data/mod-tmp"
php_admin_value open_basedir "/var/www/www-root/data:."
</IfModule>
<IfModule php5_module>
php_admin_flag engine on
</IfModule>
<IfModule php7_module>
php_admin_flag engine on
</IfModule>
CGI
Peculiarities:
- dynamic content is handled by Apache as CGI;
for PHP version 5.5 and above, the settings are specified individually for each website. They can be changed by the user in Domains → WWW domains → select the domain → Website management → PHP settings → select the PHP version → Extended settings;
- for PHP versions below 5.5, the settings are specified for the entire server. You can change them in the Settings → PHP settings section;
- you can select a PHP version for every WWW-domain that uses this mode;
- the slowest mode.
Perform the following operations to activate the module:
- Install Apache-MPM-ITK or Apache MPM-Prefork, the PHP module. Learn more under Web-server configuration.
- Go to Accounts → Users → Edit enable the option PHP as CGI.
- Select the mode when creating or editing the WWW-domain. Learn more under Add a website.
The Apache configuration file of the WWW-domain:
Apache configuration file
<FilesMatch "\.ph(p[3-5]?|tml)$">
SetHandler application/x-httpd-php5
</FilesMatch>
ScriptAlias /php-bin/ /var/www/php-bin-isp-php52/<WWW-domain owner>/
AddHandler application/x-httpd-php5 .php .php3 .php4 .php5 .phtml
Action application/x-httpd-php5 /php-bin/php
FastCGI (Apache)
Peculiarities:
- dynamic content is handled by Apache as FastCGI;
PHP settings are specified individually for each website. They can be changed by the user in Domains → WWW domains → select the domain → Website management → PHP settings → select the PHP version → Extended settings;
- you can select a PHP version for every WWW-domain that uses this mode;
- a faster mode that "CGI', but slower than "Apache module" and"FastCGI (Nginx + PHP-FPM)".
Perform the following operations to activate the module:
- Install Apache MPM-Prefork and the PHP module. Learn more under Set up a web-server .
- Go to Accounts → Users → Edit enable the option PHP as FastCGI (Apache).
- Select the mode when creating or editing the WWW-domain. Learn more under Add a website.
The Apache configuration file of the WWW-domain:
Apache configuration file
<FilesMatch "\.ph(p[3-5]?|tml)$">
SetHandler fcgid-script
FCGIWrapper /var/www/php-bin/<WWW-domain owner>/php
</FilesMatch>
Options +ExecCGI
FastCGI (Nginx + PHP-FPM)
Peculiarities:
- dynamic content is handled by PHP-FPM;
PHP settings are specified individually for each website. They can be changed by the user in Domains → WWW domains → select the domain → Website management → PHP settings → select the PHP version → Extended settings;
- PHP-FPM doesn't support .htaccess rules;
- the fastest mode.
Perform the following operations to use the module:
- Install Nginx, PHP-FPM FastCGI. Learn more under Install a web-server.
- Go to Accounts → Users → Edit enable the option PHP as FastCGI (Nginx + PHP-FPM).
- Select the mode when creating or editing the WWW-domain. Learn more under Add a website.
To change PHP version:
- under user’s account, enter WWW → PHP;
- under admin’s account, go to user editing form.
The Nginx configuration file of the WWW-domain:
Nginx configuration file
location @php {
fastcgi_index index.php;
fastcgi_param PHP_ADMIN_VALUE "sendmail_path = /usr/sbin/sendmail -t -i -f <administrator email>";
fastcgi_pass unix:/var/www/php-fpm/www-root.sock;
fastcgi_split_path_info ^((?U).+\.ph(?:p\d*|tml))(/?.+)$;
try_files $uri =404;
include fastcgi_params;
LSAPI
Peculiarities:
- dynamic content is handled by the LSAPI module of the OpenLiteSpeed web-server;
- PHP parameters are set for every website and user. A user can modify the settings in WWW → PHP → Extended settings;
- you can select any PHP version from the list of installed alternative versions for every WWW-domain that uses this mode. The native PHP version is used for the module itself;
- a faster mode that "Apache module", "CGI", and "FastCGI (Apache)" , but slower than "FastCGI (Nginx + PHP-FPM)".
Perform the following operations to activate the module:
- Install the OpenLiteSpeed server. Learn more under Install a web-server.
- Go to Users → Edit and enable the option Can use PHP as LSAPI mode.
- Select the mode when creating or editing the WWW-domain. Learn more under Add a website.