• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Compatibilité PHP deagent et exigences

Avant d' installer l'agent PHP, assurez-vous que votre système répond aux exigences de version répertoriées ci-dessous.

Compatibilité desagentPHP

Version PHP

Version de l'agent

Actuellement pris en charge

8.4

11.5.0.18

Oui

8.3

10.15.0.4

Oui

8.2

Toutes les versions d'agent prises en charge

Oui

8.1

Toutes les versions d'agent prises en charge

Oui

8.0

Toutes les versions d'agent prises en charge

Oui

7.4

Toutes les versions d'agent prises en charge

Oui

7.3

Toutes les versions d'agent prises en charge

Oui

7.2

Toutes les versions d'agent prises en charge

Oui

7.1

10.21.0.11

Non

7.0

10.21.0.11

Non

Consultez les notes de sortie deagent PHP pour la dernière sortie agent PHP.

Pour une liste à jour de toutes les sorties d'agent PHP actuellement prises en charge, consultez la politique EOL de l'agent PHP.

Si vous utilisez une version ou une plateforme PHP non prise en charge (comme un système d'exploitation 32 bits, FreeBSD ou des versions ZTS), nous vous recommandons de désactiver les mécanismes de mise à jour automatique pour le package PHP agent . Si vous ne parvenez pas à empêcher les mises à niveau automatiques, cela pourrait entraîner l’installation accidentelle d’une version plus récente de l’agent. La version la plus récente peut ne plus prendre en charge les fonctionnalités critiques essentielles à la collecte de données APM, ce qui entraînera des perturbations dans les capacités monitoring .

Pour désactiver la mise à jour automatique, vous avez deux options :

  • Ajoutez le package PHP agent à une liste d'exclusion pour les mises à niveau package, ou

  • Épinglez la version du agent PHP package sur une agent version qui prend en charge les anciennes fonctionnalités non prises en charge. Les packages agent PHP concernés sont :

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

Sécurité des threads Zend

Les builds PHP compilées avec Zend Thread Safety (ZTS) ne sont pas prises en charge.

Compilation juste à temps (JIT)

La compilation juste-à-temps est prise en charge à partir de agent la version 10.18.0.8 de . PHP désactive automatiquement JIT pour toutes les versions antérieures de l'agent PHP.

Fibres

Les fibres ne sont pas prises en charge.

Autorisations

Installation de l'agent PHP requires accès root à :

  • Accès en lecture/écriture au répertoire des extensions PHP.
  • Accès en lecture/écriture aux données de configuration PHP, soit dans le répertoire de configuration PHP (préféré), soit dans php.ini.
  • Redémarrez le serveur Web ou le pool de processus PHP.

Exécution de l'agent does not require accès root. L'agent a besoin d'un accès en lecture/écriture aux fichiers suivants (l'emplacement de ces fichiers peut être personnalisé dans les paramètres de l'agent PHP) :

clé de licence

Votre New Relic est une chaîne hexadécimale de 40 caractères que New Relic fournit lorsque vous créez votre compte. Pour plus d'informations, consultez le script d'installation PHP ou les paramètres de clé de licence dans le fichier PHP ini .

Processeur

Les architectures de processeur suivantes sont prises en charge :

  • x86_64 (également connu sous le nom d'amd64)
  • aarch64 (également connu sous le nom d'ARM64)

Important

La prise en charge d'aarch64 (ARM64) n'est disponible que sur PHP 8.0+.

système d'exploitation

Lorsque les fournisseurs annoncent la fin de vie (comme sur la page Fin du support standard d'Ubuntu), nous continuerons à prendre en charge ces dernières versions pendant un an après la date de fin de vie du fournisseur. Cependant, si la version PHP que vous utilisez n'est plus officiellement prise en charge, le support pourrait prendre fin avant un an.

C'est pourquoi nous vous recommandons de toujours utiliser la dernière version du système d'exploitation officiellement prise en charge par le fournisseur. Les dernières versions de notre agent peuvent fonctionner sur des versions de système d'exploitation dont la fin de vie est dépassée, mais nous ne testons plus ni ne prenons officiellement en charge l'agent PHP avec les anciennes versions.

Sur la base des informations ci-dessus, l' agent PHP peut être installé sur le système d'exploitation en utilisant les méthodes d'installation répertoriées dans le tableau ci-dessous.

système d'exploitation

sortie

architecturedu processeur

Méthode d'installation

Linux Alpine

3.15, 3.16, 3.17, 3.18, 3.19, 3.20

x86_64, aarch64

fichier tar

Amazon Linux

2

x86_64

fichier tar, RPM

Amazon Linux

2

aarch64

fichier tar

Amazon Linux

2023

x86_64, aarch64

fichier tar

CentOS Linux

7

x86_64

fichier tar, RPM

CentOS Linux

7

aarch64

fichier tar

Flux CentOS

8, 9

x86_64

fichier tar, RPM

Flux CentOS

8, 9

aarch64

fichier tar

RedHat Enterprise Linux

7, 8, 9

x86_64

fichier tar, RPM

RedHat Enterprise Linux

7, 8, 9

aarch64

fichier tar

Debian

10, 11, 12

x86_64

fichier tar, DEB

Debian

10, 11, 12

aarch64

fichier tar

Ubuntu

20, 22, 24

x86_64

fichier tar, DEB

Ubuntu

20, 22, 24

aarch64

fichier tar

Toute distribution Linux avec :

N/A

x86_64, aarch64

fichier tar

Serveurs Web

Les serveurs Web suivants sont pris en charge :

  • Apache 2.2 ou 2.4 via mod_php
  • Tout serveur Web prenant en charge FastCGI à l'aide de PHP-FPM

cadre

Les frameworks suivants sont pris en charge :

Framework

Version

Considérations

CakePHP

4.x, 5.x

Drupal

7.x, 8.x, 9.x, 10.x, 11.0

Fonctionnalités spécifiques à Drupal
instrumentationdu navigateur Drupal

Joomla

≤ 3,7

avec la version de l'agent ≤

10.22.0.12

Laminas

3.x

Laravel

6.x, 7.x, 8.x, 9.x, 10.x, 11.x

Laravel Horizon n'est pas pris en charge.

Lumen

6.x, 7.x, 8.x, 9.x, 10.x

Magento

2.x (CE et EE)

MediaWiki

1.31+

Slim

2.x, 3.x, 4.x

Symfony

4.x, 5.x, 6.x, 7.x

Wordpress

5.9+

Fonctionnalités spécifiques à Wordpress

Oui

1.1, 2.0

Cadre Zend

3.x

Si vous souhaitez suggérer du support pour d'autres frameworks PHP populaires, visitez le forum de support et créez un Feature Idea. Pour plus d'informations, consultez Framework PHP : Intégration du support pour New Relic.

base de données et bibliothèque

Les bases de données et bibliothèques suivantes sont prises en charge :

Firebird (pilote PDO uniquement)

PHPUnit

Guzzle

Pilotes PDO

Informix

PostgreSQL

Memcached

Prédis

MongoDB

RabbitMQ (bibliothèque php-amqplib 3.7 uniquement)

Microsoft SQL Server (pilote PDO uniquement)

Redis

MySQL

SQLite

ODBC (pilote PDO uniquement)

SQS (bibliothèque aws-sdk-php 3 uniquement)

Oracle

Sybase (pilote PDO uniquement)

Autres logiciels monitoring tiers

Si votre application utilise un logiciel monitoring supplémentaire, nous ne pouvons pas garantir que notre agent fonctionnera correctement et ne pouvons pas offrir de support technique. Pour plus d'informations, consultez Erreurs lors de l'utilisation d'autres logiciels monitoring .

Détails de l'instance

New Relic collecte les détailsinstance pour une variété de bases de données et de pilotes de bases de données. Les bases de données et extensions suivantes sont prises en charge :

Pour désactiver la collecte des informations sur l'hôte, configurez l'un des éléments suivants dans le fichier newrelic.ini :

  • Désactiver les rapports d'instance avec newrelic.datastore_tracer.instance_reporting.enabled = false
  • Omettez le nom de la base de données avec newrelic.datastore_tracer.database_name_reporting.enabled = false

Pour demander des informations au niveau de l'instance à partir de magasins de données actuellement non répertoriés pour votre agent PHP, obtenez de l'aide sur support.newrelic.com.

File d'attente des messages

Les éléments suivants prennent en charge la mise en file d'attente des messages :

  • HTTP
  • La mise en file d'attente Laravel

    Important

    Laravel Horizon n'est pas pris en charge.

Exigences de sécurité

En tant que mesure de sécurité standard pour la collecte de données, votre serveur d'applications doit prendre en charge SHA-2 (256 bits). SHA-1 n'est pas pris en charge.

Prise en charge des fonctionnalités New Relic

L' agent PHP s'intègre à d'autres fonctionnalités New Relic pour vous offrir une visibilité de bout en bout :

Produit

intégration

Monitoring de navigateurs

L' agent PHP injecte automatiquement le code JS de l' agent de navigateur lorsque vous activez auto-instrumentation. Après avoir activé injection du navigateur, vous pouvez afficher les données dans la page RésuméAPM et basculer rapidement entre l' APM et les données du navigateur pour une application particulière. Pour les options configuration et instrumentation manuelle, voir monitoring des navigateurs et l' agent PHP.

CodeStream (niveau de code métrique)

New Relic CodeStream apporte l'observabilité dans l'IDE pour montrer comment votre code fonctionne en production au niveau de la méthode.

Les versions PHP 7.0 - 7.4 et 8.0 - 8.3 rapportent le niveau du code métriques (à partir de la sortie 10.4.0).

Monitoring de l'infrastructure

Lorsque vous installez l' infrastructure et l'agent APM sur le même hôte, ils se détectent automatiquement. Vous pouvez ensuite afficher une liste d'hôtes dans l'UI APM et filtrer vos hôtes par APM application dans l'UI infrastructure. Pour plus d'informations, voir les données APM dans monitoring d'infrastructure.

Les logs en contexte

L' agent PHP supporte nos fonctionnalités de logs en contexte pour la bibliothèque Monolog 2 et 3.

New Relic Dashboards

L' agent PHP envoie l'événement et l'attribut par défaut pour la requête NRQL . Vous pouvez également enregistrer un événement personnalisé pour une analyse avancée.

Monitoring synthétique

Synthétique trace de transaction connecte requests du moniteur Synthétique à la transaction APM sous-jacente.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.