---
title: "PHP APM Troubleshooting Guide"
slug: "php-apm-troubleshooting-guide"
description: "Verify PHP compatibility for Stackify. Check PHP versions (5.4 to 5.6 and 7.0 to 7.3) and extensions. Troubleshoot with step-by-step instructions."
updated: 2024-10-16T18:37:57Z
published: 2024-10-16T18:37:57Z
canonical: "docs.stackify.com/php-apm-troubleshooting-guide"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PHP APM Troubleshooting Guide

## Verify Compatibility

**PHP Version Support**

- Stackify supports PHP versions **5.4 to 5.6**, **7.0 to 7.4**, and **8.0 to 8.3**

**Web Server Support**

- Apache 2 (mod_php)
- Nginx (PHP-FPM)

## Verify Extension Installation

**1.** Create an **info.php** file w/ the following contents:

```
<?php
   phpinfo();
?>
```

**2.** Using a web browser access the info.php page. Search for the **stackify** module.

![2018-08-27 PHP Troubleshooting .png](https://cdn.document360.io/3fcaf473-a1ef-4778-aa2c-fd28411c2b01/Images/Documentation/4aeb3d8a-e752-4d7f-b7c0-22dbd9d37110.png)

**3.** If **stackify** is not shown, restart web server and refresh browser.

**4.** If **stackify** is still not shown, verify that the extensions directory contains **stackify.so** and **Stackify.php**. Extension directory is identified as **extension_dir** in the info.php results.

- 4a. If the extensions directory does not contain the stackify files, a manual linking is required.
- 4b. Symlinks can be used to setup the stackify extension files:

```
sudo ln -s /usr/local/stackify/stackify-php-apm/linux_[32|64]/stackify-[php-version].so [extension_dir]/stackify.so
```

Replace `[32|64]` and `[php-version]` with the values matching your setup. Run `ls -l /usr/local/stackify/stackify-php-apm/linux*` to see all supported versions.

```
sudo ln -s /usr/local/stackify/stackify-php-apm/Stackify.php [extension_dir]/Stackify.php
```

- 4c. Restart web server and refresh the browser view of info.php.

**5.** If **Application Name** and/or **Environment Name** are not shown in the stackify module, verify that the following contents are added to the **php.ini**. Location of php.ini can be found in the info.php property **Loaded Configuration File** (Restart web server and refresh browser).

```
[stackify]
extension=stackify.so
stackify.application_name=Sample Application
stackify.environment_name=Test
```

**6.** Check if **SELinux** is enabled by running `sudo sestatus`. If SELinux is **enabled** and current mode is **enforcing**, temporarily disable to see if SELinux is the cause of the issue `sudo setenforce 0`.

**7.** Review your application's error log for any references to `stackify` - contact Stackify Support with details of the logs.

**8.** Check log directory permissions via `sudo getfacl /usr/local/stackify/stackify-php-apm/log`.

Expected output:

```
# file: usr/local/stackify/stackify-php-apm/log
# owner: stackify
# group: stackify
user::rwx
group::rwx
other::rwx
```

**9.** Check if `open_basedir` is configured. Adjust value to include `/usr/local/stackify/`.

**10.** If you are running **CloudLinux** with **CageFS** enabled, update CageFS permissions to include `/usr/local/stackify`. Add `/usr/local/stackify` to `/etc/cagefs/cagefs.mp` and run `sudo cagefsctl --remount-all`. Full details can be found at [CloudLinux - CageFS](https://docs.cloudlinux.com/cagefs/)

**11.** Ensure that `disable_functions` does **not** include `symlink` in your php configuration.