Adding Custom PHP Versions (Linux)

On Linux systems, you can install any PHP version you need and then make it available in Plesk by registering it with the php_handler command-line utility.

To add the support for an arbitrary PHP version in Plesk:

  1. Install the desired PHP version on your server. For installation guidelines, refer to the official PHP documentation available at In brief, the installation includes the following main steps.

    Warning: These steps are provided for demonstration purposes only. Depending on your operating system and the desired configuration, installation steps can differ significantly. When you install an additional PHP version on your server, read the official PHP documentation on installation.

    1. Log in to your server as root.
    2. Obtain the PHP source you need from the official website ( and unpack it:

      gunzip php-NN.tar.gz

      tar -xf php-NN.tar

    3. Configure and build PHP. This is when you can customize PHP with various options, such as specifying which extensions will be enabled. Run ./configure --helpfor a list of available options.

      cd ../php-NN

      ./configure --prefix /usr/local/phpNN


      make install

    4. Set up your php.ini:

      cp php.ini-development /usr/local/lib/php.ini

      You may edit your .ini file to set PHP options. If you prefer having php.ini in another location, run the configure utility with the option --with-config-file-path=/some/path in step 3.

  2. Register the new PHP version in Plesk:

    /usr/local/psa/bin/php_handler --add -displayname <NN> -path <path to php cgi> -phpini <path to php.ini> -type <php handler> -id <NN-custom>


    • -displayname <NN> is the PHP version name that will be shown in the Plesk UI. We recommend that you include the version number in the displayname, for example, you can name the version "5.3.3-custom".
    • -path <path to php cgi>i is the location of the PHP CGI binary file. You can find this in the output of the command make install in the line Installing PHP CGI binary. For example, if you see the line Installing PHP CGI binary: /usr/local/bin/, the location you need to specify is /usr/local/bin/php-cgi. Learn more at
    • -phpini <path to php.ini> is the location of the php.ini file, for example, /some/path/php.ini .
    • -type <php handler> is the type of the PHP handler associated with this version. Learn more about PHP handlers in the section PHP Handlers.

      Important: You can set either the CGI or FastCGI PHP handler. mod_php is not supported.

    • (Optional) -id <NN-custom> is the identifier that you will use for referring to this PHP version when adjusting or removing it.

After you register the PHP version in Plesk, it will be available for selection in service plan settings (Service Plans > plan name > PHP Settings) and in the PHP settings individual websites (Websites & Domains > PHP Settings). See the picture below.


  • 466 Users Found This Useful
Was this answer helpful?

Related Articles

Automated website copying in Plesk 12

Log in to the Plesk Control Panel Go to the Websites & Domains and click the name of the...

How to set up custom nameservers in Plesk

Once your domain has been created in Plesk you will need to configure the DNS settings for your...

Logging In to Plesk

To log in to Plesk, open your web browser and open the following address:...

Plesk Editions

Starting from Plesk 12, you can choose from four Plesk editions that have features mostly used by...

Plesk Users

Plesk is a web hosting control panel that targets three user groups: Administrators. These...