Your data. Anywhere you go.

New Relic for iOS or Android


Download on the App Store    Android App on Google play


New Relic Insights App for iOS


Download on the App Store


Learn more

Close icon

Relic Solution: PHP Agent Manual Install


#1

The New Relic PHP Agent installer attempts to automatically detect your PHP installations and add the correct files to the correct locations for each. But with PHP, non-standard installations can be standard and sometimes the installer can’t figure out all the unique ways PHP can be configured. In these cases, a manual install may be best.

Note, you should first try running the installer with the NR_INSTALL_PATH environment variable set to a path or paths that include your PHP binaries:

https://docs.newrelic.com/docs/agents/php-agent/advanced-installation/using-newrelic-install-script#install-multiple

If that also fails you can install the agent manually with the below steps.

Manual Installation

  1. If this is a web application, create a phpinfo() page to gather your PHP configuration. This can be different than your command line php -i
  1. Download the tarball installer from http://download.newrelic.com/php_agent/release/ and unpack it.
  1. Find your PHP “extension_dir”. This will be where to copy the newrelic.so.

  2. Find your PHP Extension number. This will determine the version of the newrelic.so to copy and look like 20151012 or some other date.

  3. Make a note if Thread Safety is enabled or disabled.

  4. Copy the newrelic-myversion.so if Thread Safety is disabled or newrelic-myversion-zts.so if Thread Safety is enabled to your extension_dir. Something like this:

cp newrelic-php5-*-linux/agent/x64/newrelic-20151012.so /usr/lib64/php/modules/newrelic.so

  1. Find your “Additional ini directory” in your phpinfo

  2. Copy the the newrelic.ini.template to your Additional ini directory. Something like this:

cp newrelic-php5-*-linux/scripts/newrelic.ini.template /etc/php.d/newrelic.ini

  1. Edit the newrelic.ini you’ve created to add your license key and appname

  2. Copy the daemon to the default daemon location:

cp newrelic-php5-*-linux/daemon/newrelic-daemon.x64 /usr/bin/
mv /usr/bin/newrelic-daemon.x64 /usr/bin/newrelic-daemon

That’s it! Your manual install is complete.


Why package newrelic-php5 depends on python