Kernel.php

Namespace

Symfony\Component\HttpKernel

File

drupal/core/vendor/symfony/http-kernel/Symfony/Component/HttpKernel/Kernel.php
View source
<?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.
 */
namespace Symfony\Component\HttpKernel;

use Symfony\Bridge\ProxyManager\LazyProxy\Instantiator\RuntimeInstantiator;
use Symfony\Bridge\ProxyManager\LazyProxy\PhpDumper\ProxyDumper;
use Symfony\Component\DependencyInjection\ContainerInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\DependencyInjection\Dumper\PhpDumper;
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag;
use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
use Symfony\Component\DependencyInjection\Loader\IniFileLoader;
use Symfony\Component\DependencyInjection\Loader\PhpFileLoader;
use Symfony\Component\DependencyInjection\Loader\ClosureLoader;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\HttpKernelInterface;
use Symfony\Component\HttpKernel\Bundle\BundleInterface;
use Symfony\Component\HttpKernel\Config\FileLocator;
use Symfony\Component\HttpKernel\DependencyInjection\MergeExtensionConfigurationPass;
use Symfony\Component\HttpKernel\DependencyInjection\AddClassesToCachePass;
use Symfony\Component\Config\Loader\LoaderResolver;
use Symfony\Component\Config\Loader\DelegatingLoader;
use Symfony\Component\Config\ConfigCache;
use Symfony\Component\ClassLoader\ClassCollectionLoader;

/**
 * The Kernel is the heart of the Symfony system.
 *
 * It manages an environment made of bundles.
 *
 * @author Fabien Potencier <fabien@symfony.com>
 *
 * @api
 */
abstract class Kernel implements KernelInterface, TerminableInterface {

  /**
   * @var BundleInterface[]
   */
  protected $bundles;
  protected $bundleMap;
  protected $container;
  protected $rootDir;
  protected $environment;
  protected $debug;
  protected $booted;
  protected $name;
  protected $startTime;
  protected $classes;
  protected $loadClassCache;
  const VERSION = '2.3.0';
  const VERSION_ID = '20300';
  const MAJOR_VERSION = '2';
  const MINOR_VERSION = '3';
  const RELEASE_VERSION = '0';
  const EXTRA_VERSION = '';

  /**
   * Constructor.
   *
   * @param string  $environment The environment
   * @param Boolean $debug       Whether to enable debugging or not
   *
   * @api
   */
  public function __construct($environment, $debug) {
    $this->environment = $environment;
    $this->debug = (bool) $debug;
    $this->booted = false;
    $this->rootDir = $this
      ->getRootDir();
    $this->name = $this
      ->getName();
    $this->classes = array();
    $this->bundles = array();
    if ($this->debug) {
      $this->startTime = microtime(true);
    }
    $this
      ->init();
  }

  /**
   * @deprecated Deprecated since version 2.3, to be removed in 3.0. Move your logic in the constructor instead.
   */
  public function init() {
  }
  public function __clone() {
    if ($this->debug) {
      $this->startTime = microtime(true);
    }
    $this->booted = false;
    $this->container = null;
  }

