Метод priority класса Email

Метод priority класса Email устанавливает приоритет электронного письма. Первым параметром передаётся целое число от 1 до 5, где 1 - самый высокий приоритет, а 5 - самый низкий. Метод возвращает объект Email, что позволяет строить цепочку вызовов.

Приоритет письма влияет на заголовок X-Priority, который используется почтовыми клиентами для сортировки и выделения важных сообщений.

Синтаксис

$email->priority(int $priority): static

Пример

Давайте создадим письмо и установим ему высокий приоритет:

<?php
	namespace App\Controller;
	
	use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
	use Symfony\Component\HttpFoundation\Response;
	use Symfony\Component\Mailer\MailerInterface;
	use Symfony\Component\Mime\Email;
	use Symfony\Component\Routing\Attribute\Route;
	
	class EmailController extends AbstractController
	{
		#[Route('/email/priority', name: 'email_priority')]
		public function send(MailerInterface $mailer): Response
		{
			$email = (new Email())
				->from('sender@example.com')
				->to('recipient@example.com')
				->subject('Important message')
				->text('hello')
				->priority(1);
			
			$mailer->send($email);
			
			return new Response('Email sent');
		}
	}
?>

Результат выполнения кода:

"Email sent"

Пример

Давайте установим низкий приоритет письма:

<?php
	namespace App\Controller;
	
	use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
	use Symfony\Component\HttpFoundation\Response;
	use Symfony\Component\Mailer\MailerInterface;
	use Symfony\Component\Mime\Email;
	use Symfony\Component\Routing\Attribute\Route;
	
	class EmailController extends AbstractController
	{
		#[Route('/email/low', name: 'email_low')]
		public function send(MailerInterface $mailer): Response
		{
			$email = (new Email())
				->from('sender@example.com')
				->to('recipient@example.com')
				->subject('Newsletter')
				->text('abcde')
				->priority(5);
			
			$mailer->send($email);
			
			return new Response('Email sent');
		}
	}
?>

Результат выполнения кода:

"Email sent"

Пример

Давайте проверим установленный приоритет через заголовки письма:

<?php
	use Symfony\Component\Mime\Email;
	
	$email = (new Email())
		->from('sender@example.com')
		->to('recipient@example.com')
		->subject('article')
		->text('hello')
		->priority(2);
	
	$headers = $email->getHeaders();
	
	echo $headers->get('X-Priority')->getBody();
?>

Результат выполнения кода:

2 (High)

Смотрите также

класс Email,
который представляет электронное письмо
метод subject,
который задаёт тему письма
метод text,
который задаёт текстовое содержимое письма
метод getHeaders,
который возвращает заголовки письма