| 1 | efrain | 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 | // MOODLE_INTERNAL check intentionally missing to allow this to be used more widely!
 | 
        
           |  |  | 18 |   | 
        
           |  |  | 19 | /**
 | 
        
           |  |  | 20 |  * A set of PHP-compatible convenience functions to check Moodle minimum PHP version in
 | 
        
           |  |  | 21 |  * a unified place.
 | 
        
           |  |  | 22 |  *
 | 
        
           |  |  | 23 |  * PLEASE NOTE: This file is made to be both php-version compatible and without requirement on
 | 
        
           |  |  | 24 |  * any moodle functions or installation so it can be used in installer or incompatible PHP versions.
 | 
        
           |  |  | 25 |  *
 | 
        
           |  |  | 26 |  * @package    core
 | 
        
           |  |  | 27 |  * @copyright  2017 Dan Poltawski <dan@moodle.com>
 | 
        
           |  |  | 28 |  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 | 
        
           |  |  | 29 |  */
 | 
        
           |  |  | 30 |   | 
        
           |  |  | 31 | /**
 | 
        
           |  |  | 32 |  * Require our minimum php version or halt execution if requirement not met.
 | 
        
           |  |  | 33 |  * @return void Execution is halted if version is not met.
 | 
        
           |  |  | 34 |  */
 | 
        
           |  |  | 35 | function moodle_require_minimum_php_version() {
 | 
        
           |  |  | 36 |     // PLEASE NOTE THIS FUNCTION MUST BE COMPATIBLE WITH OLD UNSUPPORTED VERSIONS OF PHP!
 | 
        
           |  |  | 37 |     moodle_minimum_php_version_is_met(true);
 | 
        
           |  |  | 38 | }
 | 
        
           |  |  | 39 |   | 
        
           |  |  | 40 | /**
 | 
        
           |  |  | 41 |  * Tests the current PHP version against Moodle's minimum requirement. When requirement
 | 
        
           |  |  | 42 |  * is not met returns false or halts execution depending $haltexecution param.
 | 
        
           |  |  | 43 |  *
 | 
        
           |  |  | 44 |  * @param bool $haltexecution Should execution be halted when requirement not met? Defaults to false.
 | 
        
           |  |  | 45 |  * @return bool returns true if requirement is met (false if not)
 | 
        
           |  |  | 46 |  */
 | 
        
           |  |  | 47 | function moodle_minimum_php_version_is_met($haltexecution = false) {
 | 
        
           |  |  | 48 |     // PLEASE NOTE THIS FUNCTION MUST BE COMPATIBLE WITH OLD UNSUPPORTED VERSIONS OF PHP.
 | 
        
           |  |  | 49 |     // Do not use modern php features or Moodle convenience functions (e.g. localised strings).
 | 
        
           |  |  | 50 |   | 
        
           |  |  | 51 |     $minimumversion = '8.1.0';
 | 
        
           |  |  | 52 |     $moodlerequirementchanged = '4.4';
 | 
        
           |  |  | 53 |   | 
        
           |  |  | 54 |     if (version_compare(PHP_VERSION, $minimumversion) < 0) {
 | 
        
           |  |  | 55 |         if ($haltexecution) {
 | 
        
           |  |  | 56 |             $error = "Moodle {$moodlerequirementchanged} or later requires at least PHP {$minimumversion} "
 | 
        
           |  |  | 57 |                 . "(currently using version " . PHP_VERSION .").\n"
 | 
        
           |  |  | 58 |                 . "Some servers may have multiple PHP versions installed, are you using the correct executable?\n";
 | 
        
           |  |  | 59 |   | 
        
           |  |  | 60 |             // Our CLI scripts define CLI_SCRIPT before running this test, so make use of
 | 
        
           |  |  | 61 |             // to send error on STDERR.
 | 
        
           |  |  | 62 |             if (defined('CLI_SCRIPT') && defined('STDERR')) {
 | 
        
           |  |  | 63 |                 fwrite(STDERR, $error);
 | 
        
           |  |  | 64 |             } else {
 | 
        
           |  |  | 65 |                 echo $error;
 | 
        
           |  |  | 66 |             }
 | 
        
           |  |  | 67 |             exit(1);
 | 
        
           |  |  | 68 |         } else {
 | 
        
           |  |  | 69 |             return false;
 | 
        
           |  |  | 70 |         }
 | 
        
           |  |  | 71 |     }
 | 
        
           |  |  | 72 |     return true;
 | 
        
           |  |  | 73 | }
 | 
        
           |  |  | 74 |   | 
        
           |  |  | 75 | // DO NOT ADD EXTRA FUNCTIONS TO THIS FILE!!
 | 
        
           |  |  | 76 | // This file must be functioning on all versions of PHP, extra functions belong elsewhere.
 |