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
Agente New Relic PHP v12.1.0.26
Novo recurso
- Adicionar controles de amostragem com base na decisão de amostragem de trace w3c upstream - #1104
- Veja os novos valores ini aqui
- Adicionada opção de configuração para pular instrumentação de manipuladores de exceções framework - #1113
- Veja o novo valor ini aqui
Segurança
- Aumente a versão do golang para 1.25.1
Correções de bugs
- Corrigir possível vazamento de memória ao chamar
newrelic_end_transaction(true)- #1072 - Não tente usar nenhuma instrumentação quando não estiver gravando - #1112
Declaração de apoio
O suporte do agente PHP para as seguintes versões de biblioteca/framework terminará em 30 de setembro de 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
A New Relic recomenda que você atualize o agente regularmente e, no mínimo, a cada 3 meses. Para obter mais informações sobre versões de agentes suportadas e cronogramas de fim de vida útil, confira nossa política de fim de vida útil do PHP do agenteNew Relic .
A página de compatibilidade do agente e requisitos do PHP deve ser consultada para obter as informações mais recentes sobre as versões e plataformas suportadas do PHP.
Important
Para instalação usando uma versão ou plataforma PHP não suportada, é altamente recomendável que você desabilite os mecanismos de atualização automática para os pacotes PHP do agente. Isso pode ser feito adicionando os pacotes do agente PHP a uma lista de exclusão para atualizações de pacotes. Ou você pode fazer o versionamento do pacote PHP do agente para uma versão do agente que suporte os recursos antigos e sem suporte. A falha em impedir atualizações pode resultar na instalação de uma versão mais recente do agente e na remoção do suporte para o recurso necessário e não suportado. Isso interromperia a coleta de dados do APM.
Os pacotes do agente PHP afetados são:
- newrelic-php5
- newrelic-php5-common
- daemon-newrelic
Agente New Relic PHP v12.0.0.25
Correções de bugs
- Melhore o logging de erros do mapa de hooks do Drupal.
- Corrigir problemas de detecção de pacotes legados para Security RX.
Perceber
O valor padrão para newrelic.code_level_metrics.enabled INI foi alterado nesta versão
Conforme comunicado anteriormente, o nível padrão do código métrico de observabilidade na configuração do IDE será alterado nesta versão de habilitado para desabilitado. Se você não usar o nível do código métrico, não verá nenhum impacto e não precisará tomar nenhuma providência. Se você confiar no nível do código métrica, certifique-se de que seu arquivo de configuração newrelic.ini tenha a configuração newrelic.code_level_metrics.enabled INI descomentada e definida como verdadeira. por exemplo:
newrelic.code_level_metrics.enabled = trueEssa alteração afeta apenas o valor de configuração padrão. Os valores de configuração definidos manualmente serão respeitados e o comportamento principal do CLM permanecerá inalterado.
Declaração de apoio
Conforme comunicado anteriormente, a seguinte estrutura/biblioteca para a qual o agente PHP havia encerrado o suporte será removida nesta versão:
- Guzzle 3.x
- Kohana
- Sílex
- Symfony 1.x-3.x
- Zend 1.x-2.x
O suporte do agente PHP para as seguintes versões de biblioteca/framework terminará em 30 de setembro de 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
A New Relic recomenda que você atualize o agente regularmente e, no mínimo, a cada 3 meses. Para obter mais informações sobre versões de agentes suportadas e cronogramas de fim de vida útil, confira nossa política de fim de vida útil do PHP do agenteNew Relic .
A página de compatibilidade do agente e requisitos do PHP deve ser consultada para obter as informações mais recentes sobre as versões e plataformas suportadas do PHP.
Important
Para instalação usando uma versão ou plataforma PHP não suportada, é altamente recomendável que você desabilite os mecanismos de atualização automática para os pacotes PHP do agente. Isso pode ser feito adicionando os pacotes do agente PHP a uma lista de exclusão para atualizações de pacotes. Ou você pode fazer o versionamento do pacote PHP do agente para uma versão do agente que suporte os recursos antigos e sem suporte. A falha em impedir atualizações pode resultar na instalação de uma versão mais recente do agente e na remoção do suporte para o recurso necessário e não suportado. Isso interromperia a coleta de dados do APM.
Os pacotes do agente PHP afetados são:
- newrelic-php5
- newrelic-php5-common
- daemon-newrelic
Agente New Relic PHP v11.10.0.24
Novo recurso
- Integrações de Agentes: API de tempo de execução do Composer será usada por padrão para detectar pacotes usados pelo aplicativo PHP #1055
Atualizações de segurança
- #1089 - segurança(daemon): atualizar golang para 1.24.4 #1090
- #973 - segurança: rotacionar a chave pública do New Relic usada para verificar a assinatura de http://apt.newrelic.com/debian/ Repositório APT. Veja aqui para mais detalhes.
Correções de bugs
- fix(agente): Corrige comportamento indefinido quando API de tempo de execução do Composer é usada #1086
Perceber
Valor padrão para alterações de newrelic.code_level_metrics.enabled INI na próxima versão
O nível padrão do código métrico de configuração será alterado em uma versão futura de ativado para desativado. Se você não usar o nível do código métrico, não verá nenhum impacto e não precisará tomar nenhuma providência. Se você confiar no nível do código métrico, certifique-se de que seu arquivo de configuração newrelic.ini tenha a configuração INI newrelic.code_level_metrics.enabled descomentada e definida como verdadeira. por exemplo:
newrelic.code_level_metrics.enabled = trueEssa alteração afeta apenas o valor de configuração padrão. Os valores de configuração definidos manualmente serão respeitados e o comportamento principal do CLM permanecerá inalterado.
Declaração de apoio
A seguinte estrutura/biblioteca para a qual o agente PHP já havia encerrado o suporte será removida na próxima versão:
- Guzzle 3.x
- Kohana
- Sílex
- Symfony 1.x-3.x
- Zend 1.x-2.x
O suporte do agente PHP para as seguintes versões de biblioteca/framework terminará em 30 de setembro de 2025:
- WordPress 5.9
- Drupal 8.x
- Laravel 6.x, 8.x
- PHPUnit 8.x
A New Relic recomenda que você atualize o agente regularmente e, no mínimo, a cada 3 meses. Para obter mais informações sobre versões de agentes suportadas e cronogramas de fim de vida útil, confira nossa política de fim de vida útil do PHP do agenteNew Relic .
A página de compatibilidade do agente e requisitos do PHP deve ser consultada para obter as informações mais recentes sobre as versões e plataformas suportadas do PHP.
Important
Para instalação usando uma versão ou plataforma PHP não suportada, é altamente recomendável que você desabilite os mecanismos de atualização automática para os pacotes PHP do agente. Isso pode ser feito adicionando os pacotes do agente PHP a uma lista de exclusão para atualizações de pacotes. Ou você pode fazer o versionamento do pacote PHP do agente para uma versão do agente que suporte os recursos antigos e sem suporte. A falha em impedir atualizações pode resultar na instalação de uma versão mais recente do agente e na remoção do suporte para o recurso necessário e não suportado. Isso interromperia a coleta de dados do APM.
Os pacotes do agente PHP afetados são:
- newrelic-php5
- newrelic-php5-common
- daemon-newrelic
Agente New Relic PHP v11.9.0.23
Novo recurso
- feat(agent): Adicionada instrumentação automática de implementações de hook orientadas a objetos introduzidas no Drupal 11.1
Outro
- refactor(agent): Melhorar o desempenho da instrumentação de funções do usuário para PHPs 8.0+
Perceber
O nível padrão do código métrico de configuração será alterado em uma versão futura de ativado para desativado. Se você não usar o nível do código métrico, não verá nenhum impacto e não precisará tomar nenhuma providência. Se você confiar no nível do código métrico, certifique-se de que seu arquivo de configuração newrelic.ini tenha a configuração INI newrelic.code_level_metrics.enabled descomentada e definida como verdadeira. por exemplo: newrelic.code_level_metrics.enabled = true Esta alteração afeta apenas o valor de configuração padrão. Os valores de configuração definidos manualmente serão respeitados e o comportamento principal do CLM permanecerá inalterado.
Declaração de apoio
- A New Relic recomenda que você atualize o agente regularmente e, no mínimo, a cada 3 meses. Para obter mais informações sobre versões de agentes suportadas e cronogramas de fim de vida útil, confira nossa política de fim de vida útil do PHP do agenteNew Relic .
- A página de compatibilidade do agente e requisitos do PHP deve ser consultada para obter as informações mais recentes sobre as versões e plataformas suportadas do PHP.
Important
Para instalação usando uma versão ou plataforma PHP não suportada, é altamente recomendável que você desabilite os mecanismos de atualização automática para os pacotes PHP do agente. Isso pode ser feito adicionando os pacotes do agente PHP a uma lista de exclusão para atualizações de pacotes. Ou você pode fazer o versionamento do pacote PHP do agente para uma versão do agente que suporte os recursos antigos e sem suporte. A falha em impedir atualizações pode resultar na instalação de uma versão mais recente do agente e na remoção do suporte para o recurso necessário e não suportado. Isso interromperia a coleta de dados do APM.
Os pacotes do agente PHP afetados são:
- newrelic-php5
- newrelic-php5-common
- daemon-newrelic
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