Services

Un service est une classe PHP indépendante et autonome. On dit souvent “un contrôleur qui ne retourne pas de Twig”, donc il fait des choses mais pas d’affichage.

On crée un service quand on a deux contrôleurs qui font la même chose. Par exemple, pour afficher la météo dans plusieurs Twig, on peut créer un service qui affiche la météo et qui est appelé dans les contrôleurs.

Les services sont faciles à tester et réutilisables, ils permettent d’avoir des contrôleurs lisibles et propres et d’avoir du code réutilisable.

BP : On peut mettre la BLL dans nos services —> si on utilise trois fois un findAll(), ça vaut le coup de faire un service. BP : On peut créer un service si le contrôleur est trop grand (>20lignes) —>moche, illisible, difficile à tester.

Créer un service

• on crée une classe PHP dans un dossier spécifique de src (par exemple, src/Service)

• on crée les méthodes que l’on veut

Utiliser un service

Un service est typiquement utilisé depuis un contrôleur.

• on appelle un service en injection de dépendances et on utilise la méthode à travers l’instance

Problème ?

Un contrôleur injecte un service, qui lui aussi injecte d’autres services.

Dans ce cas, on ne peut pas lui injecter les services comme d’habitude : on n’est plus dans un contrôleur mais dans un service (classe PHP).

Pour injecter des dépendances dans un service, on doit lui créer un constructeur __construct().

• on lui ajoute un attribut qui sera l’instance de la dépendance injectée

• on injecte la dépendance dans le constructeur

• on instancie l’attribut

use Doctrine\ORM\EntityManagerInterface;

class SomeService
{
	protected $entityManager;
	public function __construct(
		EntityManagerInterface $entityManager
	)
{
	$this->entityManager = $entityManager;
}

Services internes de Symfony

liste : symfony console debug:container

services qu'on peut recevoir en injection : symfony console debug:autowiring

Ainsi quand on en crée un, il est ajouté à la liste.

Démonstration

Un service qui envoie un mail.

Souvent on les met dans un dossier Service dans src.

• New PHP class > MailService.

(on lance papercut)

• on injecte MailerInterface (en constructeur)

• Symfony\Component\Mime

• avec text on met du texte, on peut utiliser du html et même un twig

namespace App\Service;

class MailService 
{
	private $mailer;

	public function __construct(MailerInterface $mailer)
{
	$this->mailer = $mailer;
}

	public function sendEmail() {
		$email = (new Email())
			->from('brucewayne@eni.fr')
			->to('batman@eni.fr')
			->cc('alfred@eni.fr')
			->replyTo('gordon@eni.fr')
			->subject('Le joker est revenu')
			->text('blablabla')
			->html('<a href="https://fr.wikipedia.org/wiki/Joker_(personnage)">Joker</a>');
			$this->mailer->send($email);
	}
}

On va l’utiliser : dans un contrôleur (ex: serie), dans la méthode list()

• on injecte notre service

• on utilise la méthode via l’instance

...
public function list(
		...,
		MailService $mailService
): Response
{
	...
	$mailService->sendEmail();
}