  /**
   * Boots the current kernel.
   *
   * @api
   */
  public function boot() {
    if (true === $this->booted) {
      return;
    }
    if ($this->loadClassCache) {
      $this
        ->doLoadClassCache($this->loadClassCache[0], $this->loadClassCache[1]);
    }

    // init bundles
    $this
      ->initializeBundles();

    // init container
    $this
      ->initializeContainer();
    foreach ($this
      ->getBundles() as $bundle) {
      $bundle
        ->setContainer($this->container);
      $bundle
        ->boot();
    }
    $this->booted = true;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function terminate(Request $request, Response $response) {
    if (false === $this->booted) {
      return;
    }
    if ($this
      ->getHttpKernel() instanceof TerminableInterface) {
      $this
        ->getHttpKernel()
        ->terminate($request, $response);
    }
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function shutdown() {
    if (false === $this->booted) {
      return;
    }
    $this->booted = false;
    foreach ($this
      ->getBundles() as $bundle) {
      $bundle
        ->shutdown();
      $bundle
        ->setContainer(null);
    }
    $this->container = null;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function handle(Request $request, $type = HttpKernelInterface::MASTER_REQUEST, $catch = true) {
    if (false === $this->booted) {
      $this
        ->boot();
    }
    return $this
      ->getHttpKernel()
      ->handle($request, $type, $catch);
  }

  /**
   * Gets a http kernel from the container
   *
   * @return HttpKernel
   */
  protected function getHttpKernel() {
    return $this->container
      ->get('http_kernel');
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getBundles() {
    return $this->bundles;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function isClassInActiveBundle($class) {
    foreach ($this
      ->getBundles() as $bundle) {
      if (0 === strpos($class, $bundle
        ->getNamespace())) {
        return true;
      }
    }
    return false;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getBundle($name, $first = true) {
    if (!isset($this->bundleMap[$name])) {
      throw new \InvalidArgumentException(sprintf('Bundle "%s" does not exist or it is not enabled. Maybe you forgot to add it in the registerBundles() method of your %s.php file?', $name, get_class($this)));
    }
    if (true === $first) {
      return $this->bundleMap[$name][0];
    }
    return $this->bundleMap[$name];
  }

  /**
   * Returns the file path for a given resource.
   *
   * A Resource can be a file or a directory.
   *
   * The resource name must follow the following pattern:
   *
   *     @<BundleName>/path/to/a/file.something
   *
   * where BundleName is the name of the bundle
   * and the remaining part is the relative path in the bundle.
   *
   * If $dir is passed, and the first segment of the path is "Resources",
   * this method will look for a file named:
   *
   *     $dir/<BundleName>/path/without/Resources
   *
   * before looking in the bundle resource folder.
   *
   * @param string  $name  A resource name to locate
   * @param string  $dir   A directory where to look for the resource first
   * @param Boolean $first Whether to return the first path or paths for all matching bundles
   *
   * @return string|array The absolute path of the resource or an array if $first is false
   *
   * @throws \InvalidArgumentException if the file cannot be found or the name is not valid
   * @throws \RuntimeException         if the name contains invalid/unsafe
   * @throws \RuntimeException         if a custom resource is hidden by a resource in a derived bundle
   *
   * @api
   */
  public function locateResource($name, $dir = null, $first = true) {
    if ('@' !== $name[0]) {
      throw new \InvalidArgumentException(sprintf('A resource name must start with @ ("%s" given).', $name));
    }
    if (false !== strpos($name, '..')) {
      throw new \RuntimeException(sprintf('File name "%s" contains invalid characters (..).', $name));
    }
    $bundleName = substr($name, 1);
    $path = '';
    if (false !== strpos($bundleName, '/')) {
      list($bundleName, $path) = explode('/', $bundleName, 2);
    }
    $isResource = 0 === strpos($path, 'Resources') && null !== $dir;
    $overridePath = substr($path, 9);
    $resourceBundle = null;
    $bundles = $this
      ->getBundle($bundleName, false);
    $files = array();
    foreach ($bundles as $bundle) {
      if ($isResource && file_exists($file = $dir . '/' . $bundle
        ->getName() . $overridePath)) {
        if (null !== $resourceBundle) {
          throw new \RuntimeException(sprintf('"%s" resource is hidden by a resource from the "%s" derived bundle. Create a "%s" file to override the bundle resource.', $file, $resourceBundle, $dir . '/' . $bundles[0]
            ->getName() . $overridePath));
        }
        if ($first) {
          return $file;
        }
        $files[] = $file;
      }
      if (file_exists($file = $bundle
        ->getPath() . '/' . $path)) {
        if ($first && !$isResource) {
          return $file;
        }
        $files[] = $file;
        $resourceBundle = $bundle
          ->getName();
      }
    }
    if (count($files) > 0) {
      return $first && $isResource ? $files[0] : $files;
    }
    throw new \InvalidArgumentException(sprintf('Unable to find file "%s".', $name));
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getName() {
    if (null === $this->name) {
      $this->name = preg_replace('/[^a-zA-Z0-9_]+/', '', basename($this->rootDir));
    }
    return $this->name;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getEnvironment() {
    return $this->environment;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function isDebug() {
    return $this->debug;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getRootDir() {
    if (null === $this->rootDir) {
      $r = new \ReflectionObject($this);
      $this->rootDir = str_replace('\\', '/', dirname($r
        ->getFileName()));
    }
    return $this->rootDir;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getContainer() {
    return $this->container;
  }

  /**
   * Loads the PHP class cache.
   *
   * This methods only registers the fact that you want to load the cache classes.
   * The cache will actually only be loaded when the Kernel is booted.
   *
   * That optimization is mainly useful when using the HttpCache class in which
   * case the class cache is not loaded if the Response is in the cache.
   *
   * @param string $name      The cache name prefix
   * @param string $extension File extension of the resulting file
   */
  public function loadClassCache($name = 'classes', $extension = '.php') {
    $this->loadClassCache = array(
      $name,
      $extension,
    );
  }

  /**
   * Used internally.
   */
  public function setClassCache(array $classes) {
    file_put_contents($this
      ->getCacheDir() . '/classes.map', sprintf('<?php return %s;', var_export($classes, true)));
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getStartTime() {
    return $this->debug ? $this->startTime : -INF;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getCacheDir() {
    return $this->rootDir . '/cache/' . $this->environment;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getLogDir() {
    return $this->rootDir . '/logs';
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getCharset() {
    return 'UTF-8';
  }
  protected function doLoadClassCache($name, $extension) {
    if (!$this->booted && is_file($this
      ->getCacheDir() . '/classes.map')) {
      ClassCollectionLoader::load(include $this
        ->getCacheDir() . '/classes.map', $this
        ->getCacheDir(), $name, $this->debug, false, $extension);
    }
  }

  /**
   * Initializes the data structures related to the bundle management.
   *
   *  - the bundles property maps a bundle name to the bundle instance,
   *  - the bundleMap property maps a bundle name to the bundle inheritance hierarchy (most derived bundle first).
   *
   * @throws \LogicException if two bundles share a common name
   * @throws \LogicException if a bundle tries to extend a non-registered bundle
   * @throws \LogicException if a bundle tries to extend itself
   * @throws \LogicException if two bundles extend the same ancestor
   */
  protected function initializeBundles() {

    // init bundles
    $this->bundles = array();
    $topMostBundles = array();
    $directChildren = array();
    foreach ($this
      ->registerBundles() as $bundle) {
      $name = $bundle
        ->getName();
      if (isset($this->bundles[$name])) {
        throw new \LogicException(sprintf('Trying to register two bundles with the same name "%s"', $name));
      }
      $this->bundles[$name] = $bundle;
      if ($parentName = $bundle
        ->getParent()) {
        if (isset($directChildren[$parentName])) {
          throw new \LogicException(sprintf('Bundle "%s" is directly extended by two bundles "%s" and "%s".', $parentName, $name, $directChildren[$parentName]));
        }
        if ($parentName == $name) {
          throw new \LogicException(sprintf('Bundle "%s" can not extend itself.', $name));
        }
        $directChildren[$parentName] = $name;
      }
      else {
        $topMostBundles[$name] = $bundle;
      }
    }

    // look for orphans
    if (count($diff = array_values(array_diff(array_keys($directChildren), array_keys($this->bundles))))) {
      throw new \LogicException(sprintf('Bundle "%s" extends bundle "%s", which is not registered.', $directChildren[$diff[0]], $diff[0]));
    }

    // inheritance
    $this->bundleMap = array();
    foreach ($topMostBundles as $name => $bundle) {
      $bundleMap = array(
        $bundle,
      );
      $hierarchy = array(
        $name,
      );
      while (isset($directChildren[$name])) {
        $name = $directChildren[$name];
        array_unshift($bundleMap, $this->bundles[$name]);
        $hierarchy[] = $name;
      }
      foreach ($hierarchy as $bundle) {
        $this->bundleMap[$bundle] = $bundleMap;
        array_pop($bundleMap);
      }
    }
  }

  /**
   * Gets the container class.
   *
   * @return string The container class
   */
  protected function getContainerClass() {
    return $this->name . ucfirst($this->environment) . ($this->debug ? 'Debug' : '') . 'ProjectContainer';
  }

  /**
   * Gets the container's base class.
   *
   * All names except Container must be fully qualified.
   *
   * @return string
   */
  protected function getContainerBaseClass() {
    return 'Container';
  }

  /**
   * Initializes the service container.
   *
   * The cached version of the service container is used when fresh, otherwise the
   * container is built.
   */
  protected function initializeContainer() {
    $class = $this
      ->getContainerClass();
    $cache = new ConfigCache($this
      ->getCacheDir() . '/' . $class . '.php', $this->debug);
    $fresh = true;
    if (!$cache
      ->isFresh()) {
      $container = $this
        ->buildContainer();
      $container
        ->compile();
      $this
        ->dumpContainer($cache, $container, $class, $this
        ->getContainerBaseClass());
      $fresh = false;
    }
    require_once $cache;
    $this->container = new $class();
    $this->container
      ->set('kernel', $this);
    if (!$fresh && $this->container
      ->has('cache_warmer')) {
      $this->container
        ->get('cache_warmer')
        ->warmUp($this->container
        ->getParameter('kernel.cache_dir'));
    }
  }

  /**
   * Returns the kernel parameters.
   *
   * @return array An array of kernel parameters
   */
  protected function getKernelParameters() {
    $bundles = array();
    foreach ($this->bundles as $name => $bundle) {
      $bundles[$name] = get_class($bundle);
    }
    return array_merge(array(
      'kernel.root_dir' => $this->rootDir,
      'kernel.environment' => $this->environment,
      'kernel.debug' => $this->debug,
      'kernel.name' => $this->name,
      'kernel.cache_dir' => $this
        ->getCacheDir(),
      'kernel.logs_dir' => $this
        ->getLogDir(),
      'kernel.bundles' => $bundles,
      'kernel.charset' => $this
        ->getCharset(),
      'kernel.container_class' => $this
        ->getContainerClass(),
    ), $this
      ->getEnvParameters());
  }

  /**
   * Gets the environment parameters.
   *
   * Only the parameters starting with "SYMFONY__" are considered.
   *
   * @return array An array of parameters
   */
  protected function getEnvParameters() {
    $parameters = array();
    foreach ($_SERVER as $key => $value) {
      if (0 === strpos($key, 'SYMFONY__')) {
        $parameters[strtolower(str_replace('__', '.', substr($key, 9)))] = $value;
      }
    }
    return $parameters;
  }

  /**
   * Builds the service container.
   *
   * @return ContainerBuilder The compiled service container
   *
   * @throws \RuntimeException
   */
  protected function buildContainer() {
    foreach (array(
      'cache' => $this
        ->getCacheDir(),
      'logs' => $this
        ->getLogDir(),
    ) as $name => $dir) {
      if (!is_dir($dir)) {
        if (false === @mkdir($dir, 0777, true)) {
          throw new \RuntimeException(sprintf("Unable to create the %s directory (%s)\n", $name, $dir));
        }
      }
      elseif (!is_writable($dir)) {
        throw new \RuntimeException(sprintf("Unable to write in the %s directory (%s)\n", $name, $dir));
      }
    }
    $container = $this
      ->getContainerBuilder();
    $container
      ->addObjectResource($this);
    $this
      ->prepareContainer($container);
    if (null !== ($cont = $this
      ->registerContainerConfiguration($this
      ->getContainerLoader($container)))) {
      $container
        ->merge($cont);
    }
    $container
      ->addCompilerPass(new AddClassesToCachePass($this));
    return $container;
  }

  /**
   * Prepares the ContainerBuilder before it is compiled.
   *
   * @param ContainerBuilder $container A ContainerBuilder instance
   */
  protected function prepareContainer(ContainerBuilder $container) {
    $extensions = array();
    foreach ($this->bundles as $bundle) {
      if ($extension = $bundle
        ->getContainerExtension()) {
        $container
          ->registerExtension($extension);
        $extensions[] = $extension
          ->getAlias();
      }
      if ($this->debug) {
        $container
          ->addObjectResource($bundle);
      }
    }
    foreach ($this->bundles as $bundle) {
      $bundle
        ->build($container);
    }

    // ensure these extensions are implicitly loaded
    $container
      ->getCompilerPassConfig()
      ->setMergePass(new MergeExtensionConfigurationPass($extensions));
  }

  /**
   * Gets a new ContainerBuilder instance used to build the service container.
   *
   * @return ContainerBuilder
   */
  protected function getContainerBuilder() {
    $container = new ContainerBuilder(new ParameterBag($this
      ->getKernelParameters()));
    if (class_exists('ProxyManager\\Configuration')) {
      $container
        ->setProxyInstantiator(new RuntimeInstantiator());
    }
    return $container;
  }

  /**
   * Dumps the service container to PHP code in the cache.
   *
   * @param ConfigCache      $cache     The config cache
   * @param ContainerBuilder $container The service container
   * @param string           $class     The name of the class to generate
   * @param string           $baseClass The name of the container's base class
   */
  protected function dumpContainer(ConfigCache $cache, ContainerBuilder $container, $class, $baseClass) {

    // cache the container
    $dumper = new PhpDumper($container);
    if (class_exists('ProxyManager\\Configuration')) {
      $dumper
        ->setProxyDumper(new ProxyDumper());
    }
    $content = $dumper
      ->dump(array(
      'class' => $class,
      'base_class' => $baseClass,
    ));
    if (!$this->debug) {
      $content = self::stripComments($content);
    }
    $cache
      ->write($content, $container
      ->getResources());
  }

  /**
   * Returns a loader for the container.
   *
   * @param ContainerInterface $container The service container
   *
   * @return DelegatingLoader The loader
   */
  protected function getContainerLoader(ContainerInterface $container) {
    $locator = new FileLocator($this);
    $resolver = new LoaderResolver(array(
      new XmlFileLoader($container, $locator),
      new YamlFileLoader($container, $locator),
      new IniFileLoader($container, $locator),
      new PhpFileLoader($container, $locator),
      new ClosureLoader($container),
    ));
    return new DelegatingLoader($resolver);
  }

  /**
   * Removes comments from a PHP source string.
   *
   * We don't use the PHP php_strip_whitespace() function
   * as we want the content to be readable and well-formatted.
   *
   * @param string $source A PHP string
   *
   * @return string The PHP string with the comments removed
   */
  public static function stripComments($source) {
    if (!function_exists('token_get_all')) {
      return $source;
    }
    $rawChunk = '';
    $output = '';
    $tokens = token_get_all($source);
    for (reset($tokens); false !== ($token = current($tokens)); next($tokens)) {
      if (is_string($token)) {
        $rawChunk .= $token;
      }
      elseif (T_START_HEREDOC === $token[0]) {
        $output .= preg_replace(array(
          '/\\s+$/Sm',
          '/\\n+/S',
        ), "\n", $rawChunk) . $token[1];
        do {
          $token = next($tokens);
          $output .= $token[1];
        } while ($token[0] !== T_END_HEREDOC);
        $rawChunk = '';
      }
      elseif (!in_array($token[0], array(
        T_COMMENT,
        T_DOC_COMMENT,
      ))) {
        $rawChunk .= $token[1];
      }
    }

    // replace multiple new lines with a single newline
    $output .= preg_replace(array(
      '/\\s+$/Sm',
      '/\\n+/S',
    ), "\n", $rawChunk);
    return $output;
  }
  public function serialize() {
    return serialize(array(
      $this->environment,
      $this->debug,
    ));
  }
  public function unserialize($data) {
    list($environment, $debug) = unserialize($data);
    $this
      ->__construct($environment, $debug);
  }

}

Classes

Namesort descending Description
Kernel The Kernel is the heart of the Symfony system.