The php_handler utility is used to register custom PHP handlers, which allow you to use multiple PHP versions and multiple php.ini files in Plesk. For more information, see Multiple PHP Versions in the Administrator’s Guide.

By using the php_handler utility, you can perform the following tasks:

  • changing a certain PHP handler in service plans and subscriptions
  • listing registered PHP handlers in JSON format

Location

%plesk_cli%

Usage 

php_handler.exe <command> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]

Example

The following command enables the custom PHP handler with ID 3.

plesk bin php_handler.exe --enable -id 3

Commands

Command Parameter Description Example
--replace   Replaces a certain PHP handler with another one for all service plans and websites in Plesk.

To replace the PHP handler (id=*123*) with another PHP handler (id=*789*):

plesk bin php_handler.exe --replace -old-id 123 -new-id 789

--enable   Enables the specified PHP handler.

To enable the plesk-php52-cgi PHP handler:

plesk bin php_handler.exe --enable -id plesk-php52-cgi

--disable   Disables the specified PHP handler.

To disable the plesk-php52-cgi PHP handler:

plesk bin php_handler.exe --disable -id plesk-php52-cgi

--get-usage   Displays the usage of the specified PHP handler.

To get the usage of the plesk-php52-cgi PHP handler:

plesk bin php_handler.exe --get-usage -id plesk-php52-cgi

--list   Displays the list of all PHP handlers registered in Plesk.

To view all registered PHP handlers:

plesk bin php_handler.exe --list

--reread   Refreshes information about PHP handlers in Plesk. Use this command after you changed PHP handlers properties not through Plesk.

To refresh information about PHP handlers in Plesk:

plesk bin php_handler.exe --reread

--help or -h   Displays help on the use of the utility.

To view help on the use of the utility:

plesk bin php_handler.exe --help

or

plesk bin php_handler.exe -h

Options

Option Parameter Description Example
-id <handler id> Sets the PHP handler identifier.

To get the usage information for the PHP handler with the ID 5:

plesk bin php_handler.exe --get-usage -id 5

-old-id <old handler id> Specifies the PHP handler you want to replace.

To replace the PHP handler (id=*123*) with another PHP handler (id=*789*):

plesk bin php_handler.exe --replace -old-id 123 -new-id 789

-new-id <new handler id> Specifies the PHP handler with which you want to replace the existing one.  
-json true|false Displays the output in the JSON format.

To display the list of PHP handlers in the JSON format:

plesk bin php_handler.exe --list -json