Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * CLI script to set up all the behat test environment.
 *
 * @package    tool_behat
 * @copyright  2013 David MonllaĆ³
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

if (isset($_SERVER['REMOTE_ADDR'])) {
    die(); // No access from web!
}

// Force OPcache reset if used, we do not want any stale caches
// when preparing test environment.
if (function_exists('opcache_reset')) {
    opcache_reset();
}

// Is not really necessary but adding it as is a CLI_SCRIPT.
define('CLI_SCRIPT', true);
define('CACHE_DISABLE_ALL', true);

// Basic functions.
require_once(__DIR__ . '/../../../../lib/clilib.php');
require_once(__DIR__ . '/../../../../lib/behat/lib.php');

list($options, $unrecognized) = cli_get_params(
    array(
        'parallel' => 0,
        'maxruns'  => false,
        'help'     => false,
        'fromrun'  => 1,
        'torun'    => 0,
        'optimize-runs' => '',
        'add-core-features-to-theme' => false,
> 'axe' => null, ), > 'disable-composer' => false, array( > 'composer-upgrade' => true, 'j' => 'parallel', > 'composer-self-update' => true,
'm' => 'maxruns', 'h' => 'help', 'o' => 'optimize-runs', 'a' => 'add-core-features-to-theme', ) ); // Checking run.php CLI script usage. $help = " Behat utilities to initialise behat tests Usage:
< php init.php [--parallel=value [--maxruns=value] [--fromrun=value --torun=value]] [--help]
> php init.php [--parallel=value [--maxruns=value] [--fromrun=value --torun=value]] > [--no-axe] [-o | --optimize-runs] [-a | --add-core-features-to-theme] > [--no-composer-self-update] [--no-composer-upgrade] > [--disable-composer] > [--help]
Options: -j, --parallel Number of parallel behat run to initialise
< -m, --maxruns Max parallel processes to be executed at one time.
> -m, --maxruns Max parallel processes to be executed at one time
--fromrun Execute run starting from (Used for parallel runs on different vms) --torun Execute run till (Used for parallel runs on different vms)
> --no-axe Disable axe accessibility tests.
< -o, --optimize-runs Split features with specified tags in all parallel runs. < -a, --add-core-features-to-theme Add all core features to specified theme's
> -o, --optimize-runs > Split features with specified tags in all parallel runs. > > -a, --add-core-features-to-theme > Add all core features to specified theme's > > --no-composer-self-update > Prevent upgrade of the composer utility using its self-update command > > --no-composer-upgrade > Prevent update development dependencies using composer > > --disable-composer > A shortcut to disable composer self-update and dependency update > Note: Installation of composer and/or dependencies will still happen as required
-h, --help Print out this help Example from Moodle root directory: \$ php admin/tool/behat/cli/init.php --parallel=2
< More info in http://docs.moodle.org/dev/Acceptance_testing#Running_tests
> More info in https://moodledev.io/general/development/tools/behat/running
"; if (!empty($options['help'])) { echo $help; exit(0); }
> if ($options['axe']) { // Check which util file to call. > echo "Axe accessibility tests are enabled by default, to disable them, use the --no-axe option.\n"; $utilfile = 'util_single_run.php'; > } else if ($options['axe'] === false) { $commandoptions = ""; > echo "Axe accessibility tests have been disabled.\n"; // If parallel run then use utilparallel. > } if ($options['parallel'] && $options['parallel'] > 1) { >
$utilfile = 'util.php'; // Sanitize all input options, so they can be passed to util. foreach ($options as $option => $value) {
< if ($value) { < $commandoptions .= " --$option=\"$value\""; < }
> $commandoptions .= behat_get_command_flags($option, $value);
} } else { // Only sanitize options for single run.
< $cmdoptionsforsinglerun = array('add-core-features-to-theme');
> $cmdoptionsforsinglerun = [ > 'add-core-features-to-theme', > 'axe', > ];
foreach ($cmdoptionsforsinglerun as $option) {
< if (!empty($options[$option])) { < $commandoptions .= " --$option='$options[$option]'"; < }
> $commandoptions .= behat_get_command_flags($option, $options[$option]);
} } // Changing the cwd to admin/tool/behat/cli. $cwd = getcwd(); $output = null;
< // If behat dependencies not downloaded then do it first, else symfony/process can't be used. < testing_update_composer_dependencies();
> if ($options['disable-composer']) { > // Disable self-update and upgrade easily. > // Note: Installation will still occur regardless of this setting. > $options['composer-self-update'] = false; > $options['composer-upgrade'] = false; > } > > // Install and update composer and dependencies as required. > testing_update_composer_dependencies($options['composer-self-update'], $options['composer-upgrade']);
// Check whether the behat test environment needs to be updated. chdir(__DIR__); exec("php $utilfile --diag $commandoptions", $output, $code); if ($code == 0) { echo "Behat test environment already installed\n"; } else if ($code == BEHAT_EXITCODE_INSTALL) { // Behat and dependencies are installed and we need to install the test site. chdir(__DIR__); passthru("php $utilfile --install $commandoptions", $code); if ($code != 0) { chdir($cwd); exit($code); } } else if ($code == BEHAT_EXITCODE_REINSTALL) { // Test site data is outdated. chdir(__DIR__); passthru("php $utilfile --drop $commandoptions", $code); if ($code != 0) { chdir($cwd); exit($code); } chdir(__DIR__); passthru("php $utilfile --install $commandoptions", $code); if ($code != 0) { chdir($cwd); exit($code); } } else { // Generic error, we just output it. echo implode("\n", $output)."\n"; chdir($cwd); exit($code); } // Enable editing mode according to config.php vars. chdir(__DIR__); passthru("php $utilfile --enable $commandoptions", $code); if ($code != 0) { echo "Error enabling site" . PHP_EOL; chdir($cwd); exit($code); } exit(0);