Releases: newrelic/newrelic-php-agent
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
New Relic PHP Agent v11.9.0.23
New features
- feat(agent): Add auto-instrumentation of object oriented hook implementations introduced in Drupal 11.1
Other
- refactor(agent): Improve performance of user functions instrumentation for PHPs 8.0+
Notice
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
-
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
Release 11.8.0.22
New Relic PHP agent v11.8.0.22
New features
- feat(agent): Add AWS DynamoDB Instrumentation
Security
- security(daemon): bump golang to 1.24.2
- security(daemon): bump golang.org/x/net from 0.36.0 to 0.38.0
Notice
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
- 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
Release 11.7.0.21
New Relic PHP agent v11.7.0.21
New features
- feat(agent): Adds label forwarding to log events by @mfulb in #1027
- feat(agent): Add AWS Lambda Relationship by @ZNeumann in #1023
Security
- security(daemon): bump golang.org/x/net from 0.33.0 to 0.36.0 by @dependabot in #1034
Support statement
- 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 PHP 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
Release 11.6.0.19
New Relic PHP agent v11.6.0.19
New features
- Added support for aws-sdk-php SQS version 3 instrumentation by @zsistla in #1003
- Added support for php-amqplib version 3.7 RabbitMQ instrumentation by @zsistla in #1009
- Added support for Yii version 1.1 instrumentation
- The agent will now generate MessageBroker metrics and attributes by @zsistla in #991
Security
Bug fixes
- Fixed daemon to enable
go vetcheck on pull requests by @lavarou in #1005 - Fixed memory leak in Laravel Queue Instrumentation by @zsistla in #1014
- Fixed nr_header_create_distributed_trace_map memory leak by @zsistla in #1017
Support statement
- 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
Release 11.5.0.18
New Relic PHP agent v11.5.0.18
New features
Bug Fixes
- fix(agent): fix Drupal error and exception handling by @bduranleau-nr in #995
- This fix may conflict with the error and exception handling of the Drupal new_relic_rpm module. If you have this module installed and you aren't seeing your errors reported natively by the agent, try disabling the new_relic_rpm module. If you still experience issues after disabling this module, please reach out to New Relic Support.
- fix(axiom): externalCallCount should be added to the txn not just the error by @zsistla in #1006
- fix(agent): address the aws-sdk-php versioning change by @zsistla in #1001
Security
Support statement
- 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
Release 11.4.0.17
New Relic PHP agent v11.4.0.17
New features
Support statement
- 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 PHP 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
