2014-05-10 23:14:12 +01:00
< ? 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\Translation ;
use Psr\Log\LoggerInterface ;
2016-09-21 18:16:29 +01:00
use Symfony\Component\Translation\Exception\InvalidArgumentException ;
2018-08-16 14:45:57 +01:00
use Symfony\Component\Translation\TranslatorInterface as LegacyTranslatorInterface ;
2018-12-05 07:43:42 +00:00
use Symfony\Contracts\Translation\LocaleAwareInterface ;
2018-08-16 14:45:57 +01:00
use Symfony\Contracts\Translation\TranslatorInterface ;
2014-05-10 23:14:12 +01:00
/**
* @ author Abdellatif Ait boudad < a . aitboudad @ gmail . com >
*/
2018-11-05 06:30:47 +00:00
class LoggingTranslator implements TranslatorInterface , LegacyTranslatorInterface , TranslatorBagInterface
2014-05-10 23:14:12 +01:00
{
/**
2015-04-14 21:48:01 +01:00
* @ var TranslatorInterface | TranslatorBagInterface
2014-05-10 23:14:12 +01:00
*/
private $translator ;
private $logger ;
/**
2015-04-14 21:48:01 +01:00
* @ param TranslatorInterface $translator The translator must implement TranslatorBagInterface
* @ param LoggerInterface $logger
2014-05-10 23:14:12 +01:00
*/
2018-10-01 12:27:53 +01:00
public function __construct ( $translator , LoggerInterface $logger )
2014-05-10 23:14:12 +01:00
{
2018-10-01 12:27:53 +01:00
if ( ! $translator instanceof LegacyTranslatorInterface && ! $translator instanceof TranslatorInterface ) {
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 )));
}
2018-12-05 07:43:42 +00:00
if ( ! $translator instanceof TranslatorBagInterface || ! $translator instanceof LocaleAwareInterface ) {
throw new InvalidArgumentException ( sprintf ( 'The Translator "%s" must implement TranslatorInterface, TranslatorBagInterface and LocaleAwareInterface.' , \get_class ( $translator )));
2014-05-10 23:14:12 +01:00
}
$this -> translator = $translator ;
$this -> logger = $logger ;
}
/**
* { @ inheritdoc }
*/
2019-01-16 20:35:37 +00:00
public function trans ( $id , array $parameters = [], $domain = null , $locale = null )
2014-05-10 23:14:12 +01:00
{
2014-12-05 20:11:30 +00:00
$trans = $this -> translator -> trans ( $id , $parameters , $domain , $locale );
2014-05-10 23:14:12 +01:00
$this -> log ( $id , $domain , $locale );
return $trans ;
}
/**
* { @ inheritdoc }
2018-10-01 12:27:53 +01:00
*
* @ deprecated since Symfony 4.2 , use the trans () method instead with a % count % parameter
2014-05-10 23:14:12 +01:00
*/
2019-01-16 20:35:37 +00:00
public function transChoice ( $id , $number , array $parameters = [], $domain = null , $locale = null )
2014-05-10 23:14:12 +01:00
{
2019-01-27 23:11:39 +00:00
@ 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 );
2018-10-01 12:27:53 +01:00
if ( $this -> translator instanceof TranslatorInterface ) {
2019-01-16 20:35:37 +00:00
$trans = $this -> translator -> trans ( $id , [ '%count%' => $number ] + $parameters , $domain , $locale );
2018-09-05 20:29:06 +01:00
} else {
2018-10-01 12:27:53 +01:00
$trans = $this -> translator -> transChoice ( $id , $number , $parameters , $domain , $locale );
2018-09-05 20:29:06 +01:00
}
2014-05-10 23:14:12 +01:00
$this -> log ( $id , $domain , $locale );
return $trans ;
}
/**
* { @ inheritdoc }
*/
public function setLocale ( $locale )
{
$this -> translator -> setLocale ( $locale );
}
/**
* { @ inheritdoc }
*/
public function getLocale ()
{
return $this -> translator -> getLocale ();
}
2015-02-10 13:48:21 +00:00
/**
* { @ inheritdoc }
*/
public function getCatalogue ( $locale = null )
{
return $this -> translator -> getCatalogue ( $locale );
}
2016-11-09 20:23:10 +00:00
/**
* Gets the fallback locales .
*
2018-11-18 21:25:02 +00:00
* @ return array The fallback locales
2016-11-09 20:23:10 +00:00
*/
public function getFallbackLocales ()
{
2017-06-21 12:02:23 +01:00
if ( $this -> translator instanceof Translator || method_exists ( $this -> translator , 'getFallbackLocales' )) {
2016-11-09 20:23:10 +00:00
return $this -> translator -> getFallbackLocales ();
}
2019-01-16 20:35:37 +00:00
return [];
2016-11-09 20:23:10 +00:00
}
2014-05-10 23:14:12 +01:00
/**
* Passes through all unknown calls onto the translator object .
*/
public function __call ( $method , $args )
{
2018-09-11 08:26:54 +01:00
return $this -> translator -> { $method }( ... $args );
2014-05-10 23:14:12 +01:00
}
/**
* Logs for missing translations .
*
* @ param string $id
* @ param string | null $domain
* @ param string | null $locale
*/
private function log ( $id , $domain , $locale )
{
if ( null === $domain ) {
$domain = 'messages' ;
}
$id = ( string ) $id ;
$catalogue = $this -> translator -> getCatalogue ( $locale );
if ( $catalogue -> defines ( $id , $domain )) {
return ;
}
if ( $catalogue -> has ( $id , $domain )) {
2019-01-16 20:35:37 +00:00
$this -> logger -> debug ( 'Translation use fallback catalogue.' , [ 'id' => $id , 'domain' => $domain , 'locale' => $catalogue -> getLocale ()]);
2014-05-10 23:14:12 +01:00
} else {
2019-01-16 20:35:37 +00:00
$this -> logger -> warning ( 'Translation not found.' , [ 'id' => $id , 'domain' => $domain , 'locale' => $catalogue -> getLocale ()]);
2014-05-10 23:14:12 +01:00
}
}
}