PHP agent release notesRSS

New Relic PHP Agent v10.3.0.315

Important end-of-life information

• Support for 32 bit and FreeBSD binaries were deprecated with release v9.19.0.309 and are no longer shipped starting with this release.

• Support for ZTS binaries was deprecated with release v9.17.0.300 and will be removed in a release in the near future.

• For installations using an unsupported PHP version or platform (32 bit, FreeBSD, ZTS, etc), it is highly recommended to 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. Alternatively, the PHP agent packages can be version pinned to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed, removing support for the required, unsupported features. This would disrupt APM data collection.
  The PHP agent packages which are affected are:

  • newrelic-php5
  • newrelic-php5-common
  • newrelic-daemon

• The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.

New features

• APM logs in context. Automatic application log forwarding is now enabled by default. This version of the agent will automatically send enriched application logs to New Relic. To learn more about this feature see PHP: Configure logs in context, and additional configuration options are available PHP agent configuration: Config file. To learn about how to toggle log ingestion on or off by account see Disable automatic logging. #556

Bug fixes

• agent: Fix to ensure datastore segments do not create children segments. #511
• agent: Updates instrumentation lookups for PHP 7.4+. Using reserved field of zend_func's op_array is no longer reliable as other extensions are unreliably using this shared area which then corrupts the opcache enough that it no longer provides lookups. The new method no longer relies on the agent storing any information in the reserved array of a zend_function. Fixes: Laravel 9 PHP8.1 Not reporting errors, All transactions are "unknown" bug

New Relic PHP Agent v10.2.0.314

New Features

• newrelic-daemon: Informational messages will be logged if the number of connected applications falls below 25 or exceeds 200. #534

Bug Fixes

• agent: Fixed SIGSEGV in Drupal 7 drupal_http_request instrumentation for PHP 7.4, 8.0 and 8.1. #538
• agent: Fixed displaying newrelic.application_logging*.enabled value in PHP info output. #535
• agent: When forwarding application logs, send the log message as a well-formed JSON string that is correctly escaped. #540
• agent: Reduce the severity of a log message when an agent does not detect environmental variables. #539

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.

New features

• APM logs in context support for Monolog 2 and 3

  • The PHP agent will now generate logging metrics for Monolog (versions 2 and 3) to allow seeing the rate of log messages by severity.
  • These metrics are enabled by default and are controlled by a config file directive.
  • The PHP agent can also now forward log messages from Monolog for viewing on the New Relic platform.
  • Log forwarding is currently disabled by default (can be enabled by a config file directive), and will be enabled by default in a future release.

  To learn more about APM logs in context, see the logs in context docs.

  For more information about logs in context and the PHP agent check the PHP logs in context docs.

• Enhanced redis/PhpRedis support Thank you to Michael Grunder for contributing to the PHP agent and extending the existing redis/PhpRedis support!

New contributors

• As mentioned above, community member Michael Grunder made his first contribution to the New Relic PHP agent. Thanks!!!

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 please consult the following document.

New features

• The agent now incorporates updated backend communications which will pave the way to efficiently add new features.
• Agent tags are now supported by the PHP agent.

Bug fixes

• Infinite tracing is now disabled at startup if distributed tracing is disabled since it is required (Issue 452).
• Removed a debugging statement that was no longer needed and could lead to large log file usage if verbose debugging was enabled (Issue 447).
• Additional fixes to significantly reduce the number of duplicated log messages in some situations where large log consumption had been observed in the past.

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 please consult the following document.

New Relic PHP agent v9.21.0

New features

• Distributed Tracing is now turned on by default.
• Distributed Tracing span reservoir size now has a default of 2000 (up from 1000) and a maximum of 10000.
• Cross Application Tracing is deprecated.

Bug fixes

• Fixed an install script bug where it detects Alpine Linux as Debian when phpize dependencies are installed.
• Improved stability of using Laravel framework when using opcache with PHP 8.1.

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 please consult the following document.

New Relic PHP agent v9.20.0

New features

• AWS instance metadata service (IMDS) feature now allows AWS IMDSv2 by @robertprast.

New Contributors

• @robertprast made their first contribution. Thanks!!

End of Life Notices

• Support for the Centos 6 / RHEL6 operating systems are deprecated and will be removed by June 2022.

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 please consult the following document.

New Relic PHP Agent v9.19.0

New Features

• Added support for 64-bit PHP 8.1! (#177). Compatibility note: Support for PHP 8.1 does not include Fibers.

Bug Fixes

• Fixed Symfony 5 auto detect (#113, #256). Thank you @piotrantosik for your contribution!
• Fixed URL of New Relic for PHP docs website used in error messages (#334)
• Fixed URL of New Relic of PHP docs website in README (#254). Thank you @revilon1991 for your contribution!

End of Life Notices

• 32-bit support for PHP versions 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4 is deprecated and will be removed by June 2022.
• Support for FreeBSD operating system is deprecated and will be removed by June 2022.
• This will be the last release in which ZTS builds are supported. In the future, ZTS builds may not be provided and support may be completely pulled from the codebase.

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.

New Relic PHP agent v9.18.1

New features

• Added a Docker development environment. It's now possible for contributors to both develop and test (unit tests and integration tests) without setting up a specific environment on their own system. Please see our documentation for more information.
• Route caching in Laravel 7.x is now supported!. Transaction naming now works with routes cached via php artisan route:cache. @stockalexander, thanks for your contribution!
• Redis::mget and Redis::mset functions are now supported. @b-viguier, thanks for your contribution!

Bug fixes

• Fixed instances where a memory leak was occurring with our curl multi instrumentation.
• Fixed an issue where a supportability metric used to track an edge case was causing a segfault.
• Fixed an issue where PHP versions with an unknown API version were incorrectly handled during Debian package install.
• Fixed instances where parent.transportDuration values are 0 for transactions between two PHP applications instrumented through distributed tracing. @b-viguier, thanks for your contribution!
• Fixed an issue where the newrelic.ini configuration file was incorrectly installed. @b-viguier, thanks for your contribution!

Support statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.

New Relic PHP Agent v9.17.1

Bug Fixes

• Fixed instances where the agent's mysqli_commit instrumentation returned a NULL instead of a boolean.
• Fixed an issue where parameters were not passed by reference in the agent's pdo instrumentation. This caused a warning in PHP 8.
• Fixed instances where an Unknown PHP version: 8.0 error was occurring when installing on Debian and Ubuntu systems.

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.