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
Agent PHP New Relic v12.1.0.26
Nouvelles fonctionnalités
- Ajouter des contrôles d'échantillonnage basés sur la décision d'échantillonnage de tracew3c en amont - #1104
- Voir les nouvelles valeurs ini ici
- Ajouter une option de configuration pour ignorer l'instrumentation des gestionnaires d'exceptions du framework - #1113
- Voir la nouvelle valeur ini ici
Sécurité
- Mise à jour de la version Golang à 1.25.1
Débogage
- Correction d'une fuite de mémoire potentielle lors de l'appel de
newrelic_end_transaction(true)- #1072 - N'essayez aucune instrumentation lorsque vous n'enregistrez pas - #1112
Déclaration de soutien
La prise en charge de l'agent PHP pour les versions de bibliothèque/framework suivantes prendra fin le 30 septembre 2025 :
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
New Relic vous recommande de mettre à niveau l'agent régulièrement et au moins tous les 3 mois. Pour plus d'informations sur les versions d'agent prises en charge et les délais de fin de vie, consultez notre politique de fin de vie de l'agent PHP New Relic.
La page de compatibilité de l'agent et des exigences PHP doit être consultée pour obtenir les dernières informations sur les versions et la plate-forme PHP prises en charge.
Important
Pour les installations utilisant une version ou une plateforme PHP non prise en charge, il est fortement recommandé de désactiver les mécanismes de mise à jour automatique du package de l'agent PHP. Cela peut être fait en ajoutant le package d'agent PHP à une liste d'exclusion pour les mises à niveau package . Ou vous pouvez épingler la version du package d'agent PHP sur une version d'agent qui prend en charge les anciennes fonctionnalités non prises en charge. Le fait de ne pas empêcher les mises à niveau peut entraîner l'installation d'une nouvelle sortie d'agent et la suppression de la prise en charge de la fonctionnalité requise et non prise en charge. Cela perturberait la collecte de données APM.
Les packages d'agents PHP concernés sont :
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
Agent PHP New Relic v12.0.0.25
Débogage
- Améliorer le logging des erreurs de la carte des hooks Drupal.
- Corriger les problèmes de détection package legacy pour Security RX.
Avis
La valeur par défaut de newrelic.code_level_metrics.enabled INI a changé dans cette sortie
Comme indiqué précédemment, le niveau d'observabilité du code par défaut dans configuration de l'IDE passera d'activé à désactivé dans cette sortie. Si vous n'utilisez pas le niveau du code Métriques, vous ne devriez voir aucun impact et n'aurez aucune action à entreprendre. Si vous vous fiez aux métriques de niveau de code, assurez-vous que votre fichier configuration newrelic.ini a le paramètre INI newrelic.code_level_metrics.enabled non commenté et défini sur true. par exemple :
newrelic.code_level_metrics.enabled = trueCette modification n’affecte que la valeur de configuration par défaut. Les valeurs de configuration définies manuellement seront respectées et le comportement principal de CLM restera inchangé.
Déclaration de soutien
Comme indiqué précédemment, le framework/bibliothèque suivant, pour lequel l'agent PHP avait précédemment mis fin à son support, sera supprimé dans cette sortie :
- Guzzle 3.x
- Kohana
- Silex
- Symfony 1.x-3.x
- Zend 1.x-2.x
La prise en charge de l'agent PHP pour les versions de bibliothèque/framework suivantes prendra fin le 30 septembre 2025 :
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
New Relic vous recommande de mettre à niveau l'agent régulièrement et au moins tous les 3 mois. Pour plus d'informations sur les versions d'agent prises en charge et les délais de fin de vie, consultez notre politique de fin de vie de l'agent PHP New Relic.
La page de compatibilité de l'agent et des exigences PHP doit être consultée pour obtenir les dernières informations sur les versions et la plate-forme PHP prises en charge.
Important
Pour les installations utilisant une version ou une plateforme PHP non prise en charge, il est fortement recommandé de désactiver les mécanismes de mise à jour automatique du package de l'agent PHP. Cela peut être fait en ajoutant le package d'agent PHP à une liste d'exclusion pour les mises à niveau package . Ou vous pouvez épingler la version du package d'agent PHP sur une version d'agent qui prend en charge les anciennes fonctionnalités non prises en charge. Le fait de ne pas empêcher les mises à niveau peut entraîner l'installation d'une nouvelle sortie d'agent et la suppression de la prise en charge de la fonctionnalité requise et non prise en charge. Cela perturberait la collecte de données APM.
Les packages d'agents PHP concernés sont :
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
Agent PHP New Relic v11.10.0.24
Nouvelles fonctionnalités
- Security RX: l'API d'exécution de Composer sera utilisée par défaut pour détecter les packages utilisés par les applications PHP #1055
Mises à jour de sécurité
- #1089 - sécurité (daemon) : mise à niveau de golang vers la version 1.24.4 #1090
- #973 - sécurité : rotation de la clé publique de New Relic utilisée pour vérifier la signature de http://apt.newrelic.com/debian/ Référentiel APT. Voir ici pour plus de détails.
Débogage
- fix(agent) : corrige un comportement indéfini lorsque l'API d'exécution de Composer est utilisée #1086
Avis
Valeur par défaut pour newrelic.code_level_metrics.enabled modifications INI lors de la prochaine sortie
La configuration par défaut du niveau du code Métriques changera dans une prochaine sortie d'activé à désactivé. Si vous n'utilisez pas le niveau du code Métriques, vous ne devriez voir aucun impact et n'aurez aucune action à entreprendre. Si vous vous fiez aux métriques de niveau de code, assurez-vous que votre fichier configuration newrelic.ini a le paramètre INI newrelic.code_level_metrics.enabled non commenté et défini sur true. par exemple :
newrelic.code_level_metrics.enabled = trueCette modification n’affecte que la valeur de configuration par défaut. Les valeurs de configuration définies manuellement seront respectées et le comportement principal de CLM restera inchangé.
Déclaration de soutien
Le framework/bibliothèque suivant, pour lequel l'agent PHP a précédemment mis fin à son support, sera supprimé lors de la prochaine sortie :
- Guzzle 3.x
- Kohana
- Silex
- Symfony 1.x-3.x
- Zend 1.x-2.x
La prise en charge de l'agent PHP pour les versions de bibliothèque/framework suivantes prendra fin le 30 septembre 2025 :
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
New Relic vous recommande de mettre à niveau l'agent régulièrement et au moins tous les 3 mois. Pour plus d'informations sur les versions d'agent prises en charge et les délais de fin de vie, consultez notre politique de fin de vie de l'agent PHP New Relic.
La page de compatibilité de l'agent et des exigences PHP doit être consultée pour obtenir les dernières informations sur les versions et la plate-forme PHP prises en charge.
Important
Pour les installations utilisant une version ou une plateforme PHP non prise en charge, il est fortement recommandé de désactiver les mécanismes de mise à jour automatique du package de l'agent PHP. Cela peut être fait en ajoutant le package d'agent PHP à une liste d'exclusion pour les mises à niveau package . Ou vous pouvez épingler la version du package d'agent PHP sur une version d'agent qui prend en charge les anciennes fonctionnalités non prises en charge. Le fait de ne pas empêcher les mises à niveau peut entraîner l'installation d'une nouvelle sortie d'agent et la suppression de la prise en charge de la fonctionnalité requise et non prise en charge. Cela perturberait la collecte de données APM.
Les packages d'agents PHP concernés sont :
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
Agent PHP New Relic v11.9.0.23
Nouvelles fonctionnalités
- feat(agent) : Ajout de l'auto-instrumentation des implémentations de hooks orientés objet introduites dans Drupal 11.1
Autre
- refactoring(agent) : améliorer les performances de l'instrumentation des fonctions utilisateur pour PHP 8.0+
Avis
La configuration par défaut de Code Level Metrics changera dans une prochaine sortie d'activé à désactivé. Si vous n'utilisez pas le niveau du code Métriques, vous ne devriez voir aucun impact et n'aurez aucune action à entreprendre. Si vous vous fiez aux Code Level Metrics, assurez-vous que votre fichier configuration newrelic.ini a le paramètre INI newrelic.code_level_metrics.enabled non commenté et défini sur true. par exemple : newrelic.code_level_metrics.enabled = true Cette modification n’affecte que la valeur de configuration par défaut. Les valeurs de configuration définies manuellement seront respectées et le comportement principal de CLM restera inchangé.
Déclaration de soutien
- New Relic vous recommande de mettre à niveau l'agent régulièrement et au moins tous les 3 mois. Pour plus d'informations sur les versions d'agent prises en charge et les délais de fin de vie, consultez notre politique de fin de vie de l'agent PHP New Relic.
- La page de compatibilité de l'agent et des exigences PHP doit être consultée pour obtenir les dernières informations sur les versions et la plate-forme PHP prises en charge.
Important
Pour les installations utilisant une version ou une plateforme PHP non prise en charge, il est fortement recommandé de désactiver les mécanismes de mise à jour automatique du package de l'agent PHP. Cela peut être fait en ajoutant le package d'agent PHP à une liste d'exclusion pour les mises à niveau package . Ou vous pouvez épingler la version du package d'agent PHP sur une version d'agent qui prend en charge les anciennes fonctionnalités non prises en charge. Le fait de ne pas empêcher les mises à niveau peut entraîner l'installation d'une nouvelle sortie d'agent et la suppression de la prise en charge de la fonctionnalité requise et non prise en charge. Cela perturberait la collecte de données APM.
Les packages d'agents PHP concernés sont :
- 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