Before You Begin
Before attempting to install the PHP Agent:
- Confirm that you use a supported
PHP version. You can check your PHP version using this
command:
php -i
- The PHP Agent does not work with PHP applications that are built with the
enable-debug
configuration option or in any build otherwise compiled with debugging symbols. To determine whether the application was built with debugging symbols, you can use this command:php -i | grep -e "Debug Build"
The response should be:
Debug Build => no
- You can get the PHP Agent distribution from the Splunk AppDynamics Download Portal. Be sure to get the distribution
file appropriate for your system:
- For RedHat or CentOS, use the RPM Package Manager distribution, such as PHP Agent—64-bit RPM
- For MacOS, use PHP Agent—64-bit OSX
-
For Alpine Linux, use PHP Agent Alpine Linux - 64-bit
- For Windows Server 2019, use the distribution identified PHP Agent—64-bit Windows
- For all other Linux distributions, use the distribution identified PHP Agent—64-bit Linux
- At installation time, provide Controller connection settings and identifying information for this PHP node. The Getting Started Wizard walks you through this configuration, so if it is your first time installing an Splunk AppDynamics Agent, we recommend using the Getting Started Wizard. For general information about the Controller connection settings, see Agent-to-Controller Connections.
- To complete the instrumentation, stop and start the Apache Server. Ensure that you perform
the installation in a way that minimizes disruption to service users, if applicable.Note: Do not install the PHP Agent along with other non-Splunk AppDynamics Application Performance Management (APM) tools, especially in a production environment. The PHP Agent installation may fail if there are other APM products installed in the same managed environment.
-
(For Alpine Linux) Before you install the PHP Agent:
- Add the
libstdc++
library:apk add libstdc++
- Add the
session
andsockets
PHP extensions:For example, if you are using PHP 8.2, then install the
php82-session
andphp82-sockets
extensions:apk add php82-session php82-sockets
- Add the