PHPエージェントの互換性と要件

PHPエージェントをインストールする前に、お使いのシステムがバージョン要件を満たしていることを確認します。

PHPのリリース

次のPHPバージョンがサポートされています。

バージョン	互換性メモ
7.2〜7.4
8.0～8.3	ジャストインタイムコンパイルは、エージェントリリース10.18.0.8以降でサポートされています。PHPは、PHPエージェントの以前のバージョンのJITを自動的に無効にします。 PHP 8.1以降はファイバーをサポートしていません。

バージョン

互換性メモ

7.2〜7.4

8.0～8.3

ジャストインタイムコンパイルは、エージェントリリース10.18.0.8以降でサポートされています。PHPは、PHPエージェントの以前のバージョンのJITを自動的に無効にします。

PHP 8.1以降はファイバーをサポートしていません。

PHPエージェントの互換性

最新のPHPエージェントリリースについては、PHPエージェントリリースノートを参照してください。

Zend Thread Safety（ZTS）でコンパイルされたPHPビルドの場合、PHPエージェント9.19またはそれ以前のみがこれらのビルドをサポートします。
サポートされていないPHPバージョンまたはプラットフォーム（32ビットOS、FreeBSD、ZTSビルドなど）を使用している場合は、PHPエージェントパッケージの自動更新メカニズムを無効にすることをお勧めします。自動更新を阻止しないと、新しいエージェントバージョンが誤ってインストールされることがあります。新しいバージョンでは、APMデータ収集に不可欠な重要な機能がサポートされなくなり、監視機能が中断される可能性があります。
自動更新を無効にするには、次の2つのオプションがあります。
- パッケージアップグレードの除外リストにPHPエージェントパッケージを追加するか、または
- PHPエージェントパッケージを、サポートされていない古い機能をサポートするエージェントバージョンにピン留めすることもできます（複数可）。影響を受けるPHPエージェントパッケージは次のとおりです
  - newrelic-php5
  - newrelic-php5-common
  - newrelic-daemon

アクセス権限

PHPエージェントをインストールするには、以下に対するルートアクセスがrequiresです。

PHP拡張ディレクトリへの読み取り/書き込みアクセス
PHP設定ディレクトリ（推奨）またはphp.iniのPHP設定データへの読み取り/書き込みアクセス
ウェブサーバーまたはPHPプロセスプールを再起動します

エージェントの実行にはルートアクセスはdoes not require。エージェントには、次のファイルへの読み取り/書き込みアクセスが必要です（これらのファイルの場所はPHPエージェント設定でカスタマイズできます）。

ライセンスキー

New Relic は40文字の16進数の文字列で構成され、サインアップ時にNew Relicから提供されます。詳細については、PHPインストールスクリプトまたはPHP iniファイルのライセンスキー設定を参照してください。

プロセッサ

次のプロセッサーがサポートされています。

Intel（および互換）プラットフォーム
ARM64

オペレーティングシステム

ベンダーがサポート終了（Ubuntuの標準サポート終了ページなど）を発表した場合、当社ではこれらの最新バージョンのサポートをベンダーサポート終了日から1年間継続します。ただし、使用しているPHPバージョンが正式にサポートされなくなった場合は、1年未満でサポートが終了する可能性があります。

このため、ベンダーによる正式サポートの最新バージョンのOSを常に使用することをお勧めします。エージェントの最新バージョンは、サポート終了を過ぎたOSバージョンでも動作する可能性がありますが、古いバージョンのPHPエージェントはより長期間にわたってテストまたは正式にサポートされます。

PHPエージェントは、以下の表にリストされているオペレーティングシステムをサポートしています。

オペレーティングシステム	サポート対象のベンダー	互換性メモ
Linux（x86_64）	Alpine Amazon Linux Red Hat Enterprise Linux （RHEL） CentOS Debian Ubuntu 以下を搭載した、その他のLinuxディストリビューション： Kernelの長期サポート付きバージョン現在 NPTLで維持されているglibcのブランチ musl libcの安定版シリーズ
Linux（ARM64）	Amazon Linux CentOS Alpine Debian	ARM64は、PHPバージョン8.0以降でのみサポートされています。 PHPエージェント10.10.0以降は、tarballディストリビューションにバイナリを含めることでARM64のサポートを提供します。 PHPエージェント9.18.1～10.9.0ソースディストリビューションは、Amazon Linux 2（AWS Graviton 2を含む）およびCentos 8でのみARM64のサポートを提供します。 ARM64のサポートとインストレーションの詳細については、ARM64のインストール情報を参照してください。

