src/Twig/AppExtension.php line 356

Open in your IDE?
  1. <?php
  3. namespace App\Twig;
  5. use App\Admin\Entity\StdDomainsValues;
  6. use App\Admin\Entity\StdPagesPages;
  7. use App\Service\PageInfoCacheService;
  8. use Twig\Extension\AbstractExtension;
  9. use Twig\Environment;
  10. use Twig\TwigFunction;
  11. use Twig\TwigFilter;
  12. use Twig\TwigTest;
  13. use App\Utils\Functions;
  14. use Doctrine\ORM\EntityManagerInterface;
  15. use Symfony\Component\Security\Core\Security;
  16. use Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface;
  17. use Symfony\Component\HttpFoundation\RequestStack;
  18. use Symfony\Contracts\Translation\TranslatorInterface;
  20. class AppExtension extends AbstractExtension
  21. {
  22.     protected $entityManager;
  23.     protected $parameterBag;
  24.     private $twig;
  25.     private Security $security;
  26.     private RequestStack $requestStack;
  27.     private TranslatorInterface $translator;
  28.     private PageInfoCacheService $pageInfoCache;
  30.     public function __construct(
  31.         EntityManagerInterface $entityManager,
  32.         ParameterBagInterface $parameterBag,
  33.         Environment $twig,
  34.         Security $security,
  35.         RequestStack $requestStack,
  36.         TranslatorInterface $translator,
  37.         PageInfoCacheService $pageInfoCache
  38.     ) {
  39.         $this->entityManager = $entityManager;
  40.         $this->parameterBag = $parameterBag;
  41.         $this->security = $security;
  42.         $this->twig = $twig;
  43.         $this->requestStack = $requestStack;
  44.         $this->translator = $translator;
  45.         $this->pageInfoCache = $pageInfoCache;
  46.     }
  48.     public function getFunctions(): array
  49.     {
  50.         return [
  51.             new TwigFunction('url_content', [$this, 'getUrlContent']),
  52.             new TwigFunction('file_get_contents',[$this, 'fileGetContents']),
  53.             new TwigFunction('clean_string', [$this, 'cleanString']),
  54.             new TwigFunction('get_config', [$this, 'getConfig']),
  55.             new TwigFunction('get_env', [$this, 'getVariables']),
  56.             new TwigFunction('generate_barcode', [$this, 'generateBarcode']),
  57.             new TwigFunction('array_search',  'array_search'),
  58.             new TwigFunction('is_mobile', [$this, 'isMobile']),
  59.             new TwigFunction('trim_text', [$this, 'trimText']),
  60.             new TwigFunction('get_page_info', [$this, 'getPageInfo']),
  61.             new TwigFunction('get_image_size', [$this, 'getImageSize']),
  62.             new TwigFunction('get_domain_value_description', [$this, 'getDomainValueDescription']),
  63.             new TwigFunction('get_domain_value', [$this, 'getDomainValue']),
  64.             new TwigFunction('get_relation_children', [$this, 'getRelationChildren']),
  65.             new TwigFunction('check_form_permissions', [$this, 'checkFormPermissions']),
  66.             new TwigFunction('get_content_by_machine_name', [$this, 'getContentByMachineName']),
  67.             new TwigFunction('twig_file_exists', [$this, 'twigFileExists']),
  68.             new TwigFunction('eval', [$this, 'evalFunction']),
  69.             new TwigFunction('is_authenticated_in_studio', [$this, 'isAuthenticatedInStudio']),
  70.             new TwigFunction('get_studio_user', [$this, 'getStudioUser']),
  71.             new TwigFunction('time_elapsed', [$this, 'timeElapsed']),
  72.             new TwigFunction('format_event_range', [$this, 'formatEventRange']),
  73.             new TwigFunction('format_date_locale', [$this, 'formatDateLocale']),
  74.         ];
  75.     }
  77.     public function getFilters(): array
  78.     {
  79.         return [
  80.             new TwigFilter('urldecode',  'urldecode'),
  81.             new TwigFilter('format_date',  [$this,'formatDate']),
  82.             new TwigFilter('array_filter',  'array_filter'),
  83.             new TwigFilter('array_unique',  'array_unique'),
  84.             new TwigFilter('json_decode',  'json_decode'),
  85.             new TwigFilter('extension', [$this, 'extension']),
  86.             new TwigFilter('get_variables', [$this, 'getVariables']),
  87.             new TwigFilter('get_pdf_cover', [$this, 'getPDFCover']),
  88.             new TwigFilter('html_entity_decode', 'html_entity_decode'),
  89.             new TwigFilter('eval', [$this, 'evalFilter']),
  90.             new TwigFilter('to_lower', [$this, 'toLower']),
  91.             new TwigFilter('pad', [$this, 'pad']),
  92.             new TwigFilter('fix_iframes', [$this, 'fixIframes'], ['is_safe' => ['html']]),
  93.             new TwigFilter('encode_url_path', [$this, 'encodeUrlPath']),
  94.         ];
  95.     }
  97.     public function getTests(): array
  98.     {
  99.         return [
  100.             new TwigTest('ondisk',[$this,'onDisk']),
  101.             new TwigTest('instanceof', array($this, 'isInstanceOf'))
  102.         ];
  103.     }
  105.     public function onDisk($file){
  106.         return file_exists($this->parameterBag->get('kernel.project_dir')."/".getenv("PUBLIC_DIR").$file);
  107.     }
  109.     public function isInstanceOf($object, $class)
  110.     {
  111.         $reflectionClass = new \ReflectionClass($class);
  113.         return $reflectionClass->isInstance($object);
  114.     }
  117.     public function getUrlContent($url)
  118.     {
  119.         return Functions::getUrlContent($url);
  120.     }
  122.     public function isMobile()
  123.     {
  124.         $useragent=$_SERVER['HTTP_USER_AGENT'];
  125.         return preg_match('/(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows (ce|phone)|xda|xiino/i',$useragent)||preg_match('/1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i',substr($useragent,0,4));
  126.     }
  128.     public function trimText($text,$trimLength,$textToAdd=""){
  129.         $return = html_entity_decode($text, ENT_COMPAT, 'utf-8');
  130.         $return = substr($return,0,$trimLength).$textToAdd;
  131.         return $return;
  132.     }
  135.     public function cleanString($input, $replace = '-', $remove_words = false, $words_array = array())
  136.     {
  137.         $return = htmlentities($input, ENT_COMPAT, 'utf-8');
  138.         $return = preg_replace("`&([a-z])(acute|uml|circ|grave|ring|cedil|slash|tilde|caron|lig|quot|rsquo);`i", "\\1", $return);
  139.         $return = trim(preg_replace('/(&amp)/', '', strtolower($return)));
  140.         $return = trim(preg_replace('/[^a-zA-Z0-9\s\-]/', '', strtolower($return)));
  141.         $return = trim(preg_replace('/ +/', ' ', $return));
  143.         if ($remove_words) {
  144.             $return = remove_words($return, $replace, $words_array);
  145.         }
  146.         $return = str_replace(' ', $replace, $return);
  147.         $return = trim(preg_replace('/' . $replace . '+/', $replace, $return));
  149.         return $return;
  150.     }
  152.     public function getConfig($machineName, $lang = '')
  153.     {
  154.         return Functions::getConfig($machineName,$lang,$this->entityManager);
  155.     }
  157.     public function extension($file)
  158.     {
  159.         return pathinfo($file, PATHINFO_EXTENSION);
  160.     }
  162.     public function formatDate($str){
  163.         return date("d/m/Y h:i A",time($str));
  164.     }
  166.     public function generateBarcode($type,$code,$width,$height,$color='black',$bgcolor='white',$responsetype='html')
  167.     {
  168.         $barcode = new \Com\Tecnick\Barcode\Barcode();
  169.         if($type == "EAN13"){
  170.             //Calcula o CheckDigit
  171.             $digits =(string)$code;
  172.             // Deprecated $even_sum = $digits{1} + $digits{3} + $digits{5} + $digits{7} + $digits{9} + $digits{11};
  173.             $even_sum = substr($digits, 1, 1) + substr($digits, 3, 1) + substr($digits, 5, 1) + substr($digits, 7, 1) + substr($digits, 9, 1) + substr($digits, 11, 1);
  174.             $even_sum_three = $even_sum * 3;
  175.             // Deprecated $odd_sum = $digits{0} + $digits{2} + $digits{4} + $digits{6} + $digits{8} + $digits{10};
  176.             $odd_sum = substr($digits, 0, 1) + substr($digits, 2, 1) + substr($digits, 4, 1) + substr($digits, 6, 1) + substr($digits, 8, 1) + substr($digits, 10, 1);
  177.             $total_sum = $even_sum_three + $odd_sum;
  178.             $next_ten = (ceil($total_sum/10))*10;
  179.             $check_digit = $next_ten - $total_sum;
  180.             $code = substr($code,0,12) . $check_digit;
  181.         }
  182.         $bobj = $barcode->getBarcodeObj($type, $code, $width, $height, $color,array(0,0,0,0))->setBackgroundColor($bgcolor);
  183.         if($responsetype == "svg")
  184.             return $bobj->getSvgCode();
  185.         else
  186.             return $bobj->getHtmlDiv();
  187.     }
  189.     public function getVariables($variable) {
  190.         return getenv($variable);
  191.     }
  193.     public function getPDFCover($pdffile){
  194.         $pdffile = urldecode($pdffile);
  195.         if($this->onDisk($pdffile)){
  196.             $filesignature=md5($pdffile).".jpg";
  197.             $filepath=$this->parameterBag->get('kernel.project_dir')."/public".$pdffile;
  198.             $cachepath=$this->parameterBag->get('kernel.project_dir')."/public/media/".$filesignature;
  199.             if(!$this->onDisk("/media/".$filesignature) || filemtime($filepath)>filemtime($cachepath)){
  200.                 try {
  201.                     $image = new \Imagick();
  202.                     $image->setResolution(200,200);
  203.                     $image->SetColorspace(\Imagick::COLORSPACE_SRGB);
  204.                     $image->readImage($filepath."[0]");
  205.                     $image->setImageAlphaChannel(\Imagick::ALPHACHANNEL_REMOVE );
  206.                     $image->setImageFormat('jpg');
  207.                     $image->writeImage($cachepath);
  208.                     $image->clear();
  209.                     $image->destroy();
  210.                     return "/media/".$filesignature;
  211.                 } catch (\Throwable $th) {
  212.                 }
  213.             }
  214.             else
  215.             {
  216.                 return "/media/".$filesignature;
  217.             }
  218.         }
  219.         $default="/media/default.jpg";
  220.         if(!$this->onDisk($default)){
  221.             $image = imagecreate(1, 1);
  222.             $background_color = imagecolorallocate($image, 255, 255, 255);
  223.             imagefill($image, 0, 0, $background_color);
  224.             imagejpeg($image, $this->parameterBag->get('kernel.project_dir')."/public".$default);
  225.         }
  226.         return $default;
  227.     }
  229.     public function evalFilter($value){
  230.         //create twig string from value
  231.         $template=$this->twig->createTemplate($value);
  232.         return $template->render(array());
  233.     }
  235.     public function evalFunction($value,$params){
  236.         //create twig string from value
  237.         $template=$this->twig->createTemplate($value);
  238.         return $template->render($params);
  239.     }
  241.     public function getPageInfo($locale, $id, $renderCat = true, $rootCategory = null)
  242.     {
  243.         // Use Redis-cached version for better performance
  244.         return $this->pageInfoCache->getPageInfo($locale, $id, $renderCat, $rootCategory);
  245.     }
  247.     public function getDomainValueDescription($domainMachineName,$machineName,string $locale):?string
  248.     {
  249.         return Functions::getDomainValueDescription($locale,$domainMachineName,$machineName, $this->entityManager);
  250.     }
  252.     /**
  253.      * Encodes URL path segments while preserving slashes.
  254.      */
  255.     public function encodeUrlPath(?string $url): string
  256.     {
  257.         if (empty($url)) {
  258.             return '';
  259.         }
  261.         // Parse the URL to get its components
  262.         $parsed = parse_url($url);
  263.         
  264.         if (isset($parsed['path'])) {
  265.             // Split path by slash, encode each segment, then rejoin
  266.             $segments = explode('/', $parsed['path']);
  267.             $encodedSegments = array_map(function($segment) {
  268.                 return rawurlencode(rawurldecode($segment));
  269.             }, $segments);
  270.             $parsed['path'] = implode('/', $encodedSegments);
  271.         }
  273.         // Rebuild the URL
  274.         $result = '';
  275.         if (isset($parsed['scheme'])) {
  276.             $result .= $parsed['scheme'] . '://';
  277.         }
  278.         if (isset($parsed['host'])) {
  279.             $result .= $parsed['host'];
  280.         }
  281.         if (isset($parsed['port'])) {
  282.             $result .= ':' . $parsed['port'];
  283.         }
  284.         if (isset($parsed['path'])) {
  285.             $result .= $parsed['path'];
  286.         }
  287.         if (isset($parsed['query'])) {
  288.             $result .= '?' . $parsed['query'];
  289.         }
  290.         if (isset($parsed['fragment'])) {
  291.             $result .= '#' . $parsed['fragment'];
  292.         }
  294.         return $result;
  295.     }
  297.     public function getImageSize(string $filename, array &$image_info = null)
  298.     {
  299.         $filename = substr(parse_url($filename, PHP_URL_PATH), 1);
  300.         if(file_exists($filename)){
  301.             return getimagesize($filename, $image_info);
  302.         }
  303.         return [0,0];
  304.     }
  306.     public function getDomainValue($domainMachineName,$machineName):?StdDomainsValues
  307.     {
  308.         return $this->entityManager->getRepository(StdDomainsValues::class)->findOneByDomainAndValue($domainMachineName,$machineName);
  309.     }
  310.     public function getRelationChildren($relationId,$languagecode, $params)
  311.     {
  312.         return $this->entityManager->getRepository(StdPagesPages::class)->getRelationChildren($relationId, $languagecode,$params);
  313.     }
  315.     public function checkFormPermissions($form_content)
  316.     {
  317.         return Functions::checkFormPermissions( $this->security, $this->entityManager, $form_content);
  318.     }
  319.     public function toLower($str)
  320.     {
  321.         if (is_array($str)){
  322.             array_walk($str, function(&$item){$item = strtolower($item);});
  323.         }
  324.         else{
  325.             $str = strtolower($str);
  326.         }
  327.         return $str;
  328.     }
  330.     public function fileGetContents($filepath){
  331.         if($this->onDisk($filepath)){
  332.             return file_get_contents($this->parameterBag->get('kernel.project_dir')."/".getenv("PUBLIC_DIR").$filepath);
  333.         }else{
  334.             return "";
  335.         }
  336.     }
  338.     public function getContentByMachineName($locale, $machineName)
  339.     {
  340.         return Functions::getContentByMachineName($locale, $machineName, $this->entityManager);
  341.     }
  343.     public function twigFileExists($path)
  344.     {
  345.         $loader = $this->twig->getLoader();
  346.         return $loader->exists($path);
  347.     }
  349.     public function pad($number, $length, $padString = '0', $side = 'left')
  350.     {
  351.         $padType = $side === 'left' ? STR_PAD_LEFT : STR_PAD_RIGHT;
  352.         return str_pad($number, $length, $padString, $padType);
  353.     }
  354.     public function isAuthenticatedInStudio(): bool
  355.     {
  356.         $studioToken = $this->requestStack->getSession()->get('_security_studio_context');
  357.         if (!$studioToken) {
  358.             return false;
  359.         }
  361.         // If token exists in session, check if it's valid
  362.         try {
  363.             $token = unserialize($studioToken);
  364.             return $token && $token->isAuthenticated();
  365.         } catch (\Exception $e) {
  366.             return false;
  367.         }
  368.     }
  369.     public function getStudioUser()
  370.     {
  371.         $studioToken = $this->requestStack->getSession()->get('_security_studio_context');
  372.         if (!$studioToken) {
  373.             return null;
  374.         }
  376.         // If token exists in session, check if it's valid
  377.         try {
  378.             $token = unserialize($studioToken);
  379.             return $token->getUser();
  380.         } catch (\Exception $e) {
  381.             return null;
  382.         }
  383.     }
  385.     /**
  386.      * Calculate time elapsed since a given date using translations
  387.      *
  388.      * @param mixed $publishedDate The published date (string, DateTime, or null)
  389.      * @return string The formatted time elapsed string
  390.      */
  391.     public function timeElapsed($publishedDate): string
  392.     {
  393.         if (!$publishedDate) {
  394.             return $this->translator->trans('time_recently', [], 'custom');
  395.         }
  397.         try {
  398.             // Convert to DateTime if it's a string
  399.             if (is_string($publishedDate)) {
  400.                 $published = new \DateTime($publishedDate);
  401.             } elseif ($publishedDate instanceof \DateTimeInterface) {
  402.                 $published = $publishedDate;
  403.             } else {
  404.                 return $this->translator->trans('time_recently', [], 'custom');
  405.             }
  406.             $now = new \DateTime();
  407.             $diff = $now->getTimestamp() - $published->getTimestamp();
  409.             // Calculate time units
  410.             $minutes = round($diff / 60);
  411.             $hours = round($diff / 3600);
  412.             $days = round($diff / 86400);
  413.             $weeks = round($diff / 604800);
  414.             $months = round($diff / 2592000); // Approximate month (30 days)
  415.             $years = round($diff / 31536000); // Approximate year (365 days)
  417.             // Return appropriate format using translations
  418.             if ($diff < 60) {
  419.                 return $this->translator->trans('time_recently', [], 'custom');
  420.             } elseif ($minutes < 60) {
  421.                 return $this->translator->trans('time_minutes_ago', ['%count%' => $minutes], 'custom');
  422.             } elseif ($hours < 24) {
  423.                 return $this->translator->trans('time_hours_ago', ['%count%' => $hours], 'custom');
  424.             } elseif ($days < 7) {
  425.                 return $this->translator->trans('time_days_ago', ['%count%' => $days], 'custom');
  426.             } elseif ($weeks < 4) {
  427.                 return $this->translator->trans('time_weeks_ago', ['%count%' => $weeks], 'custom');
  428.             } elseif ($months < 12) {
  429.                 return $this->translator->trans('time_months_ago', ['%count%' => $months], 'custom');
  430.             } else {
  431.                 return $this->translator->trans('time_years_ago', ['%count%' => $years], 'custom');
  432.             }
  433.         } catch (\Exception $e) {
  434.             return $this->translator->trans('time_recently', [], 'custom');
  435.         }
  436.     }
  438.     // 2) Mapa de meses por idioma
  439.     private function monthsByLocale(string $locale): array
  440.     {
  441.         $map = [
  442.             'pt' => [1=>'janeiro',2=>'fevereiro',3=>'março',4=>'abril',5=>'maio',6=>'junho',7=>'julho',8=>'agosto',9=>'setembro',10=>'outubro',11=>'novembro',12=>'dezembro'],
  443.             'en' => [1=>'January',2=>'February',3=>'March',4=>'April',5=>'May',6=>'June',7=>'July',8=>'August',9=>'September',10=>'October',11=>'November',12=>'December'],
  444.             'es' => [1=>'enero',2=>'febrero',3=>'marzo',4=>'abril',5=>'mayo',6=>'junio',7=>'julio',8=>'agosto',9=>'septiembre',10=>'octubre',11=>'noviembre',12=>'diciembre'],
  445.         ];
  447.         // normaliza ('pt-PT' -> 'pt')
  448.         $short = strtolower(substr($locale, 0, 2));
  449.         return $map[$short] ?? $map['pt'];
  450.     }
  452.     /**
  453.      * Converte para DateTime de forma segura
  454.      */
  455.     private function toDateTime($value): ?\DateTimeInterface
  456.     {
  457.         if ($value instanceof \DateTimeInterface) return $value;
  458.         if (is_string($value) && trim($value) !== '') {
  459.             try { return new \DateTime($value); } catch (\Throwable $e) {}
  460.         }
  461.         return null;
  462.     }
  464.     /**
  465.      * Formata uma data simples no idioma atual.
  466.      * Ex.:  "14 de agosto de 2025" (pt) | "August 14, 2025" (en)
  467.      */
  468.     public function formatDateLocale($date, ?string $locale = null): string
  469.     {
  470.         $dt = $this->toDateTime($date);
  471.         if (!$dt) return '';
  473.         $loc = $locale ?: ($this->requestStack->getCurrentRequest()->getLocale() ?? 'pt');
  474.         $months = $this->monthsByLocale($loc);
  475.         $d = $dt->format('d');
  476.         $m = (int)$dt->format('n');
  477.         $y = $dt->format('Y');
  479.         $short = strtolower(substr($loc, 0, 2));
  480.         if ($short === 'en') {
  481.             // English style
  482.             return sprintf('%s %s, %s', $months[$m], $d, $y);
  483.         } elseif ($short === 'es') {
  484.             return sprintf('%s de %s de %s', $d, $months[$m], $y);
  485.         }
  486.         // default pt
  487.         return sprintf('%s de %s %s', $d, $months[$m], $y);
  488.     }
  490.     /**
  491.      * Formata o intervalo start/end no idioma atual.
  492.      * Regras:
  493.      * - anos diferentes: "dd de Mês AAAA a dd de Mês AAAA"
  494.      * - mesmo ano e mês: "dd a dd de Mês AAAA"
  495.      * - mesmo ano, meses diferentes: "dd de Mês a dd de Mês AAAA"
  496.      * - sem end: data única completa
  497.      */
  498.     public function formatEventRange($start, $end = null, ?string $locale = null): string
  499.     {
  500.         $s = $this->toDateTime($start);
  501.         if (!$s) return '';
  503.         $loc = $locale ?: ($this->requestStack->getCurrentRequest()->getLocale() ?? 'pt');
  504.         $months = $this->monthsByLocale($loc);
  506.         $y1 = (int)$s->format('Y');
  507.         $m1 = (int)$s->format('n');
  508.         $d1 = $s->format('d');
  510.         $e = $this->toDateTime($end);
  512.         if (!$e) {
  513.             return $this->formatDateLocale($s, $loc);
  514.         }
  516.         $y2 = (int)$e->format('Y');
  517.         $m2 = (int)$e->format('n');
  518.         $d2 = $e->format('d');
  520.         $short = strtolower(substr($loc, 0, 2));
  522.         // anos diferentes
  523.         if ($y1 !== $y2) {
  524.             if ($short === 'en') {
  525.                 return sprintf('%s %s, %s to %s %s, %s', $months[$m1], $d1, $y1, $months[$m2], $d2, $y2);
  526.             } elseif ($short === 'es') {
  527.                 return sprintf('%s de %s de %s a %s de %s de %s', $d1, $months[$m1], $y1, $d2, $months[$m2], $y2);
  528.             }
  529.             // pt
  530.             return sprintf('%s de %s %s a %s de %s %s', $d1, $months[$m1], $y1, $d2, $months[$m2], $y2);
  531.         }
  533.         // mesmo ano
  534.         if ($m1 === $m2) {
  535.             if ($short === 'en') {
  536.                 return sprintf('%s–%s %s %s', $d1, $d2, $months[$m2], $y2);
  537.             } elseif ($short === 'es') {
  538.                 return sprintf('%s a %s de %s de %s', $d1, $d2, $months[$m2], $y2);
  539.             }
  540.             // pt
  541.             return sprintf('%s a %s de %s %s', $d1, $d2, $months[$m2], $y2);
  542.         }
  544.         // mesmo ano, meses diferentes
  545.         if ($short === 'en') {
  546.             return sprintf('%s %s to %s %s, %s', $months[$m1].' '.$d1, $y1, $months[$m2].' '.$d2, $months[$m2], $y2); // forma enxuta
  547.         } elseif ($short === 'es') {
  548.             return sprintf('%s de %s a %s de %s de %s', $d1, $months[$m1], $d2, $months[$m2], $y2);
  549.         }
  550.         // pt
  551.         return sprintf('%s de %s a %s de %s %s', $d1, $months[$m1], $d2, $months[$m2], $y2);
  552.     }
  554. }