Merge pull request #21202 from zsistla/patch-14

PHP Agent release v12.0.0

Author: tejaswaroop-nr

src/content/docs/apm/agents/php-agent/configuration/php-agent-configuration.mdx

@@ -3939,7 +3939,7 @@ This section lists the settings that affect the reporting of code-level metrics.
           </th>
 
           <td>
-            `true`
+            `false`
           </td>
         </tr>
       </tbody>
@@ -3949,7 +3949,8 @@ This section lists the settings that affect the reporting of code-level metrics.
 
     <Callout variant="important">
       The `newrelic.code_level_metrics.enabled` INI variable was added in the 10.4.0.316 release and was disabled by default.
-      Code-level metrics are enabled by default starting with version 10.6.0.
+      Code-level metrics are enabled by default for versions 10.6.0 - 11.10.0.
+      Code-level metrics are disabled by default starting with version 12.0.0.
     </Callout>
   </Collapser>
 

src/content/docs/apm/agents/php-agent/features/php-code-level-metrics.mdx

@@ -15,7 +15,7 @@ Code-level metrics allow developers using the [New Relic CodeStream extension](/
 First, [install](/docs/codestream/start-here/install-codestream) the New Relic CodeStream extension into your supported IDE of choice and log in.
 
 <Callout variant="important">
-  Code-level metrics are available in the PHP agent version 10.4.0 or higher, and enabled by default for versions 10.6.0 and higher. To change this configuration, check out our [documentation](/docs/apm/agents/php-agent/configuration/php-agent-configuration/#inivar-code-level-metrics).
+  Code-level metrics are available in the PHP agent version 10.4.0 or higher and disabled by default for all versions except for versions 10.6.0 - 11.10.0 where it is enabled by default. To change this configuration, check out our [documentation](/docs/apm/agents/php-agent/configuration/php-agent-configuration/#inivar-code-level-metrics).
 </Callout>
 
 ## Agent attributes

src/content/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-0-0-25.mdx

@@ -0,0 +1,57 @@
+---
+subject: PHP agent
+releaseDate: '2025-08-11'
+version: 12.0.0.25
+downloadLink: 'https://download.newrelic.com/php_agent/archive/12.0.0.25'
+features: ['Observability in IDE: Code-Level metrics is disabled by default.', "Removed code for instrumenting Guzzle 3.x", "Removed code for instrumenting Kohana", "Removed code for instrumenting Silex", "Removed code for instrumenting Symfony 1.x-3.x", "Removed code for instrumenting Zend 1.x-2.x"]
+bugs: ['Improve drupal hook map error logging.', 'Fix legacy package detection issues']
+security: []
+---
+
+## New Relic PHP agent v12.0.0.25
+
+### Bug fixes
+
+* Improve drupal hook map error logging.
+* Fix legacy package detection issues for [Security RX](https://docs.newrelic.com/docs/vulnerability-management/overview/).
+
+### Notice
+
+#### Default value for `newrelic.code_level_metrics.enabled` INI has changed in this release
+
+As previously communicated, the default Code Level Metrics [Observability in IDE](https://docs.newrelic.com/docs/codestream/observability/code-level-metrics/) configuration will change in an this 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](https://docs.newrelic.com/docs/apm/agents/php-agent/features/php-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
+
+* As previously communicated, the following frameworks/libraries that the PHP Agent has previously EOL'd support for will be removed in the this release:
+
+  * Guzzle 3.x
+  * Kohana
+  * Silex
+  * Symfony 1.x-3.x
+  * Zend 1.x-2.x
+
+* PHP Agent support for the following library/framework versions will end September 30, 2025:
+
+  * WordPress 5.9
+  * Drupal 8.x
+  * Laravel 6.x, 8.x
+  * PHPUnit 8.x
+
+* 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](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/php-agent-eol-policy/).
+* The [PHP agent compatibility and requirements](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements/) page should be consulted for the latest information on supported PHP versions and platforms.
+
+<Callout variant="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
+</Callout>