Merge pull request #18380 from bduranleau-nr/php/agent-version-php-co…

…mpat chore(php): rework php compatibility table
newrelic · Aug 16, 2024 · 9166906 · 9166906
2 parents df678ad + 06a4f99
commit 9166906
Showing 1 changed file with 67 additions and 28 deletions.
diff --git a/...s/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements.mdx b/...s/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements.mdx
@@ -14,61 +14,96 @@ freshnessValidatedDate: 2024-07-31
 
 Before you [install the PHP agent](/docs/apm/agents/php-agent/installation), make sure your system meets the version requirements listed below.
 
-## PHP releases [#php-release]
-
-The following PHP versions are supported:
+## PHP agent compatibility
 
 <table>
   <thead>
     <tr>
-      <th style={{ width: "250px" }}>
-        Version
+      <th>
+        PHP Version
+      </th>
+      <th>
+        Agent Version
       </th>
-
       <th>
-        Compatibility notes
+        Currently Supported
       </th>
     </tr>
   </thead>
-
   <tbody>
     <tr>
-      <td>
-        7.2 - 7.4
-      </td>
-
-      <td/>
+      <td>8.3</td>
+      <td>&ge; [10.15.0.4](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-15-0-4/)</td>
+      <td>Yes</td>
     </tr>
-
     <tr>
-      <td>
-        8.0 - 8.3
-      </td>
-
-      <td>
-        [Just-In-Time compilation](https://php.watch/articles/jit-in-depth) is supported as of agent release 10.18.0.8. PHP automatically disables JIT for any earlier versions of the PHP Agent.
-
-        PHP 8.1 and later does not support [Fibers](https://www.php.net/manual/en/language.fibers.php).
-      </td>
+      <td>8.2</td>
+      <td>All Supported Agent Versions</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td>8.1</td>
+      <td>All Supported Agent Versions</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td>8.0</td>
+      <td>All Supported Agent Versions</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td>7.4</td>
+      <td>All Supported Agent Versions</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td>7.3</td>
+      <td>All Supported Agent Versions</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td>7.2</td>
+      <td>All Supported Agent Versions</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td>7.1</td>
+      <td>&le; [10.21.0.11](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-21-0-11/)</td>
+      <td>No</td>
+    </tr>
+    <tr>
+      <td>7.0</td>
+      <td>&le; [10.21.0.11](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-10-21-0-11/)</td>
+      <td>No</td>
     </tr>
   </tbody>
 </table>
 
-## PHP agent compatibility
-
 See [PHP agent release notes](/docs/release-notes/agent-release-notes/php-release-notes/) for the latest PHP agent release.
 
-* For PHP builds that are compiled with Zend Thread Safety (ZTS), only [PHP agent 9.19](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-9190309) and earlier support these builds.
-* 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.
+For an up-to-date list of all currently supported PHP Agent releases, see the [PHP Agent EOL Policy](/docs/apm/agents/php-agent/getting-started/php-agent-eol-policy/).
 
-  To disable auto-update, you have two options:
+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`
 
+## 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](/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 not supported.
+
 ## Permissions [#permissions]
 
 Installing the PHP agent <DNT>**requires**</DNT> root access to:
@@ -94,6 +129,10 @@ The following processor architectures are supported:
 * x86_64 (also known as amd64)
 * aarch64 (also known as ARM64)
 
+<Callout variant="important">
+  aarch64 (ARM64) support is only available on PHP 8.0+.
+</Callout>
+
 ## 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.