app/SymfonyRequirements.php

   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 Boolean     $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 Boolean     $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 = (Boolean) $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 = (Boolean) $optional;
  57     }
  58
  59     /**
  60      * Returns whether the requirement is fulfilled.
  61      *
  62      * @return Boolean 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 Boolean 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 Boolean|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 Boolean $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 Boolean     $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 Boolean     $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 Boolean     $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 Boolean|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 Boolean $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 Boolean|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 Boolean $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 Boolean 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         $baseDir = basename(__DIR__);
 413
 414         $this->addRequirement(
 415             is_writable(__DIR__.'/cache'),
 416             "$baseDir/cache/ directory must be writable",
 417             "Change the permissions of the \"<strong>$baseDir/cache/</strong>\" directory so that the web server can write into it."
 418         );
 419
 420         $this->addRequirement(
 421             is_writable(__DIR__.'/logs'),
 422             "$baseDir/logs/ directory must be writable",
 423             "Change the permissions of the \"<strong>$baseDir/logs/</strong>\" directory so that the web server can write into it."
 424         );
 425
 426         $this->addPhpIniRequirement(
 427             'date.timezone', true, false,
 428             'date.timezone setting must be set',
 429             'Set the "<strong>date.timezone</strong>" setting in php.ini<a href="#phpini">*</a> (like Europe/Paris).'
 430         );
 431
 432         if (version_compare($installedPhpVersion, self::REQUIRED_PHP_VERSION, '>=')) {
 433             $timezones = array();
 434             foreach (DateTimeZone::listAbbreviations() as $abbreviations) {
 435                 foreach ($abbreviations as $abbreviation) {
 436                     $timezones[$abbreviation['timezone_id']] = true;
 437                 }
 438             }
 439
 440             $this->addRequirement(
 441                 isset($timezones[date_default_timezone_get()]),
 442                 sprintf('Configured default timezone "%s" must be supported by your installation of PHP', date_default_timezone_get()),
 443                 '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>.'
 444             );
 445         }
 446
 447         $this->addRequirement(
 448             function_exists('json_encode'),
 449             'json_encode() must be available',
 450             'Install and enable the <strong>JSON</strong> extension.'
 451         );
 452
 453         $this->addRequirement(
 454             function_exists('session_start'),
 455             'session_start() must be available',
 456             'Install and enable the <strong>session</strong> extension.'
 457         );
 458
 459         $this->addRequirement(
 460             function_exists('ctype_alpha'),
 461             'ctype_alpha() must be available',
 462             'Install and enable the <strong>ctype</strong> extension.'
 463         );
 464
 465         $this->addRequirement(
 466             function_exists('token_get_all'),
 467             'token_get_all() must be available',
 468             'Install and enable the <strong>Tokenizer</strong> extension.'
 469         );
 470
 471         $this->addRequirement(
 472             function_exists('simplexml_import_dom'),
 473             'simplexml_import_dom() must be available',
 474             'Install and enable the <strong>SimpleXML</strong> extension.'
 475         );
 476
 477         if (function_exists('apc_store') && ini_get('apc.enabled')) {
 478             if (version_compare($installedPhpVersion, '5.4.0', '>=')) {
 479                 $this->addRequirement(
 480                     version_compare(phpversion('apc'), '3.1.13', '>='),
 481                     'APC version must be at least 3.1.13 when using PHP 5.4',
 482                     'Upgrade your <strong>APC</strong> extension (3.1.13+).'
 483                 );
 484             } else {
 485                 $this->addRequirement(
 486                     version_compare(phpversion('apc'), '3.0.17', '>='),
 487                     'APC version must be at least 3.0.17',
 488                     'Upgrade your <strong>APC</strong> extension (3.0.17+).'
 489                 );
 490             }
 491         }
 492
 493         $this->addPhpIniRequirement('detect_unicode', false);
 494
 495         if (extension_loaded('suhosin')) {
 496             $this->addPhpIniRequirement(
 497                 'suhosin.executor.include.whitelist',
 498                 create_function('$cfgValue', 'return false !== stripos($cfgValue, "phar");'),
 499                 false,
 500                 'suhosin.executor.include.whitelist must be configured correctly in php.ini',
 501                 'Add "<strong>phar</strong>" to <strong>suhosin.executor.include.whitelist</strong> in php.ini<a href="#phpini">*</a>.'
 502             );
 503         }
 504
 505         if (extension_loaded('xdebug')) {
 506             $this->addPhpIniRequirement(
 507                 'xdebug.show_exception_trace', false, true
 508             );
 509
 510             $this->addPhpIniRequirement(
 511                 'xdebug.scream', false, true
 512             );
 513
 514             $this->addPhpIniRecommendation(
 515                 'xdebug.max_nesting_level',
 516                 create_function('$cfgValue', 'return $cfgValue > 100;'),
 517                 true,
 518                 'xdebug.max_nesting_level should be above 100 in php.ini',
 519                 '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.'
 520             );
 521         }
 522
 523         $pcreVersion = defined('PCRE_VERSION') ? (float) PCRE_VERSION : null;
 524
 525         $this->addRequirement(
 526             null !== $pcreVersion,
 527             'PCRE extension must be available',
 528             'Install the <strong>PCRE</strong> extension (version 8.0+).'
 529         );
 530
 531         /* optional recommendations follow */
 532
 533         $this->addRecommendation(
 534             file_get_contents(__FILE__) === file_get_contents(__DIR__.'/../vendor/sensio/distribution-bundle/Sensio/Bundle/DistributionBundle/Resources/skeleton/app/SymfonyRequirements.php'),
 535             'Requirements file should be up-to-date',
 536             'Your requirements file is outdated. Run composer install and re-check your configuration.'
 537         );
 538
 539         $this->addRecommendation(
 540             version_compare($installedPhpVersion, '5.3.4', '>='),
 541             'You should use at least PHP 5.3.4 due to PHP bug #52083 in earlier versions',
 542             '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.'
 543         );
 544
 545         $this->addRecommendation(
 546             version_compare($installedPhpVersion, '5.3.8', '>='),
 547             'When using annotations you should have at least PHP 5.3.8 due to PHP bug #55156',
 548             'Install PHP 5.3.8 or newer if your project uses annotations.'
 549         );
 550
 551         $this->addRecommendation(
 552             version_compare($installedPhpVersion, '5.4.0', '!='),
 553             'You should not use PHP 5.4.0 due to the PHP bug #61453',
 554             '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.'
 555         );
 556
 557         $this->addRecommendation(
 558             version_compare($installedPhpVersion, '5.4.11', '>='),
 559             '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)',
 560             'Install PHP 5.4.11 or newer if your project uses the logout handler from the Symfony Security Component.'
 561         );
 562
 563         $this->addRecommendation(
 564             (version_compare($installedPhpVersion, '5.3.18', '>=') && version_compare($installedPhpVersion, '5.4.0', '<'))
 565             ||
 566             version_compare($installedPhpVersion, '5.4.8', '>='),
 567             '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',
 568             'Install PHP 5.3.18+ or PHP 5.4.8+ if you want nice error messages for all fatal errors in the development environment.'
 569         );
 570
 571         if (null !== $pcreVersion) {
 572             $this->addRecommendation(
 573                 $pcreVersion >= 8.0,
 574                 sprintf('PCRE extension should be at least version 8.0 (%s installed)', $pcreVersion),
 575                 '<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.'
 576             );
 577         }
 578
 579         $this->addRecommendation(
 580             class_exists('DomDocument'),
 581             'PHP-XML module should be installed',
 582             'Install and enable the <strong>PHP-XML</strong> module.'
 583         );
 584
 585         $this->addRecommendation(
 586             function_exists('mb_strlen'),
 587             'mb_strlen() should be available',
 588             'Install and enable the <strong>mbstring</strong> extension.'
 589         );
 590
 591         $this->addRecommendation(
 592             function_exists('iconv'),
 593             'iconv() should be available',
 594             'Install and enable the <strong>iconv</strong> extension.'
 595         );
 596
 597         $this->addRecommendation(
 598             function_exists('utf8_decode'),
 599             'utf8_decode() should be available',
 600             'Install and enable the <strong>XML</strong> extension.'
 601         );
 602
 603         if (!defined('PHP_WINDOWS_VERSION_BUILD')) {
 604             $this->addRecommendation(
 605                 function_exists('posix_isatty'),
 606                 'posix_isatty() should be available',
 607                 'Install and enable the <strong>php_posix</strong> extension (used to colorize the CLI output).'
 608             );
 609         }
 610
 611         $this->addRecommendation(
 612             class_exists('Locale'),
 613             'intl extension should be available',
 614             'Install and enable the <strong>intl</strong> extension (used for validators).'
 615         );
 616
 617         if (class_exists('Collator')) {
 618             $this->addRecommendation(
 619                 null !== new Collator('fr_FR'),
 620                 'intl extension should be correctly configured',
 621                 'The intl extension does not behave properly. This problem is typical on PHP 5.3.X x64 WIN builds.'
 622             );
 623         }
 624
 625         if (class_exists('Locale')) {
 626             if (defined('INTL_ICU_VERSION')) {
 627                 $version = INTL_ICU_VERSION;
 628             } else {
 629                 $reflector = new ReflectionExtension('intl');
 630
 631                 ob_start();
 632                 $reflector->info();
 633                 $output = strip_tags(ob_get_clean());
 634
 635                 preg_match('/^ICU version +(?:=> )?(.*)$/m', $output, $matches);
 636                 $version = $matches[1];
 637             }
 638
 639             $this->addRecommendation(
 640                 version_compare($version, '4.0', '>='),
 641                 'intl ICU version should be at least 4+',
 642                 'Upgrade your <strong>intl</strong> extension with a newer ICU version (4+).'
 643             );
 644         }
 645
 646         $accelerator =
 647             (extension_loaded('eaccelerator') && ini_get('eaccelerator.enable'))
 648             ||
 649             (extension_loaded('apc') && ini_get('apc.enabled'))
 650             ||
 651             (extension_loaded('Zend OPcache') && ini_get('opcache.enable'))
 652             ||
 653             (extension_loaded('xcache') && ini_get('xcache.cacher'))
 654             ||
 655             (extension_loaded('wincache') && ini_get('wincache.ocenabled'))
 656         ;
 657
 658         $this->addRecommendation(
 659             $accelerator,
 660             'a PHP accelerator should be installed',
 661             'Install and enable a <strong>PHP accelerator</strong> like APC (highly recommended).'
 662         );
 663
 664         $this->addPhpIniRecommendation('short_open_tag', false);
 665
 666         $this->addPhpIniRecommendation('magic_quotes_gpc', false, true);
 667
 668         $this->addPhpIniRecommendation('register_globals', false, true);
 669
 670         $this->addPhpIniRecommendation('session.auto_start', false);
 671
 672         $this->addRecommendation(
 673             class_exists('PDO'),
 674             'PDO should be installed',
 675             'Install <strong>PDO</strong> (mandatory for Doctrine).'
 676         );
 677
 678         if (class_exists('PDO')) {
 679             $drivers = PDO::getAvailableDrivers();
 680             $this->addRecommendation(
 681                 count($drivers),
 682                 sprintf('PDO should have some drivers installed (currently available: %s)', count($drivers) ? implode(', ', $drivers) : 'none'),
 683                 'Install <strong>PDO drivers</strong> (mandatory for Doctrine).'
 684             );
 685         }
 686     }
 687 }