Skip to content

Commit

Permalink
feat(release-notes/php-agent): 10.20.0 Release Notes
Browse files Browse the repository at this point in the history
Draft of PHP Agent 10.20.0 Release Notes
  • Loading branch information
lavarou committed Apr 30, 2024
1 parent 2c1be51 commit 60862c6
Showing 1 changed file with 43 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
subject: PHP agent
releaseDate: '2024-04-30'
version: 10.20.0.10
downloadLink: 'https://download.newrelic.com/php_agent/archive/10.20.0.10'
features: ['Add support for Yii v2', 'Add supportability metrics for PHP package', 'Update default for `newrelic.framework.wordpress.hooks.options`']
bugs: ['Fix error reporting for errors converted by PHP to exceptions', 'Improve user exception handler instrumentation for PHPs 8.0+', 'Fix warning from mysqli', 'Fix json struct tag for docker id', 'Improve communications of PHP packages data to the backend']
security: ['Bump google.golang.org/protobuf from 1.32.0 to 1.33.0', 'Bump golang.org/x/net from 0.20.0 to 0.23.0']
---
## New Relic PHP agent v10.20.0.10

### New features
* Add support for Yii v2 framework
* Add supportability metrics for PHP packages that provide major version
* Update default for `newrelic.framework.wordpress.hooks.options` to `"plugin_callbacks"`

### Bug fixes
* Fix error reporting for errors converted by PHP to exceptions
* Improve user exception handler instrumentation for PHPs 8.0+
* Fix warning from mysqli when explaining slow SQL queries
* Fix json struct tag for docker id
* Improve communications of PHP packages data to the backend

### Security
* Bump google.golang.org/protobuf from 1.32.0 to 1.33.0 in `newrelic-daemon`
* Bump golang.org/x/net from 0.20.0 to 0.23.0 in `newrelic-daemon`

### Important end-of-life information

* Support for PHP versions 7.0 and 7.1 will **EOL** on June 1st, 2024

### 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](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/php-agent-eol-policy/).
* The [PHP agent compatibility and requirements](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements/) page should be consulted for the latest information on supported PHP versions and platforms.

<Callout variant="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
</Callout>

0 comments on commit 60862c6

Please sign in to comment.