Releases: newrelic/newrelic-php-agent
Release list
New Relic PHP agent v12.8.0.37
New Relic PHP agent v12.8.0.37
New Features
- feat(agent): Add Redis Cluster instrumentation (#1212 / #1206). Resolves #130.
- Thank you @shavounet for your contribution!
Security updates
- security(daemon): upgrade golang to 1.26.4 (#1232)
- chore(deps): Update outdated dependencies (#1241)
Bug Fixes
- chore: Fix realpath buffer overrun in install-util (#1221)
- chore(agent): Avoid stack overflow (#1222)
- fix(daemon): report correct Instance/Reporting count (#1231)
- fix(axiom): mitigate possible snprintf overflow (#1223)
- fix(agent): remove double allocation of request_uri string (#1236)
Support Statement
-
PHP Agent support for the following library & framework versions will be discontinued and New Relic recommends you upgrade to the latest version supported by the vendor:
- Slim 2 support will be discontinued in all PHP Agent Versions after July 31, 2026
- Drupal 7 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Drupal 9 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Laravel 11 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Joomla 3 support will be discontinued in all PHP Agent Versions after September 30, 2026
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
For installations using an unsupported PHP version or platform, it's highly recommended that you disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and the removal of support for the required, unsupported features. This would disrupt APM data collection.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
Contributors
Assets 2
New Relic PHP agent v12.7.0.36
New Relic PHP agent v12.7.0.36
Security updates
Bug Fixes
- Changed log level of transaction truncation fiber messages (#1207). Addresses #1200.
- Ensure unnamed spans are not recorded for infinite tracing (#1197).
- Correct daemon seen/sent metric generation (#1174).
- Allow mysqli parameter binding in execute (#1172).
Support Statement
-
As previously communicated, for best practices and security, the rpm signing key has been rotated and the rpm installation page reflects the up to date changes.
-
PHP Agent support for the following library & framework versions will be discontinued and New Relic recommends you upgrade to the latest version supported by the vendor:
- Drupal 7 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Drupal 9 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Laravel 11 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Joomla 3 support will be discontinued in all PHP Agent Versions after September 30, 2026
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
New Relic PHP agent v12.6.0.34
New Relic PHP agent v12.6.0.34
New Features
- Laravel 13 verified and supported.
- Instrumentation will be disabled per request when PHP Fiber usage is detected. (#1178)
Security updates
Bug Fixes
- Fixed backoff tier when retrying daemon connections (#1169)
- Fixed installing newrelic.ini into mods-available on Debian/Ubuntu (#1170). Addresses (#1168).
- Improved SQL parsing logic (#1164)
Support Statement
-
As previously communicated, for best practices and security, the rpm signing key has been rotated and the rpm installation page reflects the up to date changes.
-
PHP Agent support for the following library & framework versions will be discontinued and New Relic recommends you upgrade to the latest version supported by the vendor:
- Drupal 7 support will be discontinued in all PHP Agent Versions after September 30, 2026
- Drupal 9 support will be discontinued in all PHP Agent Versions after September 30, 2026
-
As previously communicated, the PHP Agent support for the following library & framework versions is discontinued in all PHP Agent releases after February 28th, 2026:
- For the following library & framework versions, New Relic recommends you upgrade to the latest version supported by the vendor:
- Symfony 4.x
- Laravel 7.x, 9.x, 10.x
- Slim 3.x
- Support for the following libraries & frameworks will be discontinued for all versions:
- MediaWiki
- Zend Framework
- Lumen
- For the following library & framework versions, New Relic recommends you upgrade to the latest version supported by the vendor:
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
v12.5.0.30
New Relic PHP agent v12.5.0.30
New Features
- Symfony 8 verified and supported.
- #1147 - agent: update instrumentation to be compatible with MongoDB 2.x (#1154, #1158)
Security
Bug Fixes
- agent: fix table naming for queries with
EXTRACTfunction (#1159) - agent: fix drupal hook implementation (#1157)
Support Statement
-
In an upcoming release, for best practices and security, the rpm signing key will be rotated. Closer to that release, specific dates and necessary actions for rpm users will be provided.
-
PHP Agent support for the following library & framework versions will be discontinued in all PHP Agent releases after February 28th, 2026:
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
- Symfony 4.x
- Laravel 7.x, 9.x, 10.x
- Slim 3.x
- Support for the following libraries & frameworks will be discontinued for all versions:
- MediaWiki
- Zend Framework
- Lumen
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
New Relic PHP agent v12.4.0.29
New Relic PHP agent v12.4.0.29
New Features
- Added PHP 8.5 support
Bug Fixes
- Addressed deprecation warnings which could be seen when using Symfony 7.4 and 8.0
Support Statement
-
In an upcoming release, for best practices and security, the rpm signing key will be rotated. Closer to that release, specific dates and necessary actions for rpm users will be provided.
-
PHP Agent support for the following library & framework versions will be discontinued in all PHP Agent releases after February 28th, 2026:
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
- Symfony 4.x
- Laravel 7.x, 9.x, 10.x
- Slim 3.x
- Support for the following libraries & frameworks will be discontinued for all versions:
- MediaWiki
- Zend Framework
- Lumen
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
New Relic PHP agent v12.3.0.28
New Relic PHP agent v12.3.0.28
New Features
- Add aws-sdk-php Kinesis Data Streams Instrumentation
Security
- Bump golang version to 1.25.5
Bug Fixes
- Fixed issue where daemon did not clear package cache on restart
Support Statement
-
In an upcoming release, for best practices and security, the rpm signing key will be rotated. Closer to that release, specific dates and necessary actions for rpm users will be provided.
-
PHP Agent support for the following library & framework versions will be discontinued in all PHP Agent releases after February 28th, 2026:
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
- Symfony 4.x
- Laravel 7.x, 9.x, 10.x
- Slim 3.x
- Support for the following libraries & frameworks will be discontinued for all versions:
- MediaWiki
- Zend Framework
- Lumen
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
For installations using an unsupported PHP version or platform, it's highly recommended that you disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and the removal of support for the required, unsupported features. This would disrupt APM data collection.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
New Relic PHP agent v12.2.0.27
New Relic PHP agent v12.2.0.27
New Features
- Laravel 12 verified and supported.
- Laravel Horizon is now supported on Laravel 10.x+ and PHP 8.1+.
Security
Bug Fixes
- fix(agent): Fix Laravel queue job exception handling - #1122
Support Statement
-
In an upcoming release, for best practices and security, the rpm signing key will be rotated. Closer to that release, specific dates and necessary actions for rpm users will be provided.
-
As previously announced, PHP Agent support for the following library/framework versions has officially ended as of September 30th, 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit (all versions)
-
PHP Agent support for the following library & framework versions will be discontinued in all PHP Agent releases after February 28th, 2026:
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
- Symfony 4.x
- Laravel 7.x, 9.x, 10.x
- Slim 3.x
- Support for the following libraries & frameworks will be discontinued for all versions:
- MediaWiki
- Zend Framework
- Lumen
- For the following library & framework versions, New Relic recommends you upgrade to the latest supported version:
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
For installations using an unsupported PHP version or platform, it's highly recommended that you disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and the removal of support for the required, unsupported features. This would disrupt APM data collection.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
Full Changelog: v12.1.0.26...v12.2.0.27
New Relic PHP Agent v12.1.0.26
New Relic PHP agent v12.1.0.26
New features
- Add sampling controls based on upstream w3c trace sampling decision - #1104
- See new ini values here
- Add configuration option to skip instrumentation of framework exception handlers - #1113
- See new ini value here
Security
- Bump golang version to 1.25.1
Bug fixes
- Fix potential memleak when calling
newrelic_end_transaction(true)- #1072 - Don't attempt any instrumentation when not recording - #1112
Support statement
-
PHP Agent support for the following library/framework versions will end September 30, 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
For installations using an unsupported PHP version or platform, it's highly recommended that you disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and the removal of support for the required, unsupported features. This would disrupt APM data collection.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
New Relic PHP Agent v12.0.0.25
New Relic PHP agent v12.0.0.25
Bug Fixes
- Improve drupal hook map error logging.
- Fix legacy package detection issues for Security Rx.
Notice
Default value for newrelic.code_level_metrics.enabled INI has changed in this release
As previously communicated, the default Code Level Metrics Observability in IDE configuration will change in an this release from enabled to disabled. If you do not use Code Level Metrics, you should see no impact and will not have to take any action. If you do rely on Code Level Metrics, ensure that your newrelic.ini configuration file has the newrelic.code_level_metrics.enabled INI setting uncommented and set to true.
e.g:
newrelic.code_level_metrics.enabled = true
This change only impacts the default configuration value. Manually set configuration values will be honored, and core CLM behavior will remain unaffected.
Support statement
-
As previously communicated, the following frameworks/libraries that the PHP Agent has previously EOL'd support for will be removed in the this release:
- Guzzle 3.x
- Kohana
- Silex
- Symfony 1.x-3.x
- Zend 1.x-2.x
-
PHP Agent support for the following library/framework versions will end September 30, 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
New Relic PHP Agent v11.10.0.24
New features
- Security RX: Composer runtime API will be used by default to detect packages used by PHP applications (#1055)
Security updates
- #1089 - security(daemon): upgrade golang to 1.24.4 (#1090)
- #973 - security: rotate New Relic's public key used to verify signature of http://apt.newrelic.com/debian/ apt repository. See here for details.
Bug fixes
- fix(agent): Fix undefined behavior when Composer runtime API is used (#1086)
Notice
Default value for newrelic.code_level_metrics.enabled INI changes in next release
The default Code Level Metrics configuration will change in an upcoming release from enabled to disabled. If you do not use Code Level Metrics, you should see no impact and will not have to take any action. If you do rely on Code Level Metrics, ensure that your newrelic.ini configuration file has the newrelic.code_level_metrics.enabled INI setting uncommented and set to true.
e.g:
newrelic.code_level_metrics.enabled = true
This change only impacts the default configuration value. Manually set configuration values will be honored, and core CLM behavior will remain unaffected.
Support statement
-
The following frameworks/libraries that the PHP Agent has previously EOL'd support for will be removed in the next release:
- Guzzle 3.x
- Kohana
- Silex
- Symfony 1.x-3.x
- Zend 1.x-2.x
-
PHP Agent support for the following library/framework versions will end September 30, 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
-
New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines, check out our New Relic PHP Agent EOL policy.
-
The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.
For installations using an unsupported PHP version or platform, it's highly recommended that you disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and the removal of support for the required, unsupported features. This would disrupt APM data collection.
The PHP agent packages that are affected are:
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon