vendor/symfony/framework-bundle/Templating/Helper/TranslatorHelper.php line 14

Open in your IDE?
  1. <?php
  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.  */
  12. namespace Symfony\Bundle\FrameworkBundle\Templating\Helper;
  14. @trigger_error('The '.TranslatorHelper::class.' class is deprecated since version 4.3 and will be removed in 5.0; use Twig instead.', E_USER_DEPRECATED);
  16. use Symfony\Component\Templating\Helper\Helper;
  17. use Symfony\Component\Translation\TranslatorInterface as LegacyTranslatorInterface;
  18. use Symfony\Contracts\Translation\TranslatorInterface;
  19. use Symfony\Contracts\Translation\TranslatorTrait;
  21. /**
  22.  * @author Fabien Potencier <fabien@symfony.com>
  23.  *
  24.  * @deprecated since version 4.3, to be removed in 5.0; use Twig instead.
  25.  */
  26. class TranslatorHelper extends Helper
  27. {
  28.     use TranslatorTrait {
  29.         getLocale as private;
  30.         setLocale as private;
  31.         trans as private doTrans;
  32.     }
  34.     protected $translator;
  36.     /**
  37.      * @param TranslatorInterface|null $translator
  38.      */
  39.     public function __construct($translator = null)
  40.     {
  41.         if (null !== $translator && !$translator instanceof LegacyTranslatorInterface && !$translator instanceof TranslatorInterface) {
  42.             throw new \TypeError(sprintf('Argument 1 passed to "%s()" must be an instance of "%s", "%s" given.', __METHOD__, TranslatorInterface::class, \is_object($translator) ? \get_class($translator) : \gettype($translator)));
  43.         }
  44.         $this->translator = $translator;
  45.     }
  47.     /**
  48.      * @see TranslatorInterface::trans()
  49.      */
  50.     public function trans($id, array $parameters = [], $domain = 'messages', $locale = null)
  51.     {
  52.         if (null === $this->translator) {
  53.             return $this->doTrans($id, $parameters, $domain, $locale);
  54.         }
  56.         return $this->translator->trans($id, $parameters, $domain, $locale);
  57.     }
  59.     /**
  60.      * @see TranslatorInterface::transChoice()
  61.      * @deprecated since Symfony 4.2, use the trans() method instead with a %count% parameter
  62.      */
  63.     public function transChoice($id, $number, array $parameters = [], $domain = 'messages', $locale = null)
  64.     {
  65.         @trigger_error(sprintf('The "%s()" method is deprecated since Symfony 4.2, use the trans() one instead with a "%%count%%" parameter.', __METHOD__), E_USER_DEPRECATED);
  67.         if (null === $this->translator) {
  68.             return $this->doTrans($id, ['%count%' => $number] + $parameters, $domain, $locale);
  69.         }
  70.         if ($this->translator instanceof TranslatorInterface) {
  71.             return $this->translator->trans($id, ['%count%' => $number] + $parameters, $domain, $locale);
  72.         }
  74.         return $this->translator->transChoice($id, $number, $parameters, $domain, $locale);
  75.     }
  77.     /**
  78.      * {@inheritdoc}
  79.      */
  80.     public function getName()
  81.     {
  82.         return 'translator';
  83.     }
  84. }