>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3626729. --> Reported by: [fgm](https://www.drupal.org/user/27985) Related to !55 >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Drupal 12 requires PHP 8.5 and PHPUnit 12.5. The 2.x series runs next-major CI jobs against Drupal 12, allowed to fail, but until this issue they stopped at the Composer step, so no test had run on Drupal 12.</p> <p>Project Update Bot never opened an automated compatibility issue for this project, because its analysis fails at <code>composer require drupal/mongodb</code>: its Drupal 11 run reports <code>ext-mongodb</code> as missing from its environment. This issue takes its place.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Done in earlier issues:</p> <ul> <li>PHP 8.5: extension 1.x does not build on it, so Drupal 12 needs the 2.x driver, supported since <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/mongodb/-/work_items/3542043" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/mongodb/-/work_items/3542043</a></span>.</li> <li>The implicitly nullable parameter that failed a test on PHP 8.5: <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/mongodb/-/work_items/3458044" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/mongodb/-/work_items/3458044</a></span>.</li> <li>The PHP 8.5 deprecations in <code>QueueTest</code>: <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/mongodb/-/work_items/3626726" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/mongodb/-/work_items/3626726</a></span>.</li> <li>Composer: <code>drush/drush</code> in <code>require-dev</code> already accepts <code>^14</code>, the only Drush that accepts Symfony 8. No PHPUnit constraint turned out to be needed: the next-major Composer job installs Drupal 12's.</li> </ul> <p>Done in MR !55:</p> <ul> <li><strong>Core requirement</strong>: <code>core_version_requirement: ^12.0 || ^11.3 || ^10.6</code> in all four <code>.info.yml</code> files, test module included.</li> <li><strong>Tests</strong>, since PHPUnit 12 no longer reads annotations: <ul> <li>Attributes (<code>#[CoversClass]</code>, <code>#[Group]</code>, <code>#[DataProvider]</code>) beside the annotations, which PHPUnit 9 still reads on Drupal 10.</li> <li><code>@coversDefaultClass</code> becomes a class-level <code>@covers</code>, and method-level <code>@covers ::method</code> are removed: PHPUnit 11 reports them as invalid once a class has attributes, and PHPUnit 12 has no method-level targets.</li> <li><code>#[RunTestsInSeparateProcesses]</code> on every concrete kernel and functional test class: deprecated without it since Drupal 11.3, an exception in Drupal 12.0 (<a href="https://www.drupal.org/node/3548485">change record</a>).</li> <li><code>ControllerTest</code> no longer calls <code>xpath()</code>, deprecated in Drupal 11.5 (<a href="https://www.drupal.org/node/3589621">change record</a>). It calls Mink's <code>findAll()</code> directly, which works the same on Drupal 10 to 12.</li> </ul> </li> <li><strong>Requirements</strong>: Drupal 11.3 deprecates procedural <code>hook_requirements()</code> without <code>#[LegacyRequirementsHook]</code> (<a href="https://www.drupal.org/node/3549685">change record</a>), and Drupal 12 removes the <code>REQUIREMENT_*</code> constants. <ul> <li>Runtime and update checks move to OOP hooks in <code>src/Hook/</code>, and install checks to <code>InstallRequirementsInterface</code> classes in <code>src/Install/Requirements/</code>.</li> <li>The procedural <code>hook_requirements()</code> remains as a <code>#[LegacyRequirementsHook]</code> wrapper, so Drupal 10 runs the same checks.</li> <li>A <code>Severity</code> helper maps severities to the <code>RequirementSeverity</code> enum or to the constants, depending on the core version.</li> </ul> </li> <li><strong>Bugs fixed on the way</strong>, in the requirements checks: <ul> <li>MongoDB errors and warnings were reported as OK on the status report.</li> <li>Installing MongoDB Watchdog without <code>$settings['mongodb']</code> threw a <code>TypeError</code>. It now reports a requirement error.</li> <li>The request tracking message had a stray <code>&amp;lt;/a&amp;gt;</code>. At runtime, it now links to the MongoDB Watchdog settings form.</li> </ul> </li> </ul> <p>Related, not required by Drupal 12:</p> <ul> <li><span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/mongodb/-/work_items/3425809" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/mongodb/-/work_items/3425809</a></span>: implementing core's <code>QueueFactoryInterface</code>.</li> <li><span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/mongodb/-/work_items/3626728" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/mongodb/-/work_items/3626728</a></span>: the <code>collStats</code> command, deprecated since MongoDB 6.2.</li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/mongodb/issues/3627078" title="Status: Closed (fixed)">#3627078: UI errors in post-D7 recent versions</a></span>: admin UI problems found while testing on Drupal 12, also present on Drupal 11.</li> </ul> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ul> <li>Drush commands: they are still declared in <code>drush.services.yml</code>, which Drush 13 marks as deprecated. Check whether Drush 14 still loads it once it has a stable release, and move the commands to attributes if not.</li> </ul> <h3 id="summary-ui-changes">User interface changes</h3> <p>On the status report, MongoDB errors and warnings now show with their real severity, and the request tracking message links to the MongoDB Watchdog settings form.</p> <h3 id="summary-api-changes">API changes</h3> <ul> <li><code>core_version_requirement</code> now includes <code>^12.0</code>.</li> <li><code>Drupal\mongodb_watchdog\Install\Requirements</code> is renamed <code>RequirementsChecker</code>, with no alias. Its service ID, <code>mongodb.watchdog_requirements</code>, is unchanged.</li> </ul> <h3 id="summary-data-model-changes">Data model changes</h3> <p>None.</p> <h3 id="summary-ai">AI disclosure</h3> <p>Issue and MR are AI-assisted.</p>