ウェブサーバー

サポートされているウェブサーバーは次のとおりです。

次を介してApache 2.2または2.4： mod_php
PHP-FPMを使用してFastCGIをサポ―トしている任意のウェブサーバー

フレームワーク

サポートされているフレームワークは次のとおりです。

Drupal 7.x、8.x、9.1〜9.5、10.x 重要 Drupalでブラウザインストゥルメンテーションを使用するには、Drupalとブラウザインストゥルメンテーションを参照してください。	Magento 2.x、CEおよびEE
Joomla 3.x 重要 PHP 8.xでは、Joomla 3.xはサポートされていません。	MediaWiki
Laminas 3.x	Slim 2.x、3.xおよび4.x
Laravel 6.x、7.x、8.x、9.x、10.x、11.x 重要 Laravel Horizonはサポートされていません。	Symfony 4.xおよび5️.x
Lumen 6.x、7.x、8.x、9.xおよび10.x	Wordpress
Yii 2.0
Zend Framework 3.x

PHPエージェントのフレームワークリストは増え続けています。使用中のフレームワークがこのリストにない場合でも、PHPエージェントはアプリについて役立つ情報を提供できる場合があります。

その他の一般的なPHPフレームワークのサポートを提案する場合は、サポートフォーラムを閲覧し、Feature Ideaを作成してください。詳細については、PHPフレームワーク：New Relicのサポートのインテグレーションを参照してください。

データベースおよびライブラリ

サポートされているデータベースとライブラリは次のとおりです。

Firebird（PDOドライバのみ）	Oracle
Guzzle	PHPUnit
Informix	PDOドライバ
Memcached	Postgres
MongoDB	Predis
Microsoft SQL Server（PDOドライバのみ）	Redis
MySQL	SQLite
ODBC（PDOドライバのみ）	Sybase（PDOドライバのみ）

その他のサードパーティ監視ソフトウェア

アプリケーションが追加の監視ソフトウェアを使用している場合、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他の監視ソフトウェアを使用中のエラーを参照してください。

インスタンスの詳細

New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。サポートされているデータベースと拡張機能は次のとおりです。

データベース	拡張子
MongoDB	mongodb
MySQL	mysql mysqli pdo_mysql
PostgreSQL	pgsql pdo_pgsql
Redis	redis predis

ホスト情報の収集を無効にするには、newrelic.iniファイルで次のいずれかを設定します。

インスタンスのレポートを無効にする newrelic.datastore_tracer.instance_reporting.enabled = false
データベース名を省略する newrelic.datastore_tracer.database_name_reporting.enabled = false

現在PHPエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。

メッセージキューイング

以下はメッセージキューイングをサポートしています。

HTTP
Laravelのキューイング
重要
Laravel Horizonはサポートされていません。

セキュリティ要件

標準的なデータ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。

New Relic機能のサポート

PHPエージェントは他のNew Relic機能と統合して、エンドツーエンドの可視性を提供します。

製品	インテグレーション
ブラウザのモニタリング	自動インストゥルメンテーションを有効化すると、PHPエージェントは自動的にBrowserエージェントのJSコードを投入します。Browserインジェクションを有効化すると、APMの概要ページでBrowserデータを表示、特定のアプリに対してAPMとBrowserデータ間を素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、BrowserモニタリングおよびPHPエージェントを参照してください。
Codestream（コードレベルのメトリクス）	New Relic CodeStreamはIDEにオブザーバビリティをもたらし、本番環境でコードがメソッドレベルでどのように機能しているかを表示します。 PHPバージョン7.0～7.4および8.0～8.3では、コードレベルのメトリクスをレポートします（リリース10.4.0以降）。
インフラストラクチャのモニタリング	インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIのAPMアプリ別にホストをフィルタリングできます。詳細については、インフラストラクチャモニターにおけるAPMデータを参照してください。
Logs in Context	PHPエージェントは、Monolog 2および3のライブラリのLogs in context機能をサポートしています。
New Relicのダッシュボード	PHPエージェントは、NRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。
合成のモニタリング	合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。