PHP agent installation: Non-standard PHP (advanced)

If you are using a non-standard PHP installation, follow this procedure to properly install New Relic. This is common in instances where the default installer does not find your PHP installation (for example, if you have self-compiled PHP or a self-contained PHP stack).

Requirements

Use the command line version of PHP (php -i) or look at the output of phpinfo() to determine:

• The PHP extension version (20090626, 20100525, 20121212, 20131226, 20151012, or 20160303)
• The extension or module installation directory
• Whether or not your version of PHP has been compiled with ZTS (Zend Thread Safety) support

ZTS options apply only to PHP agent versions 9.17 and earlier. ZTS is not available for PHP versions 9.18 or higher.

Use the command line newrelic-install script (recommended)

1. Point New Relic at the right directory by using any of these options:

   Add your PHP location to your PATH

   The install script needs to be able to find your command line php or php-config. You can add the directory that contains those programs to your current PATH.

   Set the NR_INSTALL_PATH

   This can be a colon-separated list of directories for PHP installations in addition to those in your PATH. Make sure these directories contain php or php-config. For example:

   bash

   Copy

   $
   NR_INSTALL_PATH=/u/php/5.3/bin; export NR_INSTALL_PATH
   $
   newrelic-install

   Set the NR_INSTALL_PHPLIST

   Optional: Use a colon-separated list to set the exact locations (directories) where to search. This option will ignore PATH and NR_INSTALL_PATH. For example:

   bash

   Copy

   $
   NR_INSTALL_PHPLIST=/usr/local/bin:u/php/5.3/bin; export NR_INSTALL_PHPLIST
   $
   newrelic-install

2. Invoke the newrelic-install script from its directory. Depending on your server and your paths, the install script may find other versions of PHP on your system. Select your specific version from the list.

For more information, see PHP install script.

Install New Relic manually

If you do not want to use the install script, you can perform a fully manual installation. Be sure to gather information about your PHP installation. You can review and obtain the appropriate values from your phpinfo(). Then create and link or copy the files into place manually.

Get installation parameters from phpinfo()

If this process doesn't work for you, you can get the correct information from your phpinfo() and pass the appropriate settings to your system as environment variables.

Use this information to execute the following commands to install the PHP module. Be sure to adjust the example's values to your actual settings.

$
NRBASEDIR=/usr/lib/newrelic-php5; export NRBASEDIR
$
    MODULEDIR=/usr/lib/php/modules; export MODULEDIR
$
    ARCH=x64; export ARCH
$
    PHPAPI=20090626; export PHPAPI
$
    PHPZTS="-zts"; export PHPZTS
$
    rm -f $MODULEDIR/newrelic.so
$
    ln -s $NRBASEDIR/agent/$ARCH/newrelic-${PHPAPI}${PHPZTS}.so \
>
      $MODULEDIR/newrelic.so

Manual configuration

The next step is configuration.

1. Copy the $NRBASEDIR/scripts/newrelic.ini.template to the directory from where your PHP installation reads additional config files and rename it newrelic.ini.

   To determine the destination, look at your phpinfo() output for the item, called Scan this dir for additional .ini files. If the directory listed is (none), add settings from this file to your listed PHP config files (usually php.ini).

2. Replace the license key setting in your newrelic.ini file with your license key. Also change any other sessions as needed (for example, newrelic.appname).

3. Copy $NRBASEDIR/daemon/newrelic-daemon.$architecture to /usr/bin/newrelic-daemon.

   Depending on your system, $architecture will be either x86 or x64.

4. Restart your dispatcher/web server.

5. Verify that your site is functioning properly. If it isn't, remove newrelic.ini or the newrelic.so you created, and restart your dispatcher/web server again to restore the old operation.

6. Examine your web server/dispatcher logfiles (not newrelic) to help determine the issue. If you still need assistance, get support at support.newrelic.com.

Verify installation

Check that the agent is installed after the restart, by investigating the phpinfo() page for a newrelic section. If it appears the agent was successfully installed, check your system to verify that two newrelic-daemon processes are running:

• For RedHat based systems:

  bash

  Copy

  $
  ps -aef | grep newrelic-daemon

• For Debian based systems:

  bash

  Copy

  $
  ps aux | grep newrelic-daemon

Generate some traffic on your app, then wait for three to five minutes for results to arrive in your APM Summary page.