811 lines
33 KiB
PHP
Executable File
811 lines
33 KiB
PHP
Executable File
<?php
|
|
|
|
/*
|
|
* This file is part of the Symfony package.
|
|
*
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
|
*
|
|
* 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 <http://tobion.de>
|
|
*/
|
|
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 <http://tobion.de>
|
|
*/
|
|
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 <strong>%s</strong> to <strong>%s</strong> in php.ini<a href="#phpini">*</a>.',
|
|
$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 <http://tobion.de>
|
|
*/
|
|
class RequirementCollection implements IteratorAggregate
|
|
{
|
|
/**
|
|
* @var Requirement[]
|
|
*/
|
|
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 Requirement[]
|
|
*/
|
|
public function all()
|
|
{
|
|
return $this->requirements;
|
|
}
|
|
|
|
/**
|
|
* Returns all mandatory requirements.
|
|
*
|
|
* @return Requirement[]
|
|
*/
|
|
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 Requirement[]
|
|
*/
|
|
public function getFailedRequirements()
|
|
{
|
|
$array = array();
|
|
foreach ($this->requirements as $req) {
|
|
if (!$req->isFulfilled() && !$req->isOptional()) {
|
|
$array[] = $req;
|
|
}
|
|
}
|
|
|
|
return $array;
|
|
}
|
|
|
|
/**
|
|
* Returns all optional recommendations.
|
|
*
|
|
* @return Requirement[]
|
|
*/
|
|
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 Requirement[]
|
|
*/
|
|
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 <http://tobion.de>
|
|
* @author Fabien Potencier <fabien@symfony.com>
|
|
*/
|
|
class SymfonyRequirements extends RequirementCollection
|
|
{
|
|
const LEGACY_REQUIRED_PHP_VERSION = '5.3.3';
|
|
const REQUIRED_PHP_VERSION = '5.5.9';
|
|
|
|
/**
|
|
* Constructor that initializes the requirements.
|
|
*/
|
|
public function __construct()
|
|
{
|
|
/* mandatory requirements follow */
|
|
|
|
$installedPhpVersion = PHP_VERSION;
|
|
$requiredPhpVersion = $this->getPhpRequiredVersion();
|
|
|
|
$this->addRecommendation(
|
|
$requiredPhpVersion,
|
|
'Vendors should be installed in order to check all requirements.',
|
|
'Run the <code>composer install</code> command.',
|
|
'Run the "composer install" command.'
|
|
);
|
|
|
|
if (false !== $requiredPhpVersion) {
|
|
$this->addRequirement(
|
|
version_compare($installedPhpVersion, $requiredPhpVersion, '>='),
|
|
sprintf('PHP version must be at least %s (%s installed)', $requiredPhpVersion, $installedPhpVersion),
|
|
sprintf('You are running PHP version "<strong>%s</strong>", but Symfony needs at least PHP "<strong>%s</strong>" to run.
|
|
Before using Symfony, upgrade your PHP installation, preferably to the latest version.',
|
|
$installedPhpVersion, $requiredPhpVersion),
|
|
sprintf('Install PHP %s or newer (installed version is %s)', $requiredPhpVersion, $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 <a href="http://getcomposer.org/">http://getcomposer.org/</a>. '.
|
|
'Then run "<strong>php composer.phar install</strong>" 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 "<strong>app/cache/</strong>" or "<strong>var/cache/</strong>" 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 "<strong>app/logs/</strong>" or "<strong>var/logs/</strong>" 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 "<strong>date.timezone</strong>" setting in php.ini<a href="#phpini">*</a> (like Europe/Paris).'
|
|
);
|
|
}
|
|
|
|
if (false !== $requiredPhpVersion && version_compare($installedPhpVersion, $requiredPhpVersion, '>=')) {
|
|
$this->addRequirement(
|
|
in_array(@date_default_timezone_get(), DateTimeZone::listIdentifiers(), true),
|
|
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 <strong>php.ini</strong> file and have a look at the list of deprecated timezones at <a href="http://php.net/manual/en/timezones.others.php">http://php.net/manual/en/timezones.others.php</a>.'
|
|
);
|
|
}
|
|
|
|
$this->addRequirement(
|
|
function_exists('iconv'),
|
|
'iconv() must be available',
|
|
'Install and enable the <strong>iconv</strong> extension.'
|
|
);
|
|
|
|
$this->addRequirement(
|
|
function_exists('json_encode'),
|
|
'json_encode() must be available',
|
|
'Install and enable the <strong>JSON</strong> extension.'
|
|
);
|
|
|
|
$this->addRequirement(
|
|
function_exists('session_start'),
|
|
'session_start() must be available',
|
|
'Install and enable the <strong>session</strong> extension.'
|
|
);
|
|
|
|
$this->addRequirement(
|
|
function_exists('ctype_alpha'),
|
|
'ctype_alpha() must be available',
|
|
'Install and enable the <strong>ctype</strong> extension.'
|
|
);
|
|
|
|
$this->addRequirement(
|
|
function_exists('token_get_all'),
|
|
'token_get_all() must be available',
|
|
'Install and enable the <strong>Tokenizer</strong> extension.'
|
|
);
|
|
|
|
$this->addRequirement(
|
|
function_exists('simplexml_import_dom'),
|
|
'simplexml_import_dom() must be available',
|
|
'Install and enable the <strong>SimpleXML</strong> 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 <strong>APC</strong> 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 <strong>APC</strong> 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 "<strong>phar</strong>" to <strong>suhosin.executor.include.whitelist</strong> in php.ini<a href="#phpini">*</a>.'
|
|
);
|
|
}
|
|
|
|
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 "<strong>xdebug.max_nesting_level</strong>" to e.g. "<strong>250</strong>" in php.ini<a href="#phpini">*</a> 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 <strong>PCRE</strong> 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 "<strong>mbstring.func_overload</strong>" to <strong>0</strong> in php.ini<a href="#phpini">*</a> 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),
|
|
'<strong>PCRE 8.0+</strong> 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 <strong>PHP-DOM</strong> and the <strong>PHP-XML</strong> modules.'
|
|
);
|
|
|
|
$this->addRecommendation(
|
|
function_exists('mb_strlen'),
|
|
'mb_strlen() should be available',
|
|
'Install and enable the <strong>mbstring</strong> extension.'
|
|
);
|
|
|
|
$this->addRecommendation(
|
|
function_exists('utf8_decode'),
|
|
'utf8_decode() should be available',
|
|
'Install and enable the <strong>XML</strong> extension.'
|
|
);
|
|
|
|
$this->addRecommendation(
|
|
function_exists('filter_var'),
|
|
'filter_var() should be available',
|
|
'Install and enable the <strong>filter</strong> extension.'
|
|
);
|
|
|
|
if (!defined('PHP_WINDOWS_VERSION_BUILD')) {
|
|
$this->addRecommendation(
|
|
function_exists('posix_isatty'),
|
|
'posix_isatty() should be available',
|
|
'Install and enable the <strong>php_posix</strong> extension (used to colorize the CLI output).'
|
|
);
|
|
}
|
|
|
|
$this->addRecommendation(
|
|
extension_loaded('intl'),
|
|
'intl extension should be available',
|
|
'Install and enable the <strong>intl</strong> 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 <strong>intl</strong> 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 "<strong>intl.error_level</strong>" to "<strong>0</strong>" in php.ini<a href="#phpini">*</a> 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 <strong>PHP accelerator</strong> (highly recommended).'
|
|
);
|
|
|
|
if ('WIN' === strtoupper(substr(PHP_OS, 0, 3))) {
|
|
$this->addRecommendation(
|
|
$this->getRealpathCacheSize() >= 5 * 1024 * 1024,
|
|
'realpath_cache_size should be at least 5M in php.ini',
|
|
'Setting "<strong>realpath_cache_size</strong>" to e.g. "<strong>5242880</strong>" or "<strong>5M</strong>" in php.ini<a href="#phpini">*</a> may improve performance on Windows significantly in some cases.'
|
|
);
|
|
}
|
|
|
|
$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 <strong>PDO</strong> (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 <strong>PDO drivers</strong> (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 = '';
|
|
if (!ctype_digit($size)) {
|
|
$unit = strtolower(substr($size, -1, 1));
|
|
$size = (int) substr($size, 0, -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;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Defines PHP required version from Symfony version.
|
|
*
|
|
* @return string|false The PHP required version or false if it could not be guessed
|
|
*/
|
|
protected function getPhpRequiredVersion()
|
|
{
|
|
if (!file_exists($path = __DIR__.'/../composer.lock')) {
|
|
return false;
|
|
}
|
|
|
|
$composerLock = json_decode(file_get_contents($path), true);
|
|
foreach ($composerLock['packages'] as $package) {
|
|
$name = $package['name'];
|
|
if ('symfony/symfony' !== $name && 'symfony/http-kernel' !== $name) {
|
|
continue;
|
|
}
|
|
|
|
return (int) $package['version'][1] > 2 ? self::REQUIRED_PHP_VERSION : self::LEGACY_REQUIRED_PHP_VERSION;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|