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:

    1. Add the libstdc++ library:
      apk add libstdc++
    2. Add the session and sockets PHP extensions:

      For example, if you are using PHP 8.2, then install the php82-session and php82-sockets extensions:

      apk add php82-session php82-sockets