--- title: PHP agent compatibility and requirements source: https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements --- Before you [install the PHP agent](https://docs.newrelic.com/docs/apm/agents/php-agent/installation), make sure your system meets the version requirements listed below. ## PHP agent compatibility [#compatibility] | PHP Version | Agent Version | Currently Supported | | ----------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------- | | 8.5 | ≥ [12.4.0.29](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-4-0-29/) | Yes | | 8.4 | ≥ [11.5.0.18](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-11-5-0-18/) | Yes | | 8.3 | ≥ [10.15.0.4](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-15-0-4/) | Yes | | 8.2 | All Supported Agent Versions | Yes | | 8.1 | All Supported Agent Versions | Yes | | 8.0 | All Supported Agent Versions | Yes | | 7.4 | All Supported Agent Versions | Yes | | 7.3 | All Supported Agent Versions | Yes | | 7.2 | All Supported Agent Versions | Yes | | 7.1 | ≤ [10.21.0.11](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-21-0-11/) | No | | 7.0 | ≤ [10.21.0.11](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-21-0-11/) | No | See [PHP agent release notes](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/) for the latest PHP agent release. For an up-to-date list of all currently supported PHP Agent releases, see the [PHP Agent EOL Policy](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/php-agent-eol-policy/). If you're using an unsupported PHP version or platform (such as a 32 bit OS, FreeBSD, or ZTS builds), we recommend disabling the auto-update mechanisms for the PHP agent packages. If you fail to prevent automatic upgrades, this could lead to the accidental installation of a newer agent version. The newer version may no longer support critical features essential for APM data collection, resulting in disruptions to monitoring capabilities. To disable auto-update, you have two options: - Add the PHP agent packages to an exclusion list for package upgrades, or - Version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). The affected PHP agent packages are: - `newrelic-php5` - `newrelic-php5-common` - `newrelic-daemon` ## PHP Major Version Readiness New Relic is committed to rapid adoption of new PHP minor versions. Our target is to offer GA support for final releases within a 60-day window. While development priorities may shift to address urgent security needs, we are dedicated to narrowing this gap and ensuring our agent remains the most reliable way to monitor your modern PHP applications. ## Zend Thread Safety [#zts] PHP builds that are compiled with Zend Thread Safety (ZTS) are not supported. ## Just-In-Time Compilation (JIT) [#jit] [Just-In-Time compilation](https://php.watch/articles/jit-in-depth) is supported as of agent release [10.18.0.8](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-18-0-8/). PHP automatically disables JIT for any earlier versions of the PHP Agent. ## Fibers [#fibers] [Fibers](https://www.php.net/manual/en/language.fibers.php) is supported as of version 12.10. If you wish to disable fibers instrumentation, append `newrelic.fibers.disabled = true` to your configuration file. ## Permissions [#permissions] Installing the PHP agent **requires** root access to: - Read/write access to the PHP extensions directory. - Read/write access to PHP configuration data, either in the PHP configuration directory (preferred) or in `php.ini`. - Restart the web server or PHP process pool. Running the agent **does not require** root access. The agent does need read/write access to the following files (the location of these files can be [customized in the PHP agent settings](https://docs.newrelic.com/docs/php/php-agent-phpini-settings)): - [A file storing the agent log files](https://docs.newrelic.com/docs/apm/agents/php-agent/configuration/php-agent-configuration/#inivar-daemon-logfile) - [A file storing the agent socket endpoint](https://docs.newrelic.com/docs/apm/agents/php-agent/configuration/php-agent-configuration/#inivar-daemon-port) - [A file storing the agent process ID](https://docs.newrelic.com/docs/apm/agents/php-agent/configuration/php-agent-configuration/#inivar-daemon-pidfile) ## License key [#license_key] Your New Relic license key is a 40-character hexadecimal string that New Relic provides when you [sign up](https://newrelic.com/signup) for your account. For more information, see the PHP [install script](https://docs.newrelic.com/docs/php/the-newrelic-install-script) or [license key settings in the PHP `ini` file](https://docs.newrelic.com/docs/php/php-agent-phpini-settings#inivar-license). ## Processors [#processor] The following processor architectures are supported: - x86_64 (also known as amd64) - aarch64 (also known as ARM64) > #### ⚠️ IMPORTANT > > aarch64 (ARM64) support is only available on PHP 8.0+. ## Operating systems [#operating-systems] When vendors announce end-of-life (such as on [Ubuntu's End of Standard Support page](https://wiki.ubuntu.com/Releases)), we will continue to support those latest versions for one year after the vendor end-of-life date. However, if the PHP version you're using is no longer officially supported, then support could end sooner than one year. This is why we recommend always using the latest version of the OS that is officially supported by the vendor. The latest versions of our agent may work on OS versions that are past End of Life, but we no longer test or officially support the PHP agent with older versions. Based on the information above the PHP agent, can be installed on operating systems using the install methods listed in the table below. | Operating system | Release | CPU architecture | Install method | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Alpine Linux | 3.17, 3.18, 3.19, 3.20, 3.21, 3.22 | x86_64, aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | Amazon Linux | 2 | x86_64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file), [RPM](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-aws-linux-redhat-centos) | | Amazon Linux | 2 | aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | Amazon Linux | 2023 | x86_64, aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | CentOS Stream | 9, 10 | x86_64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file), [RPM](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-aws-linux-redhat-centos) | | CentOS Stream | 9, 10 | aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | RedHat Enterprise Linux | 8, 9, 10 | x86_64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file), [RPM](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-aws-linux-redhat-centos) | | RedHat Enterprise Linux | 8, 9, 10 | aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | Debian | 11, 12, 13 | x86_64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file), [DEB](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-ubuntu-debian) | | Debian | 11, 12, 13 | aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | Ubuntu | 20, 22, 24 | x86_64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file), [DEB](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-ubuntu-debian) | | Ubuntu | 20, 22, 24 | aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | | Any Linux distribution with: - Kernel version with [long term support](https://kernel.org/) - glibc [currently maintained branch](https://sourceware.org/glibc/wiki/Release) with [NPTL](https://en.wikipedia.org/wiki/Native_POSIX_Thread_Library) - musl libc [stable series](https://musl.libc.org/releases.html) | N/A | x86_64, aarch64 | [tar file](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-tar-file) | ## Web servers [#webserver] The following web servers are supported: - Apache 2.2 or 2.4 via `mod_php` - Any web server that supports FastCGI using PHP-FPM ## Frameworks The following frameworks are supported: | Framework | Version | Considerations | | --------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CakePHP | 4.x, 5.x | | | Drupal | 7.x, 9.x, 10.x, 11.0, 11.1, 11.2 | [Drupal specific functionality](https://docs.newrelic.com/docs/apm/agents/php-agent/frameworks-libraries/drupal-specific-functionality) [Drupal browser instrumentation](https://docs.newrelic.com/docs/apm/agents/php-agent/frameworks-libraries/drupal-specific-functionality/#page-load-timing-rum) Drupal 11.3 Notice: The upcoming Drupal release changes their hook implementations and is incompatible with current PHP Agent versions. We’re actively working on a solution, but Drupal 11.3+ isn’t supported yet and will remain so until early 2026. | | Joomla | ≤ 3.7 | with Agent Version ≤ [10.22.0.12](https://docs.newrelic.com/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-22-0-12/) | | Laminas | 3.x | | | Laravel | 11.x, 12.x, 13.x | | | Magento | 2.x (CE and EE) | | | Slim | 2.x, 4.x | | | Symfony | 5.x, 6.x, 7.x, 8.x | | | Wordpress | 6.0+ | [Wordpress specific functionality](https://docs.newrelic.com/docs/apm/agents/php-agent/frameworks-libraries/wordpress-specific-functionality/) | | Yii | 1.1, 2.0 | | If you want to suggest support for other popular PHP frameworks, visit the [Support Forum](https://support.newrelic.com/s/hubtopic/Topic__c/Default?c__categories=%5B%7B%22icon%22%3A%22standard%3Adefault%22%2C%22id%22%3A%22a6c8W000000EeskQAC%22%2C%22sObjectType%22%3A%22Category__c%22%2C%22title%22%3A%22PHP%20Agent%22%2C%22titleFormatted%22%3A%22PHP%20Agent%22%7D%5D) and create a `Feature Idea`. For more information, see [PHP frameworks: Integrating support for New Relic](https://docs.newrelic.com/docs/apm/agents/php-agent/frameworks-libraries/php-frameworks-integrate-support-new-relic). ## Databases and libraries [#databases] The following databases and libraries are supported: | Amazon DynamoDB (aws-sdk-php 3 library only) | Oracle | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | Firebird (PDO Driver only) | PDO Drivers | | [Guzzle](https://docs.newrelic.com/docs/agents/php-agent/frameworks-libraries/guzzle) | Postgres | | Informix | [Predis](https://docs.newrelic.com/docs/agents/php-agent/frameworks-libraries/predis) | | Kinesis Data Streams (aws-sdk-php 3 library only) | RabbitMQ (php-amqplib 3.7 library only) | | Memcached | Redis (including Redis Cluster) | | Microsoft SQL Server (PDO Driver only) | SQLite | | MongoDB | SQS (aws-sdk-php 3 library only) | | MySQL | Sybase (PDO Driver only) | | ODBC (PDO Driver only) | | ## Other third-party monitoring software [#other-monitoring-software] If your application uses any additional monitoring software, we cannot guarantee that our agent will work correctly and cannot offer technical support. For more information, see [Errors when using other monitoring software](https://docs.newrelic.com/docs/apm/new-relic-apm/troubleshooting/errors-while-using-new-relic-apm-alongside-other-apm-software). ## Instance details New Relic collects [instance details for a variety of databases and database drivers](https://docs.newrelic.com/docs/apm/applications-menu/features/analyze-database-instance-level-performance-issues). The following databases and extensions are supported: | Database | Extension | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | MongoDB | [mongodb](https://github.com/mongodb/mongo-php-library) | | MySQL | - [mysql](http://php.net/manual/en/book.mysql.php) - [mysqli](http://php.net/manual/en/book.mysqli.php) - [pdo_mysql](http://php.net/manual/en/ref.pdo-mysql.php) | | [PostgreSQL](https://www.postgresql.org/) | - [pgsql](http://php.net/manual/en/book.pgsql.php) - [pdo_pgsql](http://php.net/manual/en/ref.pdo-pgsql.php) | | [Redis](https://redis.io/) | - [redis](https://pecl.php.net/package/redis) - [predis](https://github.com/nrk/predis) | To disable collection of host information, configure one of the following in the `newrelic.ini`file: - Disable instance reporting with `newrelic.datastore_tracer.instance_reporting.enabled = false` - Omit the database name with `newrelic.datastore_tracer.database_name_reporting.enabled = false` To request instance-level information from datastores currently not listed for your PHP agent, get support at [support.newrelic.com](https://support.newrelic.com). ## Message queuing [#queuing] The following supports message queuing: - HTTP - Laravel [Queuing](https://docs.newrelic.com/docs/apm/agents/php-agent/frameworks-libraries/laravel) - Laravel [Horizon](https://docs.newrelic.com/docs/apm/agents/php-agent/frameworks-libraries/laravel) (Supported for Laravel 10 and above) ## Security requirements [#security] As a standard [security measure for data collection](https://docs.newrelic.com/docs/accounts-partnerships/accounts/security/data-security), your app server must support SHA-2 (256-bit). SHA-1 is not supported. ## New Relic feature support [#digital-intelligence-platform] The PHP agent integrates with other New Relic features to give you end-to-end visibility: | Product | Integration | | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Browser monitoring](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/introduction-new-relic-browser) | The PHP agent automatically injects the browser agent's JS code when you [enable auto-instrumentation](https://docs.newrelic.com/docs/browser/new-relic-browser/installation/install-new-relic-browser-agent#select-apm-app). After enabling browser injection, you can view data in the [APM Summary page](https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page) and quickly switch between the APM and browser data for a particular app. For configuration options and manual instrumentation, see [Browser monitoring and the PHP agent](https://docs.newrelic.com/docs/agents/php-agent/features/page-load-timing-php). | | [Codestream (code-level metrics)](https://docs.newrelic.com/docs/codestream/how-use-codestream/performance-monitoring/) | New Relic CodeStream brings observability into the IDE to show how your code is performing in production at the method level. PHP versions 7.0 - 7.4 and 8.0 - 8.3 report code-level metrics (starting with release 10.4.0). | | [Infrastructure monitoring](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/getting-started/introduction-new-relic-infrastructure) | When you install the infrastructure and APM agents on the same host, they automatically detect one another. You can then view a list of hosts in the APM UI, and filter your hosts by APM app in the infrastructure UI. For more information, see [APM data in infrastructure monitoring](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/data-instrumentation/new-relic-apm-data-infrastructure). | | [Logs in context](https://docs.newrelic.com/docs/logs/logs-context/configure-logs-context-php/) | The PHP agent supports our logs in context feature for Monolog 2 and 3 libraries. | | [New Relic Dashboards](https://docs.newrelic.com/docs/insights/use-insights-ui/getting-started/introduction-new-relic-insights) | The PHP agent sends [default events and attributes](https://docs.newrelic.com/docs/insights/insights-data-sources/default-events-attributes/apm-default-event-attributes) for NRQL queries. You can also [record custom events](https://docs.newrelic.com/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents) for advanced analysis. | | [Synthetic monitoring](https://docs.newrelic.com/docs/synthetics/new-relic-synthetics/getting-started/introduction-new-relic-synthetics) | [Synthetic transaction traces](https://docs.newrelic.com/docs/synthetics/new-relic-synthetics/using-monitors/collect-synthetic-transaction-traces) connect requests from synthetic monitors to the underlying APM transaction. |