class QuickStartTest

Same name in other branches
  1. 9 core/tests/Drupal/Tests/Core/Command/QuickStartTest.php \Drupal\Tests\Core\Command\QuickStartTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Command/QuickStartTest.php \Drupal\Tests\Core\Command\QuickStartTest
  3. 10 core/tests/Drupal/Tests/Core/Command/QuickStartTest.php \Drupal\Tests\Core\Command\QuickStartTest

Tests the quick-start commands.

These tests are run in a separate process because they load Drupal code via an include.

@runTestsInSeparateProcesses @preserveGlobalState disabled @requires extension pdo_sqlite

@group Command @group #slow

Hierarchy

  • class \Drupal\Tests\Core\Command\QuickStartTest extends \PHPUnit\Framework\TestCase

Expanded class hierarchy of QuickStartTest

File

core/tests/Drupal/Tests/Core/Command/QuickStartTest.php, line 29

Namespace

Drupal\Tests\Core\Command
View source
class QuickStartTest extends TestCase {
    
    /**
     * The PHP executable path.
     *
     * @var string
     */
    protected $php;
    
    /**
     * A test database object.
     *
     * @var \Drupal\Core\Test\TestDatabase
     */
    protected $testDb;
    
    /**
     * The Drupal root directory.
     *
     * @var string
     */
    protected $root;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        $php_executable_finder = new PhpExecutableFinder();
        $this->php = $php_executable_finder->find();
        $this->root = dirname(substr(__DIR__, 0, -strlen(__NAMESPACE__)), 2);
        chdir($this->root);
        if (!is_writable("{$this->root}/sites/simpletest")) {
            $this->markTestSkipped('This test requires a writable sites/simpletest directory');
        }
        // Get a lock and a valid site path.
        $this->testDb = new TestDatabase();
    }
    
    /**
     * {@inheritdoc}
     */
    protected function tearDown() : void {
        if ($this->testDb) {
            $test_site_directory = $this->root . DIRECTORY_SEPARATOR . $this->testDb
                ->getTestSitePath();
            if (file_exists($test_site_directory)) {
                // @todo use the tear down command from
                //   https://www.drupal.org/project/drupal/issues/2926633
                // Delete test site directory.
                $this->fileUnmanagedDeleteRecursive($test_site_directory, [
                    BrowserTestBase::class,
                    'filePreDeleteCallback',
                ]);
            }
        }
        parent::tearDown();
    }
    
    /**
     * Tests the quick-start command.
     */
    public function testQuickStartCommand() : void {
        $sqlite = (new \PDO('sqlite::memory:'))->query('select sqlite_version()')
            ->fetch()[0];
        if (version_compare($sqlite, Tasks::SQLITE_MINIMUM_VERSION) < 0) {
            $this->markTestSkipped();
        }
        // Install a site using the standard profile to ensure the one time login
        // link generation works.
        $install_command = [
            $this->php,
            'core/scripts/drupal',
            'quick-start',
            'standard',
            "--site-name='Test site {$this->testDb->getDatabasePrefix()}'",
            '--suppress-login',
        ];
        $process = new Process($install_command, NULL, [
            'DRUPAL_DEV_SITE_PATH' => $this->testDb
                ->getTestSitePath(),
        ]);
        $process->setTimeout(500);
        $process->start();
        $guzzle = new Client();
        $port = FALSE;
        $process->waitUntil(function ($type, $output) use (&$port) {
            if (preg_match('/127.0.0.1:(\\d+)/', $output, $match)) {
                $port = $match[1];
                return TRUE;
            }
        });
        // The progress bar uses STDERR to write messages.
        $this->assertStringContainsString('Congratulations, you installed Drupal!', $process->getErrorOutput());
        // Ensure the command does not trigger any PHP deprecations.
        $this->assertStringNotContainsString('Deprecated', $process->getErrorOutput());
        $this->assertNotFalse($port, "Web server running on port {$port}");
        // Give the server a couple of seconds to be ready.
        sleep(2);
        $this->assertStringContainsString("127.0.0.1:{$port}/user/reset/1/", $process->getOutput());
        // Generate a cookie so we can make a request against the installed site.
        define('DRUPAL_TEST_IN_CHILD_SITE', FALSE);
        chmod($this->testDb
            ->getTestSitePath(), 0755);
        $cookieJar = CookieJar::fromArray([
            'SIMPLETEST_USER_AGENT' => drupal_generate_test_ua($this->testDb
                ->getDatabasePrefix()),
        ], '127.0.0.1');
        $response = $guzzle->get('http://127.0.0.1:' . $port, [
            'cookies' => $cookieJar,
        ]);
        $content = (string) $response->getBody();
        $this->assertStringContainsString('Test site ' . $this->testDb
            ->getDatabasePrefix(), $content);
        // Stop the web server.
        $process->stop();
    }
    
    /**
     * Tests the quick-start commands.
     */
    public function testQuickStartInstallAndServerCommands() : void {
        $sqlite = (new \PDO('sqlite::memory:'))->query('select sqlite_version()')
            ->fetch()[0];
        if (version_compare($sqlite, Tasks::SQLITE_MINIMUM_VERSION) < 0) {
            $this->markTestSkipped();
        }
        // Install a site.
        $install_command = [
            $this->php,
            'core/scripts/drupal',
            'install',
            'testing',
            "--password='secret'",
            "--site-name='Test site {$this->testDb->getDatabasePrefix()}'",
        ];
        $install_process = new Process($install_command, NULL, [
            'DRUPAL_DEV_SITE_PATH' => $this->testDb
                ->getTestSitePath(),
        ]);
        $install_process->setTimeout(500);
        $result = $install_process->run();
        // The progress bar uses STDERR to write messages.
        $this->assertStringContainsString('Congratulations, you installed Drupal!', $install_process->getErrorOutput());
        $this->assertStringContainsString("Password: 'secret'", $install_process->getOutput());
        $this->assertSame(0, $result);
        // Run the PHP built-in webserver.
        $server_command = [
            $this->php,
            'core/scripts/drupal',
            'server',
            '--suppress-login',
        ];
        $server_process = new Process($server_command, NULL, [
            'DRUPAL_DEV_SITE_PATH' => $this->testDb
                ->getTestSitePath(),
        ]);
        $server_process->start();
        $guzzle = new Client();
        $port = FALSE;
        $server_process->waitUntil(function ($type, $output) use (&$port) {
            if (preg_match('/127.0.0.1:(\\d+)\\/user\\/reset\\/1\\//', $output, $match)) {
                $port = $match[1];
                return TRUE;
            }
        });
        $this->assertEquals('', $server_process->getErrorOutput());
        $this->assertStringContainsString("127.0.0.1:{$port}/user/reset/1/", $server_process->getOutput());
        $this->assertNotFalse($port, "Web server running on port {$port}");
        // Give the server a couple of seconds to be ready.
        sleep(2);
        // Generate a cookie so we can make a request against the installed site.
        define('DRUPAL_TEST_IN_CHILD_SITE', FALSE);
        chmod($this->testDb
            ->getTestSitePath(), 0755);
        $cookieJar = CookieJar::fromArray([
            'SIMPLETEST_USER_AGENT' => drupal_generate_test_ua($this->testDb
                ->getDatabasePrefix()),
        ], '127.0.0.1');
        $response = $guzzle->get('http://127.0.0.1:' . $port, [
            'cookies' => $cookieJar,
        ]);
        $content = (string) $response->getBody();
        $this->assertStringContainsString('Test site ' . $this->testDb
            ->getDatabasePrefix(), $content);
        // Try to re-install over the top of an existing site.
        $install_command = [
            $this->php,
            'core/scripts/drupal',
            'install',
            'testing',
            "--site-name='Test another site {$this->testDb->getDatabasePrefix()}'",
        ];
        $install_process = new Process($install_command, NULL, [
            'DRUPAL_DEV_SITE_PATH' => $this->testDb
                ->getTestSitePath(),
        ]);
        $install_process->setTimeout(500);
        $result = $install_process->run();
        $this->assertStringContainsString('Drupal is already installed.', $install_process->getOutput());
        $this->assertSame(0, $result);
        // Ensure the site name has not changed.
        $response = $guzzle->get('http://127.0.0.1:' . $port, [
            'cookies' => $cookieJar,
        ]);
        $content = (string) $response->getBody();
        $this->assertStringContainsString('Test site ' . $this->testDb
            ->getDatabasePrefix(), $content);
        // Stop the web server.
        $server_process->stop();
    }
    
    /**
     * Tests the install command with an invalid profile.
     */
    public function testQuickStartCommandProfileValidation() : void {
        // Install a site using the standard profile to ensure the one time login
        // link generation works.
        $install_command = [
            $this->php,
            'core/scripts/drupal',
            'quick-start',
            'umami',
            "--site-name='Test site {$this->testDb->getDatabasePrefix()}' --suppress-login",
        ];
        $process = new Process($install_command, NULL, [
            'DRUPAL_DEV_SITE_PATH' => $this->testDb
                ->getTestSitePath(),
        ]);
        $process->run();
        $this->assertMatchesRegularExpression("/'umami' is not a valid install profile or recipe\\. Did you mean \\W*'demo_umami'?/", $process->getErrorOutput());
    }
    
    /**
     * Tests the server command when there is no installation.
     */
    public function testServerWithNoInstall() : void {
        $server_command = [
            $this->php,
            'core/scripts/drupal',
            'server',
            '--suppress-login',
        ];
        $server_process = new Process($server_command, NULL, [
            'DRUPAL_DEV_SITE_PATH' => $this->testDb
                ->getTestSitePath(),
        ]);
        $server_process->run();
        $this->assertStringContainsString('No installation found. Use the \'install\' command.', $server_process->getErrorOutput());
    }
    
    /**
     * Deletes all files and directories in the specified path recursively.
     *
     * Note this method has no dependencies on Drupal core to ensure that the
     * test site can be torn down even if something in the test site is broken.
     *
     * @param string $path
     *   A string containing either a URI or a file or directory path.
     * @param callable $callback
     *   (optional) Callback function to run on each file prior to deleting it and
     *   on each directory prior to traversing it. For example, can be used to
     *   modify permissions.
     *
     * @return bool
     *   TRUE for success or if path does not exist, FALSE in the event of an
     *   error.
     *
     * @see \Drupal\Core\File\FileSystemInterface::deleteRecursive()
     */
    protected function fileUnmanagedDeleteRecursive($path, $callback = NULL) : bool {
        if (isset($callback)) {
            call_user_func($callback, $path);
        }
        if (is_dir($path)) {
            $dir = dir($path);
            while (($entry = $dir->read()) !== FALSE) {
                if ($entry == '.' || $entry == '..') {
                    continue;
                }
                $entry_path = $path . '/' . $entry;
                $this->fileUnmanagedDeleteRecursive($entry_path, $callback);
            }
            $dir->close();
            return rmdir($path);
        }
        return unlink($path);
    }

}

Members

Title Sort descending Modifiers Object type Summary
QuickStartTest::$php protected property The PHP executable path.
QuickStartTest::$root protected property The Drupal root directory.
QuickStartTest::$testDb protected property A test database object.
QuickStartTest::fileUnmanagedDeleteRecursive protected function Deletes all files and directories in the specified path recursively.
QuickStartTest::setUp protected function
QuickStartTest::tearDown protected function
QuickStartTest::testQuickStartCommand public function Tests the quick-start command.
QuickStartTest::testQuickStartCommandProfileValidation public function Tests the install command with an invalid profile.
QuickStartTest::testQuickStartInstallAndServerCommands public function Tests the quick-start commands.
QuickStartTest::testServerWithNoInstall public function Tests the server command when there is no installation.

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