class PhpRequirementTest

Same name and namespace in other branches
  1. 11.x core/modules/system/tests/src/Functional/System/PhpRequirementTest.php \Drupal\Tests\system\Functional\System\PhpRequirementTest
  2. 10 core/modules/system/tests/src/Functional/System/PhpRequirementTest.php \Drupal\Tests\system\Functional\System\PhpRequirementTest

Tests the output of PHP requirements on the status report.

@group system

Hierarchy

Expanded class hierarchy of PhpRequirementTest

File

core/modules/system/tests/src/Functional/System/PhpRequirementTest.php, line 14

Namespace

Drupal\Tests\system\Functional\System
View source
class PhpRequirementTest extends BrowserTestBase {
  use RequirementsPageTrait;
  
  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $admin_user = $this->drupalCreateUser([
      'administer site configuration',
      'access site reports',
    ]);
    $this->drupalLogin($admin_user);
    // By default, Drupal installation (and BrowserTestBase) do not configure
    // trusted host patterns, which leads to an error on the status report.
    // Configure them so that the site is properly configured and so that we
    // can cleanly test the errors related to PHP versions.
    $settings['settings']['trusted_host_patterns'] = (object) [
      'value' => [
        '^' . preg_quote(\Drupal::request()->getHost()) . '$',
      ],
      'required' => TRUE,
    ];
    $this->writeSettings($settings);
  }
  
  /**
   * Tests status report messages regarding the PHP version.
   */
  public function testStatusPage() {
    $minimum_php_version = PhpRequirements::getMinimumSupportedPhp();
    // Go to Administration.
    $this->drupalGet('admin/reports/status');
    $this->assertSession()
      ->statusCodeEquals(200);
    $phpversion = phpversion();
    // Verify that the PHP version is shown on the page.
    $this->assertSession()
      ->pageTextContains($phpversion);
    // Verify that an error is displayed about the PHP version if it is below
    // the minimum supported PHP.
    if (version_compare($phpversion, $minimum_php_version) < 0) {
      $this->assertErrorSummaries([
        'PHP',
      ]);
      $this->assertSession()
        ->pageTextContains('Your PHP installation is too old. Drupal requires at least PHP ' . $minimum_php_version);
    }
    else {
      $this->assertSession()
        ->pageTextNotContains('Your PHP installation is too old. Drupal requires at least PHP ' . $minimum_php_version);
      $this->assertSession()
        ->pageTextNotContains('Errors found');
    }
    // There should be an informational message if the PHP version is below the
    // recommended version.
    if (version_compare($phpversion, \Drupal::RECOMMENDED_PHP) < 0) {
      // If running a PHP version affected by a known OPcache bug, warn about
      // that.
      // @todo Remove this when \Drupal::MINIMUM_PHP is at least 8.1.6 in
      //   https://www.drupal.org/i/3305726.
      if (version_compare($phpversion, '8.1.0', 'ge') && version_compare($phpversion, '8.1.6', 'lt')) {
        $this->assertSession()
          ->pageTextContains("PHP {$phpversion} has an OPcache bug that can cause fatal errors with class autoloading. This can be fixed by upgrading to PHP 8.1.6 or later.");
        $this->assertSession()
          ->linkExists('an OPcache bug that can cause fatal errors with class autoloading');
      }
      else {
        $this->assertSession()
          ->pageTextContains('It is recommended to upgrade to PHP version ' . \Drupal::RECOMMENDED_PHP . ' or higher');
      }
    }
    else {
      $this->assertSession()
        ->pageTextNotContains('It is recommended to upgrade to PHP version ' . \Drupal::RECOMMENDED_PHP . ' or higher');
    }
  }

}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.