ISPmanager 5 Lite Documentation

PHP modes

This is documentation for an outdated product. See the current documentation

 

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 WWW-domain.

Supported PHP modes:

  • Apache module;
  • CGI;
  • FastCGI (Apache);
  • FastCGI (Nginx + PHP-FPM).

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 → 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:

  1. Install Apache-MPM-ITK or Apache MPM-Prefork, the PHP module. Learn more under Set up a web-server .
  2. Go to Accounts  → Users  → Edit enable the option PHP as Apache module.
  3. Select the mode when creating or editing the WWW-domain. Learn more under Add a WWW-domain.

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;
  • PHP parameters are set for every user. A user can modify the settings in WWW → PHP → Settings;
  • 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:

  1. Install Apache-MPM-ITK or Apache MPM-Prefork, the PHP module. Learn more under Web-server configuration.
  2. Go to Accounts  → Users  → Edit enable the option PHP as CGI.
  3. Select the mode when creating or editing the WWW-domain. Learn more under Add a WWW-domain.

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 parameters are set for every user. A user can modify the settings in WWW → PHP → 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:

  1. Install Apache MPM-Prefork and the PHP module. Learn more under Set up a web-server .
  2. Go to Accounts  → Users  → Edit enable the option PHP as  FastCGI (Apache).
  3. Select the mode when creating or editing the WWW-domain. Learn more under Add a WWW-domain.

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 parameters are set for every user. A user can modify the settings in WWW → PHP → Settings;
  • PHP-FPM doesn't support .htaccess rules;
  • the fastest mode. 

Perform the following operations to use the module:

  1. Install Nginx, PHP-FPM FastCGI. Learn more under Install a web-server.
  2. Go to Accounts  → Users  → Edit enable the option PHP as FastCGI (Nginx + PHP-FPM).
  3. Select the mode when creating or editing the WWW-domain. Learn more under Add a WWW-domain
  4. 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;