lib/phpunit/bootstrap.php

   1 <?php
   2 // This file is part of Moodle - http://moodle.org/
   3 //
   4 // Moodle is free software: you can redistribute it and/or modify
   5 // it under the terms of the GNU General Public License as published by
   6 // the Free Software Foundation, either version 3 of the License, or
   7 // (at your option) any later version.
   8 //
   9 // Moodle is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 /**
  18  * Prepares PHPUnit environment, the phpunit.xml configuration
  19  * must specify this file as bootstrap.
  20  *
  21  * Exit codes: {@see phpunit_bootstrap_error()}
  22  *
  23  * @package    core
  24  * @category   phpunit
  25  * @copyright  2012 Petr Skoda {@link http://skodak.org}
  26  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  27  */
  28
  29 if (isset($_SERVER['REMOTE_ADDR'])) {
  30     die; // No access from web!
  31 }
  32
  33 // we want to know about all problems
  34 error_reporting(E_ALL | E_STRICT);
  35 ini_set('display_errors', '1');
  36 ini_set('log_errors', '1');
  37
  38 // Make sure OPcache does not strip comments, we need them in phpunit!
  39 if (ini_get('opcache.enable') and strtolower(ini_get('opcache.enable')) !== 'off') {
  40     if (!ini_get('opcache.save_comments') or strtolower(ini_get('opcache.save_comments')) === 'off') {
  41         ini_set('opcache.enable', 0);
  42     } else {
  43         ini_set('opcache.load_comments', 1);
  44     }
  45 }
  46
  47 if (!defined('IGNORE_COMPONENT_CACHE')) {
  48     define('IGNORE_COMPONENT_CACHE', true);
  49 }
  50
  51 require_once(__DIR__.'/bootstraplib.php');
  52 require_once(__DIR__.'/../testing/lib.php');
  53
  54 if (isset($_SERVER['REMOTE_ADDR'])) {
  55     phpunit_bootstrap_error(1, 'Unit tests can be executed only from command line!');
  56 }
  57
  58 if (defined('PHPUNIT_TEST')) {
  59     phpunit_bootstrap_error(1, "PHPUNIT_TEST constant must not be manually defined anywhere!");
  60 }
  61 /** PHPUnit testing framework active */
  62 define('PHPUNIT_TEST', true);
  63
  64 if (!defined('PHPUNIT_UTIL')) {
  65     /** Identifies utility scripts - the database does not need to be initialised */
  66     define('PHPUNIT_UTIL', false);
  67 }
  68
  69 if (defined('CLI_SCRIPT')) {
  70     phpunit_bootstrap_error(1, 'CLI_SCRIPT must not be manually defined in any PHPUnit test scripts');
  71 }
  72 define('CLI_SCRIPT', true);
  73
  74 $phpunitversion = PHPUnit\Runner\Version::id();
  75 if ($phpunitversion === '@package_version@') {
  76     // library checked out from git, let's hope dev knows that 3.6.0 is required
  77 } else if (version_compare($phpunitversion, '3.6.0', 'lt')) {
  78     phpunit_bootstrap_error(PHPUNIT_EXITCODE_PHPUNITWRONG, $phpunitversion);
  79 }
  80 unset($phpunitversion);
  81
  82 // only load CFG from config.php, stop ASAP in lib/setup.php
  83 define('ABORT_AFTER_CONFIG', true);
  84 require(__DIR__ . '/../../config.php');
  85
  86 if (!defined('PHPUNIT_LONGTEST')) {
  87     /** Execute longer version of tests */
  88     define('PHPUNIT_LONGTEST', false);
  89 }
  90
  91 // remove error handling overrides done in config.php
  92 error_reporting(E_ALL | E_STRICT);
  93 ini_set('display_errors', '1');
  94 ini_set('log_errors', '1');
  95 set_time_limit(0); // no time limit in CLI scripts, user may cancel execution
  96
  97 // prepare dataroot
  98 umask(0);
  99 if (isset($CFG->phpunit_directorypermissions)) {
 100     $CFG->directorypermissions = $CFG->phpunit_directorypermissions;
 101 } else {
 102     $CFG->directorypermissions = 02777;
 103 }
 104 $CFG->filepermissions = ($CFG->directorypermissions & 0666);
 105 if (!isset($CFG->phpunit_dataroot)) {
 106     phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, 'Missing $CFG->phpunit_dataroot in config.php, can not run tests!');
 107 }
 108
 109 // Create test dir if does not exists yet.
 110 if (!file_exists($CFG->phpunit_dataroot)) {
 111     mkdir($CFG->phpunit_dataroot, $CFG->directorypermissions);
 112 }
 113 if (!is_dir($CFG->phpunit_dataroot)) {
 114     phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, '$CFG->phpunit_dataroot directory can not be created, can not run tests!');
 115 }
 116
 117 // Ensure we access to phpunit_dataroot realpath always.
 118 $CFG->phpunit_dataroot = realpath($CFG->phpunit_dataroot);
 119
 120 if (isset($CFG->dataroot) and $CFG->phpunit_dataroot === $CFG->dataroot) {
 121     phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, '$CFG->dataroot and $CFG->phpunit_dataroot must not be identical, can not run tests!');
 122 }
 123
 124 if (!is_writable($CFG->phpunit_dataroot)) {
 125     // try to fix permissions if possible
 126     if (function_exists('posix_getuid')) {
 127         $chmod = fileperms($CFG->phpunit_dataroot);
 128         if (fileowner($CFG->phpunit_dataroot) == posix_getuid()) {
 129             $chmod = $chmod | 0700;
 130             chmod($CFG->phpunit_dataroot, $chmod);
 131         }
 132     }
 133     if (!is_writable($CFG->phpunit_dataroot)) {
 134         phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, '$CFG->phpunit_dataroot directory is not writable, can not run tests!');
 135     }
 136 }
 137 if (!file_exists("$CFG->phpunit_dataroot/phpunittestdir.txt")) {
 138     if ($dh = opendir($CFG->phpunit_dataroot)) {
 139         while (($file = readdir($dh)) !== false) {
 140             if ($file === 'phpunit' or $file === '.' or $file === '..' or $file === '.DS_Store') {
 141                 continue;
 142             }
 143             phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, '$CFG->phpunit_dataroot directory is not empty, can not run tests! Is it used for anything else?');
 144         }
 145         closedir($dh);
 146         unset($dh);
 147         unset($file);
 148     }
 149
 150     // now we are 100% sure this dir is used only for phpunit tests
 151     testing_initdataroot($CFG->phpunit_dataroot, 'phpunit');
 152 }
 153
 154 // verify db prefix
 155 if (!isset($CFG->phpunit_prefix)) {
 156     phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, 'Missing $CFG->phpunit_prefix in config.php, can not run tests!');
 157 }
 158 if ($CFG->phpunit_prefix === '') {
 159     phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, '$CFG->phpunit_prefix can not be empty, can not run tests!');
 160 }
 161 if (isset($CFG->prefix) and $CFG->prefix === $CFG->phpunit_prefix) {
 162     phpunit_bootstrap_error(PHPUNIT_EXITCODE_CONFIGERROR, '$CFG->prefix and $CFG->phpunit_prefix must not be identical, can not run tests!');
 163 }
 164
 165 // override CFG settings if necessary and throw away extra CFG settings
 166 $CFG->wwwroot   = 'https://www.example.com/moodle';
 167 $CFG->dataroot  = $CFG->phpunit_dataroot;
 168 $CFG->prefix    = $CFG->phpunit_prefix;
 169 $CFG->dbtype    = isset($CFG->phpunit_dbtype) ? $CFG->phpunit_dbtype : $CFG->dbtype;
 170 $CFG->dblibrary = isset($CFG->phpunit_dblibrary) ? $CFG->phpunit_dblibrary : $CFG->dblibrary;
 171 $CFG->dbhost    = isset($CFG->phpunit_dbhost) ? $CFG->phpunit_dbhost : $CFG->dbhost;
 172 $CFG->dbname    = isset($CFG->phpunit_dbname) ? $CFG->phpunit_dbname : $CFG->dbname;
 173 $CFG->dbuser    = isset($CFG->phpunit_dbuser) ? $CFG->phpunit_dbuser : $CFG->dbuser;
 174 $CFG->dbpass    = isset($CFG->phpunit_dbpass) ? $CFG->phpunit_dbpass : $CFG->dbpass;
 175 $CFG->prefix    = isset($CFG->phpunit_prefix) ? $CFG->phpunit_prefix : $CFG->prefix;
 176 $CFG->dboptions = isset($CFG->phpunit_dboptions) ? $CFG->phpunit_dboptions : $CFG->dboptions;
 177
 178 $allowed = array('wwwroot', 'dataroot', 'dirroot', 'admin', 'directorypermissions', 'filepermissions',
 179                  'dbtype', 'dblibrary', 'dbhost', 'dbname', 'dbuser', 'dbpass', 'prefix', 'dboptions',
 180                  'proxyhost', 'proxyport', 'proxytype', 'proxyuser', 'proxypassword', 'proxybypass', // keep proxy settings from config.php
 181                  'altcacheconfigpath', 'pathtogs', 'pathtophp', 'pathtodu', 'aspellpath', 'pathtodot',
 182                  'pathtounoconv', 'alternative_file_system_class', 'pathtopython'
 183                 );
 184 $productioncfg = (array)$CFG;
 185 $CFG = new stdClass();
 186 foreach ($productioncfg as $key=>$value) {
 187     if (!in_array($key, $allowed) and strpos($key, 'phpunit_') !== 0 and strpos($key, 'behat_') !== 0) {
 188         // ignore
 189         continue;
 190     }
 191     $CFG->{$key} = $value;
 192 }
 193 unset($key);
 194 unset($value);
 195 unset($allowed);
 196 unset($productioncfg);
 197
 198 // force the same CFG settings in all sites
 199 $CFG->debug = (E_ALL | E_STRICT); // can not use DEBUG_DEVELOPER yet
 200 $CFG->debugdeveloper = true;
 201 $CFG->debugdisplay = 1;
 202 error_reporting($CFG->debug);
 203 ini_set('display_errors', '1');
 204 ini_set('log_errors', '1');
 205
 206 // some ugly hacks
 207 $CFG->themerev = 1;
 208 $CFG->jsrev = 1;
 209
 210 // load test case stub classes and other stuff
 211 require_once("$CFG->dirroot/lib/phpunit/lib.php");
 212
 213 // finish moodle init
 214 define('ABORT_AFTER_CONFIG_CANCEL', true);
 215 if (isset($CFG->phpunit_profilingenabled) && $CFG->phpunit_profilingenabled) {
 216     $CFG->profilingenabled = true;
 217     $CFG->profilingincluded = '*';
 218 }
 219 require("$CFG->dirroot/lib/setup.php");
 220
 221 raise_memory_limit(MEMORY_HUGE);
 222
 223 if (PHPUNIT_UTIL) {
 224     // we are not going to do testing, this is 'true' in utility scripts that only init database
 225     return;
 226 }
 227
 228 // is database and dataroot ready for testing?
 229 list($errorcode, $message) = phpunit_util::testing_ready_problem();
 230 // print some version info
 231 phpunit_util::bootstrap_moodle_info();
 232 if ($errorcode) {
 233     phpunit_bootstrap_error($errorcode, $message);
 234 }
 235
 236 // prepare for the first test run - store fresh globals, reset database and dataroot, etc.
 237 phpunit_util::bootstrap_init();