* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ /* * Users of PHP 5.2 should be able to run the requirements checks. * This is why the file and all classes must be compatible with PHP 5.2+ * (e.g. not using namespaces and closures). * * ************** CAUTION ************** * * DO NOT EDIT THIS FILE as it will be overridden by Composer as part of * the installation/update process. The original file resides in the * SensioDistributionBundle. * * ************** CAUTION ************** */ /** * Represents a single PHP requirement, e.g. an installed extension. * It can be a mandatory requirement or an optional recommendation. * There is a special subclass, named PhpIniRequirement, to check a php.ini configuration. * * @author Tobias Schultze */ class Requirement { private $fulfilled; private $testMessage; private $helpText; private $helpHtml; private $optional; /** * Constructor that initializes the requirement. * * @param bool $fulfilled Whether the requirement is fulfilled * @param string $testMessage The message for testing the requirement * @param string $helpHtml The help text formatted in HTML for resolving the problem * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) * @param bool $optional Whether this is only an optional recommendation not a mandatory requirement */ public function __construct($fulfilled, $testMessage, $helpHtml, $helpText = null, $optional = false) { $this->fulfilled = (bool) $fulfilled; $this->testMessage = (string) $testMessage; $this->helpHtml = (string) $helpHtml; $this->helpText = null === $helpText ? strip_tags($this->helpHtml) : (string) $helpText; $this->optional = (bool) $optional; } /** * Returns whether the requirement is fulfilled. * * @return bool true if fulfilled, otherwise false */ public function isFulfilled() { return $this->fulfilled; } /** * Returns the message for testing the requirement. * * @return string The test message */ public function getTestMessage() { return $this->testMessage; } /** * Returns the help text for resolving the problem. * * @return string The help text */ public function getHelpText() { return $this->helpText; } /** * Returns the help text formatted in HTML. * * @return string The HTML help */ public function getHelpHtml() { return $this->helpHtml; } /** * Returns whether this is only an optional recommendation and not a mandatory requirement. * * @return bool true if optional, false if mandatory */ public function isOptional() { return $this->optional; } } /** * Represents a PHP requirement in form of a php.ini configuration. * * @author Tobias Schultze */ class PhpIniRequirement extends Requirement { /** * Constructor that initializes the requirement. * * @param string $cfgName The configuration name used for ini_get() * @param bool|callback $evaluation Either a boolean indicating whether the configuration should evaluate to true or false, * or a callback function receiving the configuration value as parameter to determine the fulfillment of the requirement * @param bool $approveCfgAbsence If true the Requirement will be fulfilled even if the configuration option does not exist, i.e. ini_get() returns false. * This is helpful for abandoned configs in later PHP versions or configs of an optional extension, like Suhosin. * Example: You require a config to be true but PHP later removes this config and defaults it to true internally. * @param string|null $testMessage The message for testing the requirement (when null and $evaluation is a boolean a default message is derived) * @param string|null $helpHtml The help text formatted in HTML for resolving the problem (when null and $evaluation is a boolean a default help is derived) * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) * @param bool $optional Whether this is only an optional recommendation not a mandatory requirement */ public function __construct($cfgName, $evaluation, $approveCfgAbsence = false, $testMessage = null, $helpHtml = null, $helpText = null, $optional = false) { $cfgValue = ini_get($cfgName); if (is_callable($evaluation)) { if (null === $testMessage || null === $helpHtml) { throw new InvalidArgumentException('You must provide the parameters testMessage and helpHtml for a callback evaluation.'); } $fulfilled = call_user_func($evaluation, $cfgValue); } else { if (null === $testMessage) { $testMessage = sprintf('%s %s be %s in php.ini', $cfgName, $optional ? 'should' : 'must', $evaluation ? 'enabled' : 'disabled' ); } if (null === $helpHtml) { $helpHtml = sprintf('Set %s to %s in php.ini*.', $cfgName, $evaluation ? 'on' : 'off' ); } $fulfilled = $evaluation == $cfgValue; } parent::__construct($fulfilled || ($approveCfgAbsence && false === $cfgValue), $testMessage, $helpHtml, $helpText, $optional); } } /** * A RequirementCollection represents a set of Requirement instances. * * @author Tobias Schultze */ class RequirementCollection implements IteratorAggregate { private $requirements = array(); /** * Gets the current RequirementCollection as an Iterator. * * @return Traversable A Traversable interface */ public function getIterator() { return new ArrayIterator($this->requirements); } /** * Adds a Requirement. * * @param Requirement $requirement A Requirement instance */ public function add(Requirement $requirement) { $this->requirements[] = $requirement; } /** * Adds a mandatory requirement. * * @param bool $fulfilled Whether the requirement is fulfilled * @param string $testMessage The message for testing the requirement * @param string $helpHtml The help text formatted in HTML for resolving the problem * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) */ public function addRequirement($fulfilled, $testMessage, $helpHtml, $helpText = null) { $this->add(new Requirement($fulfilled, $testMessage, $helpHtml, $helpText, false)); } /** * Adds an optional recommendation. * * @param bool $fulfilled Whether the recommendation is fulfilled * @param string $testMessage The message for testing the recommendation * @param string $helpHtml The help text formatted in HTML for resolving the problem * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) */ public function addRecommendation($fulfilled, $testMessage, $helpHtml, $helpText = null) { $this->add(new Requirement($fulfilled, $testMessage, $helpHtml, $helpText, true)); } /** * Adds a mandatory requirement in form of a php.ini configuration. * * @param string $cfgName The configuration name used for ini_get() * @param bool|callback $evaluation Either a boolean indicating whether the configuration should evaluate to true or false, * or a callback function receiving the configuration value as parameter to determine the fulfillment of the requirement * @param bool $approveCfgAbsence If true the Requirement will be fulfilled even if the configuration option does not exist, i.e. ini_get() returns false. * This is helpful for abandoned configs in later PHP versions or configs of an optional extension, like Suhosin. * Example: You require a config to be true but PHP later removes this config and defaults it to true internally. * @param string $testMessage The message for testing the requirement (when null and $evaluation is a boolean a default message is derived) * @param string $helpHtml The help text formatted in HTML for resolving the problem (when null and $evaluation is a boolean a default help is derived) * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) */ public function addPhpIniRequirement($cfgName, $evaluation, $approveCfgAbsence = false, $testMessage = null, $helpHtml = null, $helpText = null) { $this->add(new PhpIniRequirement($cfgName, $evaluation, $approveCfgAbsence, $testMessage, $helpHtml, $helpText, false)); } /** * Adds an optional recommendation in form of a php.ini configuration. * * @param string $cfgName The configuration name used for ini_get() * @param bool|callback $evaluation Either a boolean indicating whether the configuration should evaluate to true or false, * or a callback function receiving the configuration value as parameter to determine the fulfillment of the requirement * @param bool $approveCfgAbsence If true the Requirement will be fulfilled even if the configuration option does not exist, i.e. ini_get() returns false. * This is helpful for abandoned configs in later PHP versions or configs of an optional extension, like Suhosin. * Example: You require a config to be true but PHP later removes this config and defaults it to true internally. * @param string $testMessage The message for testing the requirement (when null and $evaluation is a boolean a default message is derived) * @param string $helpHtml The help text formatted in HTML for resolving the problem (when null and $evaluation is a boolean a default help is derived) * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) */ public function addPhpIniRecommendation($cfgName, $evaluation, $approveCfgAbsence = false, $testMessage = null, $helpHtml = null, $helpText = null) { $this->add(new PhpIniRequirement($cfgName, $evaluation, $approveCfgAbsence, $testMessage, $helpHtml, $helpText, true)); } /** * Adds a requirement collection to the current set of requirements. * * @param RequirementCollection $collection A RequirementCollection instance */ public function addCollection(RequirementCollection $collection) { $this->requirements = array_merge($this->requirements, $collection->all()); } /** * Returns both requirements and recommendations. * * @return array Array of Requirement instances */ public function all() { return $this->requirements; } /** * Returns all mandatory requirements. * * @return array Array of Requirement instances */ public function getRequirements() { $array = array(); foreach ($this->requirements as $req) { if (!$req->isOptional()) { $array[] = $req; } } return $array; } /** * Returns the mandatory requirements that were not met. * * @return array Array of Requirement instances */ public function getFailedRequirements() { $array = array(); foreach ($this->requirements as $req) { if (!$req->isFulfilled() && !$req->isOptional()) { $array[] = $req; } } return $array; } /** * Returns all optional recommendations. * * @return array Array of Requirement instances */ public function getRecommendations() { $array = array(); foreach ($this->requirements as $req) { if ($req->isOptional()) { $array[] = $req; } } return $array; } /** * Returns the recommendations that were not met. * * @return array Array of Requirement instances */ public function getFailedRecommendations() { $array = array(); foreach ($this->requirements as $req) { if (!$req->isFulfilled() && $req->isOptional()) { $array[] = $req; } } return $array; } /** * Returns whether a php.ini configuration is not correct. * * @return bool php.ini configuration problem? */ public function hasPhpIniConfigIssue() { foreach ($this->requirements as $req) { if (!$req->isFulfilled() && $req instanceof PhpIniRequirement) { return true; } } return false; } /** * Returns the PHP configuration file (php.ini) path. * * @return string|false php.ini file path */ public function getPhpIniConfigPath() { return get_cfg_var('cfg_file_path'); } } /** * This class specifies all requirements and optional recommendations that * are necessary to run the Symfony Standard Edition. * * @author Tobias Schultze * @author Fabien Potencier */ class SymfonyRequirements extends RequirementCollection { const REQUIRED_PHP_VERSION = '5.3.3'; /** * Constructor that initializes the requirements. */ public function __construct() { /* mandatory requirements follow */ $installedPhpVersion = phpversion(); $this->addRequirement( version_compare($installedPhpVersion, self::REQUIRED_PHP_VERSION, '>='), sprintf('PHP version must be at least %s (%s installed)', self::REQUIRED_PHP_VERSION, $installedPhpVersion), sprintf('You are running PHP version "%s", but Symfony needs at least PHP "%s" to run. Before using Symfony, upgrade your PHP installation, preferably to the latest version.', $installedPhpVersion, self::REQUIRED_PHP_VERSION), sprintf('Install PHP %s or newer (installed version is %s)', self::REQUIRED_PHP_VERSION, $installedPhpVersion) ); $this->addRequirement( version_compare($installedPhpVersion, '5.3.16', '!='), 'PHP version must not be 5.3.16 as Symfony won\'t work properly with it', 'Install PHP 5.3.17 or newer (or downgrade to an earlier PHP version)' ); $this->addRequirement( is_dir(__DIR__.'/../vendor/composer'), 'Vendor libraries must be installed', 'Vendor libraries are missing. Install composer following instructions from http://getcomposer.org/. '. 'Then run "php composer.phar install" to install them.' ); $cacheDir = is_dir(__DIR__.'/../var/cache') ? __DIR__.'/../var/cache' : __DIR__.'/cache'; $this->addRequirement( is_writable($cacheDir), 'app/cache/ or var/cache/ directory must be writable', 'Change the permissions of either "app/cache/" or "var/cache/" directory so that the web server can write into it.' ); $logsDir = is_dir(__DIR__.'/../var/logs') ? __DIR__.'/../var/logs' : __DIR__.'/logs'; $this->addRequirement( is_writable($logsDir), 'app/logs/ or var/logs/ directory must be writable', 'Change the permissions of either "app/logs/" or "var/logs/" directory so that the web server can write into it.' ); if (version_compare($installedPhpVersion, '7.0.0', '<')) { $this->addPhpIniRequirement( 'date.timezone', true, false, 'date.timezone setting must be set', 'Set the "date.timezone" setting in php.ini* (like Europe/Paris).' ); } if (version_compare($installedPhpVersion, self::REQUIRED_PHP_VERSION, '>=')) { $timezones = array(); foreach (DateTimeZone::listAbbreviations() as $abbreviations) { foreach ($abbreviations as $abbreviation) { $timezones[$abbreviation['timezone_id']] = true; } } $this->addRequirement( isset($timezones[@date_default_timezone_get()]), sprintf('Configured default timezone "%s" must be supported by your installation of PHP', @date_default_timezone_get()), 'Your default timezone is not supported by PHP. Check for typos in your php.ini file and have a look at the list of deprecated timezones at http://php.net/manual/en/timezones.others.php.' ); } $this->addRequirement( function_exists('iconv'), 'iconv() must be available', 'Install and enable the iconv extension.' ); $this->addRequirement( function_exists('json_encode'), 'json_encode() must be available', 'Install and enable the JSON extension.' ); $this->addRequirement( function_exists('session_start'), 'session_start() must be available', 'Install and enable the session extension.' ); $this->addRequirement( function_exists('ctype_alpha'), 'ctype_alpha() must be available', 'Install and enable the ctype extension.' ); $this->addRequirement( function_exists('token_get_all'), 'token_get_all() must be available', 'Install and enable the Tokenizer extension.' ); $this->addRequirement( function_exists('simplexml_import_dom'), 'simplexml_import_dom() must be available', 'Install and enable the SimpleXML extension.' ); if (function_exists('apc_store') && ini_get('apc.enabled')) { if (version_compare($installedPhpVersion, '5.4.0', '>=')) { $this->addRequirement( version_compare(phpversion('apc'), '3.1.13', '>='), 'APC version must be at least 3.1.13 when using PHP 5.4', 'Upgrade your APC extension (3.1.13+).' ); } else { $this->addRequirement( version_compare(phpversion('apc'), '3.0.17', '>='), 'APC version must be at least 3.0.17', 'Upgrade your APC extension (3.0.17+).' ); } } $this->addPhpIniRequirement('detect_unicode', false); if (extension_loaded('suhosin')) { $this->addPhpIniRequirement( 'suhosin.executor.include.whitelist', create_function('$cfgValue', 'return false !== stripos($cfgValue, "phar");'), false, 'suhosin.executor.include.whitelist must be configured correctly in php.ini', 'Add "phar" to suhosin.executor.include.whitelist in php.ini*.' ); } if (extension_loaded('xdebug')) { $this->addPhpIniRequirement( 'xdebug.show_exception_trace', false, true ); $this->addPhpIniRequirement( 'xdebug.scream', false, true ); $this->addPhpIniRecommendation( 'xdebug.max_nesting_level', create_function('$cfgValue', 'return $cfgValue > 100;'), true, 'xdebug.max_nesting_level should be above 100 in php.ini', 'Set "xdebug.max_nesting_level" to e.g. "250" in php.ini* to stop Xdebug\'s infinite recursion protection erroneously throwing a fatal error in your project.' ); } $pcreVersion = defined('PCRE_VERSION') ? (float) PCRE_VERSION : null; $this->addRequirement( null !== $pcreVersion, 'PCRE extension must be available', 'Install the PCRE extension (version 8.0+).' ); if (extension_loaded('mbstring')) { $this->addPhpIniRequirement( 'mbstring.func_overload', create_function('$cfgValue', 'return (int) $cfgValue === 0;'), true, 'string functions should not be overloaded', 'Set "mbstring.func_overload" to 0 in php.ini* to disable function overloading by the mbstring extension.' ); } /* optional recommendations follow */ if (file_exists(__DIR__.'/../vendor/composer')) { require_once __DIR__.'/../vendor/autoload.php'; try { $r = new ReflectionClass('Sensio\Bundle\DistributionBundle\SensioDistributionBundle'); $contents = file_get_contents(dirname($r->getFileName()).'/Resources/skeleton/app/SymfonyRequirements.php'); } catch (ReflectionException $e) { $contents = ''; } $this->addRecommendation( file_get_contents(__FILE__) === $contents, 'Requirements file should be up-to-date', 'Your requirements file is outdated. Run composer install and re-check your configuration.' ); } $this->addRecommendation( version_compare($installedPhpVersion, '5.3.4', '>='), 'You should use at least PHP 5.3.4 due to PHP bug #52083 in earlier versions', 'Your project might malfunction randomly due to PHP bug #52083 ("Notice: Trying to get property of non-object"). Install PHP 5.3.4 or newer.' ); $this->addRecommendation( version_compare($installedPhpVersion, '5.3.8', '>='), 'When using annotations you should have at least PHP 5.3.8 due to PHP bug #55156', 'Install PHP 5.3.8 or newer if your project uses annotations.' ); $this->addRecommendation( version_compare($installedPhpVersion, '5.4.0', '!='), 'You should not use PHP 5.4.0 due to the PHP bug #61453', 'Your project might not work properly due to the PHP bug #61453 ("Cannot dump definitions which have method calls"). Install PHP 5.4.1 or newer.' ); $this->addRecommendation( version_compare($installedPhpVersion, '5.4.11', '>='), 'When using the logout handler from the Symfony Security Component, you should have at least PHP 5.4.11 due to PHP bug #63379 (as a workaround, you can also set invalidate_session to false in the security logout handler configuration)', 'Install PHP 5.4.11 or newer if your project uses the logout handler from the Symfony Security Component.' ); $this->addRecommendation( (version_compare($installedPhpVersion, '5.3.18', '>=') && version_compare($installedPhpVersion, '5.4.0', '<')) || version_compare($installedPhpVersion, '5.4.8', '>='), 'You should use PHP 5.3.18+ or PHP 5.4.8+ to always get nice error messages for fatal errors in the development environment due to PHP bug #61767/#60909', 'Install PHP 5.3.18+ or PHP 5.4.8+ if you want nice error messages for all fatal errors in the development environment.' ); if (null !== $pcreVersion) { $this->addRecommendation( $pcreVersion >= 8.0, sprintf('PCRE extension should be at least version 8.0 (%s installed)', $pcreVersion), 'PCRE 8.0+ is preconfigured in PHP since 5.3.2 but you are using an outdated version of it. Symfony probably works anyway but it is recommended to upgrade your PCRE extension.' ); } $this->addRecommendation( class_exists('DomDocument'), 'PHP-DOM and PHP-XML modules should be installed', 'Install and enable the PHP-DOM and the PHP-XML modules.' ); $this->addRecommendation( function_exists('mb_strlen'), 'mb_strlen() should be available', 'Install and enable the mbstring extension.' ); $this->addRecommendation( function_exists('iconv'), 'iconv() should be available', 'Install and enable the iconv extension.' ); $this->addRecommendation( function_exists('utf8_decode'), 'utf8_decode() should be available', 'Install and enable the XML extension.' ); $this->addRecommendation( function_exists('filter_var'), 'filter_var() should be available', 'Install and enable the filter extension.' ); if (!defined('PHP_WINDOWS_VERSION_BUILD')) { $this->addRecommendation( function_exists('posix_isatty'), 'posix_isatty() should be available', 'Install and enable the php_posix extension (used to colorize the CLI output).' ); } $this->addRecommendation( extension_loaded('intl'), 'intl extension should be available', 'Install and enable the intl extension (used for validators).' ); if (extension_loaded('intl')) { // in some WAMP server installations, new Collator() returns null $this->addRecommendation( null !== new Collator('fr_FR'), 'intl extension should be correctly configured', 'The intl extension does not behave properly. This problem is typical on PHP 5.3.X x64 WIN builds.' ); // check for compatible ICU versions (only done when you have the intl extension) if (defined('INTL_ICU_VERSION')) { $version = INTL_ICU_VERSION; } else { $reflector = new ReflectionExtension('intl'); ob_start(); $reflector->info(); $output = strip_tags(ob_get_clean()); preg_match('/^ICU version +(?:=> )?(.*)$/m', $output, $matches); $version = $matches[1]; } $this->addRecommendation( version_compare($version, '4.0', '>='), 'intl ICU version should be at least 4+', 'Upgrade your intl extension with a newer ICU version (4+).' ); if (class_exists('Symfony\Component\Intl\Intl')) { $this->addRecommendation( \Symfony\Component\Intl\Intl::getIcuDataVersion() <= \Symfony\Component\Intl\Intl::getIcuVersion(), sprintf('intl ICU version installed on your system is outdated (%s) and does not match the ICU data bundled with Symfony (%s)', \Symfony\Component\Intl\Intl::getIcuVersion(), \Symfony\Component\Intl\Intl::getIcuDataVersion()), 'To get the latest internationalization data upgrade the ICU system package and the intl PHP extension.' ); if (\Symfony\Component\Intl\Intl::getIcuDataVersion() <= \Symfony\Component\Intl\Intl::getIcuVersion()) { $this->addRecommendation( \Symfony\Component\Intl\Intl::getIcuDataVersion() === \Symfony\Component\Intl\Intl::getIcuVersion(), sprintf('intl ICU version installed on your system (%s) does not match the ICU data bundled with Symfony (%s)', \Symfony\Component\Intl\Intl::getIcuVersion(), \Symfony\Component\Intl\Intl::getIcuDataVersion()), 'To avoid internationalization data inconsistencies upgrade the symfony/intl component.' ); } } $this->addPhpIniRecommendation( 'intl.error_level', create_function('$cfgValue', 'return (int) $cfgValue === 0;'), true, 'intl.error_level should be 0 in php.ini', 'Set "intl.error_level" to "0" in php.ini* to inhibit the messages when an error occurs in ICU functions.' ); } $accelerator = (extension_loaded('eaccelerator') && ini_get('eaccelerator.enable')) || (extension_loaded('apc') && ini_get('apc.enabled')) || (extension_loaded('Zend Optimizer+') && ini_get('zend_optimizerplus.enable')) || (extension_loaded('Zend OPcache') && ini_get('opcache.enable')) || (extension_loaded('xcache') && ini_get('xcache.cacher')) || (extension_loaded('wincache') && ini_get('wincache.ocenabled')) ; $this->addRecommendation( $accelerator, 'a PHP accelerator should be installed', 'Install and/or enable a PHP accelerator (highly recommended).' ); if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') { $this->addRecommendation( $this->getRealpathCacheSize() > 1000, 'realpath_cache_size should be above 1024 in php.ini', 'Set "realpath_cache_size" to e.g. "1024" in php.ini* to improve performance on windows.' ); } $this->addPhpIniRecommendation('short_open_tag', false); $this->addPhpIniRecommendation('magic_quotes_gpc', false, true); $this->addPhpIniRecommendation('register_globals', false, true); $this->addPhpIniRecommendation('session.auto_start', false); $this->addRecommendation( class_exists('PDO'), 'PDO should be installed', 'Install PDO (mandatory for Doctrine).' ); if (class_exists('PDO')) { $drivers = PDO::getAvailableDrivers(); $this->addRecommendation( count($drivers) > 0, sprintf('PDO should have some drivers installed (currently available: %s)', count($drivers) ? implode(', ', $drivers) : 'none'), 'Install PDO drivers (mandatory for Doctrine).' ); } } /** * Loads realpath_cache_size from php.ini and converts it to int. * * (e.g. 16k is converted to 16384 int) * * @return int */ protected function getRealpathCacheSize() { $size = ini_get('realpath_cache_size'); $size = trim($size); $unit = strtolower(substr($size, -1, 1)); switch ($unit) { case 'g': return $size * 1024 * 1024 * 1024; case 'm': return $size * 1024 * 1024; case 'k': return $size * 1024; default: return (int) $size; } } }