MessageCatalogue.php in Plug 7

Namespace

Symfony\Component\Translation

File

lib/Symfony/translation/MessageCatalogue.php

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <[e-mail]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace Symfony\Component\Translation;

use Symfony\Component\Config\Resource\ResourceInterface;

/**
 * MessageCatalogue.
 *
 * @author Fabien Potencier <[e-mail]>
 *
 * @api
 */
class MessageCatalogue implements MessageCatalogueInterface, MetadataAwareInterface {
  private $messages = array();
  private $metadata = array();
  private $resources = array();
  private $locale;
  private $fallbackCatalogue;
  private $parent;

  /**
   * Constructor.
   *
   * @param string $locale   The locale
   * @param array  $messages An array of messages classified by domain
   *
   * @api
   */
  public function __construct($locale, array $messages = array()) {
    $this->locale = $locale;
    $this->messages = $messages;
  }

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

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getDomains() {
    return array_keys($this->messages);
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function all($domain = null) {
    if (null === $domain) {
      return $this->messages;
    }
    return isset($this->messages[$domain]) ? $this->messages[$domain] : array();
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function set($id, $translation, $domain = 'messages') {
    $this
      ->add(array(
      $id => $translation,
    ), $domain);
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function has($id, $domain = 'messages') {
    if (isset($this->messages[$domain][$id])) {
      return true;
    }
    if (null !== $this->fallbackCatalogue) {
      return $this->fallbackCatalogue
        ->has($id, $domain);
    }
    return false;
  }

  /**
   * {@inheritdoc}
   */
  public function defines($id, $domain = 'messages') {
    return isset($this->messages[$domain][$id]);
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function get($id, $domain = 'messages') {
    if (isset($this->messages[$domain][$id])) {
      return $this->messages[$domain][$id];
    }
    if (null !== $this->fallbackCatalogue) {
      return $this->fallbackCatalogue
        ->get($id, $domain);
    }
    return $id;
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function replace($messages, $domain = 'messages') {
    $this->messages[$domain] = array();
    $this
      ->add($messages, $domain);
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function add($messages, $domain = 'messages') {
    if (!isset($this->messages[$domain])) {
      $this->messages[$domain] = $messages;
    }
    else {
      $this->messages[$domain] = array_replace($this->messages[$domain], $messages);
    }
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function addCatalogue(MessageCatalogueInterface $catalogue) {
    if ($catalogue
      ->getLocale() !== $this->locale) {
      throw new \LogicException(sprintf('Cannot add a catalogue for locale "%s" as the current locale for this catalogue is "%s"', $catalogue
        ->getLocale(), $this->locale));
    }
    foreach ($catalogue
      ->all() as $domain => $messages) {
      $this
        ->add($messages, $domain);
    }
    foreach ($catalogue
      ->getResources() as $resource) {
      $this
        ->addResource($resource);
    }
    if ($catalogue instanceof MetadataAwareInterface) {
      $metadata = $catalogue
        ->getMetadata('', '');
      $this
        ->addMetadata($metadata);
    }
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function addFallbackCatalogue(MessageCatalogueInterface $catalogue) {

    // detect circular references
    $c = $this;
    do {
      if ($c
        ->getLocale() === $catalogue
        ->getLocale()) {
        throw new \LogicException(sprintf('Circular reference detected when adding a fallback catalogue for locale "%s".', $catalogue
          ->getLocale()));
      }
    } while ($c = $c->parent);
    $catalogue->parent = $this;
    $this->fallbackCatalogue = $catalogue;
    foreach ($catalogue
      ->getResources() as $resource) {
      $this
        ->addResource($resource);
    }
  }

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

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function getResources() {
    return array_values($this->resources);
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function addResource(ResourceInterface $resource) {
    $this->resources[$resource
      ->__toString()] = $resource;
  }

  /**
   * {@inheritdoc}
   */
  public function getMetadata($key = '', $domain = 'messages') {
    if ('' == $domain) {
      return $this->metadata;
    }
    if (isset($this->metadata[$domain])) {
      if ('' == $key) {
        return $this->metadata[$domain];
      }
      if (isset($this->metadata[$domain][$key])) {
        return $this->metadata[$domain][$key];
      }
    }
  }

  /**
   * {@inheritdoc}
   */
  public function setMetadata($key, $value, $domain = 'messages') {
    $this->metadata[$domain][$key] = $value;
  }

  /**
   * {@inheritdoc}
   */
  public function deleteMetadata($key = '', $domain = 'messages') {
    if ('' == $domain) {
      $this->metadata = array();
    }
    elseif ('' == $key) {
      unset($this->metadata[$domain]);
    }
    else {
      unset($this->metadata[$domain][$key]);
    }
  }

  /**
   * Adds current values with the new values.
   *
   * @param array $values Values to add
   */
  private function addMetadata(array $values) {
    foreach ($values as $domain => $keys) {
      foreach ($keys as $key => $value) {
        $this
          ->setMetadata($key, $value, $domain);
      }
    }
  }

}

Classes

Name	Description
MessageCatalogue	MessageCatalogue.