---
title: "Return PHP handlers"
method: GET
path: "/php_get_handlers"
tags: ["PHP"]
---

# Return PHP handlers

`GET /php_get_handlers`

This function returns the PHP handlers on the system.

**Important:**

When you disable the
[Web Server role](https://docs.cpanel.net/knowledge-base/general-systems-administration/how-to-use-server-profiles/#roles),
the system **disables** this function.

## Query parameters

- `version` string

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `version_handlers` object[] — An array of objects containing the available PHP handlers.
      - `available_handlers` string[] — The installed PHP handlers. * `suphp` * `cgi` * `dso` * `none`
      - `current_handler` 'suphp' | 'cgi' | 'dso' | 'none' — The PHP version's handler. * `suphp` * `cgi` * `dso` * `none`
      - `version` string — An installed PHP version. * `ea-php54` * `ea-php55` * `ea-php56` * `ea-php70` * `ea-php71` * `ea-php72` * `inherit` * Any custom PHP package name. **Important:** We deprecated PHP 5.6 and PHP 7.0 and will remove them in a future version. For more information, read our [cPanel Deprecation Plan](https://docs.cpanel.net/knowledge-base/cpanel-product/cpanel-deprecation-plan/) documentation.
  - `metadata` object
    - `command` string — The method name called.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 1 | 0 — * `1` — Success. * `0` — Failed. Check the `reason` field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)