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.
Important
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.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.
Important
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
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 = trueThis 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.
Important
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.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 = trueThis 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.
Important
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.
Important
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.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.
Important
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.7.0.21
New features
- feat(agent): Adds label forwarding to log events
- feat(agent): Add AWS Lambda Relationship
Security
- security(daemon): bump golang.org/x/net from 0.33.0 to 0.36.0
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.
Important
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.6.0.19
New features
- Added support for aws-sdk-php SQS version 3 instrumentation
- Added support for php-amqplib version 3.7 RabbitMQ instrumentation
- Added support for Yii version 1.1 instrumentation
- The agent will now generate MessageBroker metrics and attributes
Security
- Daemon Golang version upgraded to 1.23.6
Bug fixes
- Fixed daemon to enable
go vetcheck on pull requests - Fixed memory leak in Laravel Queue Instrumentation
- Fixed nr_header_create_distributed_trace_map memory leak
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.
Important
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.5.0.18
New feature
- Adds support for PHP 8.4
Bug Fixes
- Fix Drupal error and exception handling
- 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 error where externalCallCount should be added to the transaction and not just the error event.
- Address aws-sdk-php versioning change.
Security
- Daemon golang.org/x/net module upgraded to v0.33.0
Support statement
- New Relic recommends that you upgrade the agent regularly and at a minimum every three 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.
Important
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.4.0.17
New feature
- Added support for CakePHP framework versions 4.x and 5.x.
Support statement
- New Relic recommends that you upgrade the agent regularly and at a minimum every three 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.
Important
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