Mercurial > hg > dml-open-vis
comparison app/SymfonyRequirements.php @ 0:493bcb69166c
added public content
| author | Daniel Wolff | 
|---|---|
| date | Tue, 09 Feb 2016 20:54:02 +0100 | 
| parents | |
| children | 
   comparison
  equal
  deleted
  inserted
  replaced
| -1:000000000000 | 0:493bcb69166c | 
|---|---|
| 1 <?php | |
| 2 | |
| 3 /* | |
| 4 * This file is part of the Symfony package. | |
| 5 * | |
| 6 * (c) Fabien Potencier <fabien@symfony.com> | |
| 7 * | |
| 8 * For the full copyright and license information, please view the LICENSE | |
| 9 * file that was distributed with this source code. | |
| 10 */ | |
| 11 | |
| 12 /* | |
| 13 * Users of PHP 5.2 should be able to run the requirements checks. | |
| 14 * This is why the file and all classes must be compatible with PHP 5.2+ | |
| 15 * (e.g. not using namespaces and closures). | |
| 16 * | |
| 17 * ************** CAUTION ************** | |
| 18 * | |
| 19 * DO NOT EDIT THIS FILE as it will be overridden by Composer as part of | |
| 20 * the installation/update process. The original file resides in the | |
| 21 * SensioDistributionBundle. | |
| 22 * | |
| 23 * ************** CAUTION ************** | |
| 24 */ | |
| 25 | |
| 26 /** | |
| 27 * Represents a single PHP requirement, e.g. an installed extension. | |
| 28 * It can be a mandatory requirement or an optional recommendation. | |
| 29 * There is a special subclass, named PhpIniRequirement, to check a php.ini configuration. | |
| 30 * | |
| 31 * @author Tobias Schultze <http://tobion.de> | |
| 32 */ | |
| 33 class Requirement | |
| 34 { | |
| 35 private $fulfilled; | |
| 36 private $testMessage; | |
| 37 private $helpText; | |
| 38 private $helpHtml; | |
| 39 private $optional; | |
| 40 | |
| 41 /** | |
| 42 * Constructor that initializes the requirement. | |
| 43 * | |
| 44 * @param bool $fulfilled Whether the requirement is fulfilled | |
| 45 * @param string $testMessage The message for testing the requirement | |
| 46 * @param string $helpHtml The help text formatted in HTML for resolving the problem | |
| 47 * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) | |
| 48 * @param bool $optional Whether this is only an optional recommendation not a mandatory requirement | |
| 49 */ | |
| 50 public function __construct($fulfilled, $testMessage, $helpHtml, $helpText = null, $optional = false) | |
| 51 { | |
| 52 $this->fulfilled = (bool) $fulfilled; | |
| 53 $this->testMessage = (string) $testMessage; | |
| 54 $this->helpHtml = (string) $helpHtml; | |
| 55 $this->helpText = null === $helpText ? strip_tags($this->helpHtml) : (string) $helpText; | |
| 56 $this->optional = (bool) $optional; | |
| 57 } | |
| 58 | |
| 59 /** | |
| 60 * Returns whether the requirement is fulfilled. | |
| 61 * | |
| 62 * @return bool true if fulfilled, otherwise false | |
| 63 */ | |
| 64 public function isFulfilled() | |
| 65 { | |
| 66 return $this->fulfilled; | |
| 67 } | |
| 68 | |
| 69 /** | |
| 70 * Returns the message for testing the requirement. | |
| 71 * | |
| 72 * @return string The test message | |
| 73 */ | |
| 74 public function getTestMessage() | |
| 75 { | |
| 76 return $this->testMessage; | |
| 77 } | |
| 78 | |
| 79 /** | |
| 80 * Returns the help text for resolving the problem | |
| 81 * | |
| 82 * @return string The help text | |
| 83 */ | |
| 84 public function getHelpText() | |
| 85 { | |
| 86 return $this->helpText; | |
| 87 } | |
| 88 | |
| 89 /** | |
| 90 * Returns the help text formatted in HTML. | |
| 91 * | |
| 92 * @return string The HTML help | |
| 93 */ | |
| 94 public function getHelpHtml() | |
| 95 { | |
| 96 return $this->helpHtml; | |
| 97 } | |
| 98 | |
| 99 /** | |
| 100 * Returns whether this is only an optional recommendation and not a mandatory requirement. | |
| 101 * | |
| 102 * @return bool true if optional, false if mandatory | |
| 103 */ | |
| 104 public function isOptional() | |
| 105 { | |
| 106 return $this->optional; | |
| 107 } | |
| 108 } | |
| 109 | |
| 110 /** | |
| 111 * Represents a PHP requirement in form of a php.ini configuration. | |
| 112 * | |
| 113 * @author Tobias Schultze <http://tobion.de> | |
| 114 */ | |
| 115 class PhpIniRequirement extends Requirement | |
| 116 { | |
| 117 /** | |
| 118 * Constructor that initializes the requirement. | |
| 119 * | |
| 120 * @param string $cfgName The configuration name used for ini_get() | |
| 121 * @param bool|callback $evaluation Either a boolean indicating whether the configuration should evaluate to true or false, | |
| 122 or a callback function receiving the configuration value as parameter to determine the fulfillment of the requirement | |
| 123 * @param bool $approveCfgAbsence If true the Requirement will be fulfilled even if the configuration option does not exist, i.e. ini_get() returns false. | |
| 124 This is helpful for abandoned configs in later PHP versions or configs of an optional extension, like Suhosin. | |
| 125 Example: You require a config to be true but PHP later removes this config and defaults it to true internally. | |
| 126 * @param string|null $testMessage The message for testing the requirement (when null and $evaluation is a boolean a default message is derived) | |
| 127 * @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) | |
| 128 * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) | |
| 129 * @param bool $optional Whether this is only an optional recommendation not a mandatory requirement | |
| 130 */ | |
| 131 public function __construct($cfgName, $evaluation, $approveCfgAbsence = false, $testMessage = null, $helpHtml = null, $helpText = null, $optional = false) | |
| 132 { | |
| 133 $cfgValue = ini_get($cfgName); | |
| 134 | |
| 135 if (is_callable($evaluation)) { | |
| 136 if (null === $testMessage || null === $helpHtml) { | |
| 137 throw new InvalidArgumentException('You must provide the parameters testMessage and helpHtml for a callback evaluation.'); | |
| 138 } | |
| 139 | |
| 140 $fulfilled = call_user_func($evaluation, $cfgValue); | |
| 141 } else { | |
| 142 if (null === $testMessage) { | |
| 143 $testMessage = sprintf('%s %s be %s in php.ini', | |
| 144 $cfgName, | |
| 145 $optional ? 'should' : 'must', | |
| 146 $evaluation ? 'enabled' : 'disabled' | |
| 147 ); | |
| 148 } | |
| 149 | |
| 150 if (null === $helpHtml) { | |
| 151 $helpHtml = sprintf('Set <strong>%s</strong> to <strong>%s</strong> in php.ini<a href="#phpini">*</a>.', | |
| 152 $cfgName, | |
| 153 $evaluation ? 'on' : 'off' | |
| 154 ); | |
| 155 } | |
| 156 | |
| 157 $fulfilled = $evaluation == $cfgValue; | |
| 158 } | |
| 159 | |
| 160 parent::__construct($fulfilled || ($approveCfgAbsence && false === $cfgValue), $testMessage, $helpHtml, $helpText, $optional); | |
| 161 } | |
| 162 } | |
| 163 | |
| 164 /** | |
| 165 * A RequirementCollection represents a set of Requirement instances. | |
| 166 * | |
| 167 * @author Tobias Schultze <http://tobion.de> | |
| 168 */ | |
| 169 class RequirementCollection implements IteratorAggregate | |
| 170 { | |
| 171 private $requirements = array(); | |
| 172 | |
| 173 /** | |
| 174 * Gets the current RequirementCollection as an Iterator. | |
| 175 * | |
| 176 * @return Traversable A Traversable interface | |
| 177 */ | |
| 178 public function getIterator() | |
| 179 { | |
| 180 return new ArrayIterator($this->requirements); | |
| 181 } | |
| 182 | |
| 183 /** | |
| 184 * Adds a Requirement. | |
| 185 * | |
| 186 * @param Requirement $requirement A Requirement instance | |
| 187 */ | |
| 188 public function add(Requirement $requirement) | |
| 189 { | |
| 190 $this->requirements[] = $requirement; | |
| 191 } | |
| 192 | |
| 193 /** | |
| 194 * Adds a mandatory requirement. | |
| 195 * | |
| 196 * @param bool $fulfilled Whether the requirement is fulfilled | |
| 197 * @param string $testMessage The message for testing the requirement | |
| 198 * @param string $helpHtml The help text formatted in HTML for resolving the problem | |
| 199 * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) | |
| 200 */ | |
| 201 public function addRequirement($fulfilled, $testMessage, $helpHtml, $helpText = null) | |
| 202 { | |
| 203 $this->add(new Requirement($fulfilled, $testMessage, $helpHtml, $helpText, false)); | |
| 204 } | |
| 205 | |
| 206 /** | |
| 207 * Adds an optional recommendation. | |
| 208 * | |
| 209 * @param bool $fulfilled Whether the recommendation is fulfilled | |
| 210 * @param string $testMessage The message for testing the recommendation | |
| 211 * @param string $helpHtml The help text formatted in HTML for resolving the problem | |
| 212 * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) | |
| 213 */ | |
| 214 public function addRecommendation($fulfilled, $testMessage, $helpHtml, $helpText = null) | |
| 215 { | |
| 216 $this->add(new Requirement($fulfilled, $testMessage, $helpHtml, $helpText, true)); | |
| 217 } | |
| 218 | |
| 219 /** | |
| 220 * Adds a mandatory requirement in form of a php.ini configuration. | |
| 221 * | |
| 222 * @param string $cfgName The configuration name used for ini_get() | |
| 223 * @param bool|callback $evaluation Either a boolean indicating whether the configuration should evaluate to true or false, | |
| 224 or a callback function receiving the configuration value as parameter to determine the fulfillment of the requirement | |
| 225 * @param bool $approveCfgAbsence If true the Requirement will be fulfilled even if the configuration option does not exist, i.e. ini_get() returns false. | |
| 226 This is helpful for abandoned configs in later PHP versions or configs of an optional extension, like Suhosin. | |
| 227 Example: You require a config to be true but PHP later removes this config and defaults it to true internally. | |
| 228 * @param string $testMessage The message for testing the requirement (when null and $evaluation is a boolean a default message is derived) | |
| 229 * @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) | |
| 230 * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) | |
| 231 */ | |
| 232 public function addPhpIniRequirement($cfgName, $evaluation, $approveCfgAbsence = false, $testMessage = null, $helpHtml = null, $helpText = null) | |
| 233 { | |
| 234 $this->add(new PhpIniRequirement($cfgName, $evaluation, $approveCfgAbsence, $testMessage, $helpHtml, $helpText, false)); | |
| 235 } | |
| 236 | |
| 237 /** | |
| 238 * Adds an optional recommendation in form of a php.ini configuration. | |
| 239 * | |
| 240 * @param string $cfgName The configuration name used for ini_get() | |
| 241 * @param bool|callback $evaluation Either a boolean indicating whether the configuration should evaluate to true or false, | |
| 242 or a callback function receiving the configuration value as parameter to determine the fulfillment of the requirement | |
| 243 * @param bool $approveCfgAbsence If true the Requirement will be fulfilled even if the configuration option does not exist, i.e. ini_get() returns false. | |
| 244 This is helpful for abandoned configs in later PHP versions or configs of an optional extension, like Suhosin. | |
| 245 Example: You require a config to be true but PHP later removes this config and defaults it to true internally. | |
| 246 * @param string $testMessage The message for testing the requirement (when null and $evaluation is a boolean a default message is derived) | |
| 247 * @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) | |
| 248 * @param string|null $helpText The help text (when null, it will be inferred from $helpHtml, i.e. stripped from HTML tags) | |
| 249 */ | |
| 250 public function addPhpIniRecommendation($cfgName, $evaluation, $approveCfgAbsence = false, $testMessage = null, $helpHtml = null, $helpText = null) | |
| 251 { | |
| 252 $this->add(new PhpIniRequirement($cfgName, $evaluation, $approveCfgAbsence, $testMessage, $helpHtml, $helpText, true)); | |
| 253 } | |
| 254 | |
| 255 /** | |
| 256 * Adds a requirement collection to the current set of requirements. | |
| 257 * | |
| 258 * @param RequirementCollection $collection A RequirementCollection instance | |
| 259 */ | |
| 260 public function addCollection(RequirementCollection $collection) | |
| 261 { | |
| 262 $this->requirements = array_merge($this->requirements, $collection->all()); | |
| 263 } | |
| 264 | |
| 265 /** | |
| 266 * Returns both requirements and recommendations. | |
| 267 * | |
| 268 * @return array Array of Requirement instances | |
| 269 */ | |
| 270 public function all() | |
| 271 { | |
| 272 return $this->requirements; | |
| 273 } | |
| 274 | |
| 275 /** | |
| 276 * Returns all mandatory requirements. | |
| 277 * | |
| 278 * @return array Array of Requirement instances | |
| 279 */ | |
| 280 public function getRequirements() | |
| 281 { | |
| 282 $array = array(); | |
| 283 foreach ($this->requirements as $req) { | |
| 284 if (!$req->isOptional()) { | |
| 285 $array[] = $req; | |
| 286 } | |
| 287 } | |
| 288 | |
| 289 return $array; | |
| 290 } | |
| 291 | |
| 292 /** | |
| 293 * Returns the mandatory requirements that were not met. | |
| 294 * | |
| 295 * @return array Array of Requirement instances | |
| 296 */ | |
| 297 public function getFailedRequirements() | |
| 298 { | |
| 299 $array = array(); | |
| 300 foreach ($this->requirements as $req) { | |
| 301 if (!$req->isFulfilled() && !$req->isOptional()) { | |
| 302 $array[] = $req; | |
| 303 } | |
| 304 } | |
| 305 | |
| 306 return $array; | |
| 307 } | |
| 308 | |
| 309 /** | |
| 310 * Returns all optional recommendations. | |
| 311 * | |
| 312 * @return array Array of Requirement instances | |
| 313 */ | |
| 314 public function getRecommendations() | |
| 315 { | |
| 316 $array = array(); | |
| 317 foreach ($this->requirements as $req) { | |
| 318 if ($req->isOptional()) { | |
| 319 $array[] = $req; | |
| 320 } | |
| 321 } | |
| 322 | |
| 323 return $array; | |
| 324 } | |
| 325 | |
| 326 /** | |
| 327 * Returns the recommendations that were not met. | |
| 328 * | |
| 329 * @return array Array of Requirement instances | |
| 330 */ | |
| 331 public function getFailedRecommendations() | |
| 332 { | |
| 333 $array = array(); | |
| 334 foreach ($this->requirements as $req) { | |
| 335 if (!$req->isFulfilled() && $req->isOptional()) { | |
| 336 $array[] = $req; | |
| 337 } | |
| 338 } | |
| 339 | |
| 340 return $array; | |
| 341 } | |
| 342 | |
| 343 /** | |
| 344 * Returns whether a php.ini configuration is not correct. | |
| 345 * | |
| 346 * @return bool php.ini configuration problem? | |
| 347 */ | |
| 348 public function hasPhpIniConfigIssue() | |
| 349 { | |
| 350 foreach ($this->requirements as $req) { | |
| 351 if (!$req->isFulfilled() && $req instanceof PhpIniRequirement) { | |
| 352 return true; | |
| 353 } | |
| 354 } | |
| 355 | |
| 356 return false; | |
| 357 } | |
| 358 | |
| 359 /** | |
| 360 * Returns the PHP configuration file (php.ini) path. | |
| 361 * | |
| 362 * @return string|false php.ini file path | |
| 363 */ | |
| 364 public function getPhpIniConfigPath() | |
| 365 { | |
| 366 return get_cfg_var('cfg_file_path'); | |
| 367 } | |
| 368 } | |
| 369 | |
| 370 /** | |
| 371 * This class specifies all requirements and optional recommendations that | |
| 372 * are necessary to run the Symfony Standard Edition. | |
| 373 * | |
| 374 * @author Tobias Schultze <http://tobion.de> | |
| 375 * @author Fabien Potencier <fabien@symfony.com> | |
| 376 */ | |
| 377 class SymfonyRequirements extends RequirementCollection | |
| 378 { | |
| 379 const REQUIRED_PHP_VERSION = '5.3.3'; | |
| 380 | |
| 381 /** | |
| 382 * Constructor that initializes the requirements. | |
| 383 */ | |
| 384 public function __construct() | |
| 385 { | |
| 386 /* mandatory requirements follow */ | |
| 387 | |
| 388 $installedPhpVersion = phpversion(); | |
| 389 | |
| 390 $this->addRequirement( | |
| 391 version_compare($installedPhpVersion, self::REQUIRED_PHP_VERSION, '>='), | |
| 392 sprintf('PHP version must be at least %s (%s installed)', self::REQUIRED_PHP_VERSION, $installedPhpVersion), | |
| 393 sprintf('You are running PHP version "<strong>%s</strong>", but Symfony needs at least PHP "<strong>%s</strong>" to run. | |
| 394 Before using Symfony, upgrade your PHP installation, preferably to the latest version.', | |
| 395 $installedPhpVersion, self::REQUIRED_PHP_VERSION), | |
| 396 sprintf('Install PHP %s or newer (installed version is %s)', self::REQUIRED_PHP_VERSION, $installedPhpVersion) | |
| 397 ); | |
| 398 | |
| 399 $this->addRequirement( | |
| 400 version_compare($installedPhpVersion, '5.3.16', '!='), | |
| 401 'PHP version must not be 5.3.16 as Symfony won\'t work properly with it', | |
| 402 'Install PHP 5.3.17 or newer (or downgrade to an earlier PHP version)' | |
| 403 ); | |
| 404 | |
| 405 $this->addRequirement( | |
| 406 is_dir(__DIR__.'/../vendor/composer'), | |
| 407 'Vendor libraries must be installed', | |
| 408 'Vendor libraries are missing. Install composer following instructions from <a href="http://getcomposer.org/">http://getcomposer.org/</a>. '. | |
| 409 'Then run "<strong>php composer.phar install</strong>" to install them.' | |
| 410 ); | |
| 411 | |
| 412 $cacheDir = is_dir(__DIR__.'/../var/cache') ? __DIR__.'/../var/cache' : __DIR__.'/cache'; | |
| 413 | |
| 414 $this->addRequirement( | |
| 415 is_writable($cacheDir), | |
| 416 'app/cache/ or var/cache/ directory must be writable', | |
| 417 'Change the permissions of either "<strong>app/cache/</strong>" or "<strong>var/cache/</strong>" directory so that the web server can write into it.' | |
| 418 ); | |
| 419 | |
| 420 $logsDir = is_dir(__DIR__.'/../var/logs') ? __DIR__.'/../var/logs' : __DIR__.'/logs'; | |
| 421 | |
| 422 $this->addRequirement( | |
| 423 is_writable($logsDir), | |
| 424 'app/logs/ or var/logs/ directory must be writable', | |
| 425 'Change the permissions of either "<strong>app/logs/</strong>" or "<strong>var/logs/</strong>" directory so that the web server can write into it.' | |
| 426 ); | |
| 427 | |
| 428 $this->addPhpIniRequirement( | |
| 429 'date.timezone', true, false, | |
| 430 'date.timezone setting must be set', | |
| 431 'Set the "<strong>date.timezone</strong>" setting in php.ini<a href="#phpini">*</a> (like Europe/Paris).' | |
| 432 ); | |
| 433 | |
| 434 if (version_compare($installedPhpVersion, self::REQUIRED_PHP_VERSION, '>=')) { | |
| 435 $timezones = array(); | |
| 436 foreach (DateTimeZone::listAbbreviations() as $abbreviations) { | |
| 437 foreach ($abbreviations as $abbreviation) { | |
| 438 $timezones[$abbreviation['timezone_id']] = true; | |
| 439 } | |
| 440 } | |
| 441 | |
| 442 $this->addRequirement( | |
| 443 isset($timezones[@date_default_timezone_get()]), | |
| 444 sprintf('Configured default timezone "%s" must be supported by your installation of PHP', @date_default_timezone_get()), | |
| 445 '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>.' | |
| 446 ); | |
| 447 } | |
| 448 | |
| 449 $this->addRequirement( | |
| 450 function_exists('json_encode'), | |
| 451 'json_encode() must be available', | |
| 452 'Install and enable the <strong>JSON</strong> extension.' | |
| 453 ); | |
| 454 | |
| 455 $this->addRequirement( | |
| 456 function_exists('session_start'), | |
| 457 'session_start() must be available', | |
| 458 'Install and enable the <strong>session</strong> extension.' | |
| 459 ); | |
| 460 | |
| 461 $this->addRequirement( | |
| 462 function_exists('ctype_alpha'), | |
| 463 'ctype_alpha() must be available', | |
| 464 'Install and enable the <strong>ctype</strong> extension.' | |
| 465 ); | |
| 466 | |
| 467 $this->addRequirement( | |
| 468 function_exists('token_get_all'), | |
| 469 'token_get_all() must be available', | |
| 470 'Install and enable the <strong>Tokenizer</strong> extension.' | |
| 471 ); | |
| 472 | |
| 473 $this->addRequirement( | |
| 474 function_exists('simplexml_import_dom'), | |
| 475 'simplexml_import_dom() must be available', | |
| 476 'Install and enable the <strong>SimpleXML</strong> extension.' | |
| 477 ); | |
| 478 | |
| 479 if (function_exists('apc_store') && ini_get('apc.enabled')) { | |
| 480 if (version_compare($installedPhpVersion, '5.4.0', '>=')) { | |
| 481 $this->addRequirement( | |
| 482 version_compare(phpversion('apc'), '3.1.13', '>='), | |
| 483 'APC version must be at least 3.1.13 when using PHP 5.4', | |
| 484 'Upgrade your <strong>APC</strong> extension (3.1.13+).' | |
| 485 ); | |
| 486 } else { | |
| 487 $this->addRequirement( | |
| 488 version_compare(phpversion('apc'), '3.0.17', '>='), | |
| 489 'APC version must be at least 3.0.17', | |
| 490 'Upgrade your <strong>APC</strong> extension (3.0.17+).' | |
| 491 ); | |
| 492 } | |
| 493 } | |
| 494 | |
| 495 $this->addPhpIniRequirement('detect_unicode', false); | |
| 496 | |
| 497 if (extension_loaded('suhosin')) { | |
| 498 $this->addPhpIniRequirement( | |
| 499 'suhosin.executor.include.whitelist', | |
| 500 create_function('$cfgValue', 'return false !== stripos($cfgValue, "phar");'), | |
| 501 false, | |
| 502 'suhosin.executor.include.whitelist must be configured correctly in php.ini', | |
| 503 'Add "<strong>phar</strong>" to <strong>suhosin.executor.include.whitelist</strong> in php.ini<a href="#phpini">*</a>.' | |
| 504 ); | |
| 505 } | |
| 506 | |
| 507 if (extension_loaded('xdebug')) { | |
| 508 $this->addPhpIniRequirement( | |
| 509 'xdebug.show_exception_trace', false, true | |
| 510 ); | |
| 511 | |
| 512 $this->addPhpIniRequirement( | |
| 513 'xdebug.scream', false, true | |
| 514 ); | |
| 515 | |
| 516 $this->addPhpIniRecommendation( | |
| 517 'xdebug.max_nesting_level', | |
| 518 create_function('$cfgValue', 'return $cfgValue > 100;'), | |
| 519 true, | |
| 520 'xdebug.max_nesting_level should be above 100 in php.ini', | |
| 521 '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.' | |
| 522 ); | |
| 523 } | |
| 524 | |
| 525 $pcreVersion = defined('PCRE_VERSION') ? (float) PCRE_VERSION : null; | |
| 526 | |
| 527 $this->addRequirement( | |
| 528 null !== $pcreVersion, | |
| 529 'PCRE extension must be available', | |
| 530 'Install the <strong>PCRE</strong> extension (version 8.0+).' | |
| 531 ); | |
| 532 | |
| 533 if (extension_loaded('mbstring')) { | |
| 534 $this->addPhpIniRequirement( | |
| 535 'mbstring.func_overload', | |
| 536 create_function('$cfgValue', 'return (int) $cfgValue === 0;'), | |
| 537 true, | |
| 538 'string functions should not be overloaded', | |
| 539 '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.' | |
| 540 ); | |
| 541 } | |
| 542 | |
| 543 /* optional recommendations follow */ | |
| 544 | |
| 545 $this->addRecommendation( | |
| 546 file_get_contents(__FILE__) === file_get_contents(__DIR__.'/../vendor/sensio/distribution-bundle/Sensio/Bundle/DistributionBundle/Resources/skeleton/app/SymfonyRequirements.php'), | |
| 547 'Requirements file should be up-to-date', | |
| 548 'Your requirements file is outdated. Run composer install and re-check your configuration.' | |
| 549 ); | |
| 550 | |
| 551 $this->addRecommendation( | |
| 552 version_compare($installedPhpVersion, '5.3.4', '>='), | |
| 553 'You should use at least PHP 5.3.4 due to PHP bug #52083 in earlier versions', | |
| 554 '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.' | |
| 555 ); | |
| 556 | |
| 557 $this->addRecommendation( | |
| 558 version_compare($installedPhpVersion, '5.3.8', '>='), | |
| 559 'When using annotations you should have at least PHP 5.3.8 due to PHP bug #55156', | |
| 560 'Install PHP 5.3.8 or newer if your project uses annotations.' | |
| 561 ); | |
| 562 | |
| 563 $this->addRecommendation( | |
| 564 version_compare($installedPhpVersion, '5.4.0', '!='), | |
| 565 'You should not use PHP 5.4.0 due to the PHP bug #61453', | |
| 566 '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.' | |
| 567 ); | |
| 568 | |
| 569 $this->addRecommendation( | |
| 570 version_compare($installedPhpVersion, '5.4.11', '>='), | |
| 571 '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)', | |
| 572 'Install PHP 5.4.11 or newer if your project uses the logout handler from the Symfony Security Component.' | |
| 573 ); | |
| 574 | |
| 575 $this->addRecommendation( | |
| 576 (version_compare($installedPhpVersion, '5.3.18', '>=') && version_compare($installedPhpVersion, '5.4.0', '<')) | |
| 577 || | |
| 578 version_compare($installedPhpVersion, '5.4.8', '>='), | |
| 579 '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', | |
| 580 'Install PHP 5.3.18+ or PHP 5.4.8+ if you want nice error messages for all fatal errors in the development environment.' | |
| 581 ); | |
| 582 | |
| 583 if (null !== $pcreVersion) { | |
| 584 $this->addRecommendation( | |
| 585 $pcreVersion >= 8.0, | |
| 586 sprintf('PCRE extension should be at least version 8.0 (%s installed)', $pcreVersion), | |
| 587 '<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.' | |
| 588 ); | |
| 589 } | |
| 590 | |
| 591 $this->addRecommendation( | |
| 592 class_exists('DomDocument'), | |
| 593 'PHP-DOM and PHP-XML modules should be installed', | |
| 594 'Install and enable the <strong>PHP-DOM</strong> and the <strong>PHP-XML</strong> modules.' | |
| 595 ); | |
| 596 | |
| 597 $this->addRecommendation( | |
| 598 function_exists('mb_strlen'), | |
| 599 'mb_strlen() should be available', | |
| 600 'Install and enable the <strong>mbstring</strong> extension.' | |
| 601 ); | |
| 602 | |
| 603 $this->addRecommendation( | |
| 604 function_exists('iconv'), | |
| 605 'iconv() should be available', | |
| 606 'Install and enable the <strong>iconv</strong> extension.' | |
| 607 ); | |
| 608 | |
| 609 $this->addRecommendation( | |
| 610 function_exists('utf8_decode'), | |
| 611 'utf8_decode() should be available', | |
| 612 'Install and enable the <strong>XML</strong> extension.' | |
| 613 ); | |
| 614 | |
| 615 $this->addRecommendation( | |
| 616 function_exists('filter_var'), | |
| 617 'filter_var() should be available', | |
| 618 'Install and enable the <strong>filter</strong> extension.' | |
| 619 ); | |
| 620 | |
| 621 if (!defined('PHP_WINDOWS_VERSION_BUILD')) { | |
| 622 $this->addRecommendation( | |
| 623 function_exists('posix_isatty'), | |
| 624 'posix_isatty() should be available', | |
| 625 'Install and enable the <strong>php_posix</strong> extension (used to colorize the CLI output).' | |
| 626 ); | |
| 627 } | |
| 628 | |
| 629 $this->addRecommendation( | |
| 630 class_exists('Locale'), | |
| 631 'intl extension should be available', | |
| 632 'Install and enable the <strong>intl</strong> extension (used for validators).' | |
| 633 ); | |
| 634 | |
| 635 if (class_exists('Collator')) { | |
| 636 $this->addRecommendation( | |
| 637 null !== new Collator('fr_FR'), | |
| 638 'intl extension should be correctly configured', | |
| 639 'The intl extension does not behave properly. This problem is typical on PHP 5.3.X x64 WIN builds.' | |
| 640 ); | |
| 641 } | |
| 642 | |
| 643 if (class_exists('Locale')) { | |
| 644 if (defined('INTL_ICU_VERSION')) { | |
| 645 $version = INTL_ICU_VERSION; | |
| 646 } else { | |
| 647 $reflector = new ReflectionExtension('intl'); | |
| 648 | |
| 649 ob_start(); | |
| 650 $reflector->info(); | |
| 651 $output = strip_tags(ob_get_clean()); | |
| 652 | |
| 653 preg_match('/^ICU version +(?:=> )?(.*)$/m', $output, $matches); | |
| 654 $version = $matches[1]; | |
| 655 } | |
| 656 | |
| 657 $this->addRecommendation( | |
| 658 version_compare($version, '4.0', '>='), | |
| 659 'intl ICU version should be at least 4+', | |
| 660 'Upgrade your <strong>intl</strong> extension with a newer ICU version (4+).' | |
| 661 ); | |
| 662 } | |
| 663 | |
| 664 $accelerator = | |
| 665 (extension_loaded('eaccelerator') && ini_get('eaccelerator.enable')) | |
| 666 || | |
| 667 (extension_loaded('apc') && ini_get('apc.enabled')) | |
| 668 || | |
| 669 (extension_loaded('Zend Optimizer+') && ini_get('zend_optimizerplus.enable')) | |
| 670 || | |
| 671 (extension_loaded('Zend OPcache') && ini_get('opcache.enable')) | |
| 672 || | |
| 673 (extension_loaded('xcache') && ini_get('xcache.cacher')) | |
| 674 || | |
| 675 (extension_loaded('wincache') && ini_get('wincache.ocenabled')) | |
| 676 ; | |
| 677 | |
| 678 $this->addRecommendation( | |
| 679 $accelerator, | |
| 680 'a PHP accelerator should be installed', | |
| 681 'Install and/or enable a <strong>PHP accelerator</strong> (highly recommended).' | |
| 682 ); | |
| 683 | |
| 684 if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') { | |
| 685 $this->addRecommendation( | |
| 686 $this->getRealpathCacheSize() > 1000, | |
| 687 'realpath_cache_size should be above 1024 in php.ini', | |
| 688 'Set "<strong>realpath_cache_size</strong>" to e.g. "<strong>1024</strong>" in php.ini<a href="#phpini">*</a> to improve performance on windows.' | |
| 689 ); | |
| 690 } | |
| 691 | |
| 692 $this->addPhpIniRecommendation('short_open_tag', false); | |
| 693 | |
| 694 $this->addPhpIniRecommendation('magic_quotes_gpc', false, true); | |
| 695 | |
| 696 $this->addPhpIniRecommendation('register_globals', false, true); | |
| 697 | |
| 698 $this->addPhpIniRecommendation('session.auto_start', false); | |
| 699 | |
| 700 $this->addRecommendation( | |
| 701 class_exists('PDO'), | |
| 702 'PDO should be installed', | |
| 703 'Install <strong>PDO</strong> (mandatory for Doctrine).' | |
| 704 ); | |
| 705 | |
| 706 if (class_exists('PDO')) { | |
| 707 $drivers = PDO::getAvailableDrivers(); | |
| 708 $this->addRecommendation( | |
| 709 count($drivers) > 0, | |
| 710 sprintf('PDO should have some drivers installed (currently available: %s)', count($drivers) ? implode(', ', $drivers) : 'none'), | |
| 711 'Install <strong>PDO drivers</strong> (mandatory for Doctrine).' | |
| 712 ); | |
| 713 } | |
| 714 } | |
| 715 | |
| 716 /** | |
| 717 * Loads realpath_cache_size from php.ini and converts it to int. | |
| 718 * | |
| 719 * (e.g. 16k is converted to 16384 int) | |
| 720 * | |
| 721 * @return int | |
| 722 */ | |
| 723 protected function getRealpathCacheSize() | |
| 724 { | |
| 725 $size = ini_get('realpath_cache_size'); | |
| 726 $size = trim($size); | |
| 727 $unit = strtolower(substr($size, -1, 1)); | |
| 728 switch ($unit) { | |
| 729 case 'g': | |
| 730 return $size * 1024 * 1024 * 1024; | |
| 731 case 'm': | |
| 732 return $size * 1024 * 1024; | |
| 733 case 'k': | |
| 734 return $size * 1024; | |
| 735 default: | |
| 736 return (int) $size; | |
| 737 } | |
| 738 } | |
| 739 } | 
