To take full advantage of New Relic's latest features, enhancements, and important security patches, we recommend you update your PHP agent to the latest version. For additional information about specific agent updates, refer to the PHP agent release notes.
This document explains how to update the agent for:
- RedHat and CentOS
- Ubuntu and Debian
To update via tar archive, follow the tar archive installation procedures. (Procedures to install and update with the tar archive are the same.)
The package name for the New Relic for PHP agent is
Although the name references PHP 5, this package works for all supported PHP versions, including PHP 7 versions.
To update the PHP agent:
Replace the agent files using your preferred package manager for your system:
RedHat or CentOS: Run the
newrelic-installscript, and follow the install script's confirmation prompt before overwriting an old installation.sudo newrelic-install install
Ubuntu or Debian: Follow the package manager's prompts to run the
newrelic-installscript as part of its installation process.
Stop any residual
newrelic-daemonprocesses by runningkill $(pgrep newrelic-daemon)
newrelic-daemonis configured to start in external mode, use your operating system's service manager to restart it.
Restart your web server (Apache, Nginx, PHP-FPM, etc.).
Wait a few minutes for your application to send data to New Relic.
If you are updating from an older agent version, including major version jumps, review the following list for changes in functionality.
Release notes: PHP agent 18.104.22.168
TLS replaces the
To increase security, the
Release notes: PHP agent 22.214.171.124
PHP 5.2 is no longer supported.
New Relic highly encourages you to use a supported version of PHP (5.6 or higher). If you want to continue running the New Relic PHP agent with PHP 5.2, we recommend using agent version 6.9. However, in this case, we can only offer limited support.
Release notes: PHP agent 126.96.36.199
Daemon command line flags have been renamed.
For customers who start the daemon manually, you can find the newly renamed command line flags with the
If you updated PHP and the agent stopped working or reporting data, follow the troubleshooting procedures.
If you need more help, check out these support and learning resources:
- Suggest a change and learn how to contribute to our PHP agent open source repository.
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.