/**
 * @Route("/chemin/de/la/route")
 */

/**
 * @Route("/edit/{id}", name="edit", requirements={"id":"\d+"})
 */

/**
 * @Route("/{page}", name="index", requirements={"page": "\d+"}, defaults={"page" = 1})
 * /

/**
 * @Route("/new", methods={"GET", "POST"})
 * /

/**
 * @ORM\Entity(repositoryClass="Namespace\De\La\Classe")
 * @ORM\Table(name="nom_de_la_table")
 */

/**
 * @ORM\Column(name="nom_du_champ", type="string|text|integer|float|datetime|json_array", nullable=true, length=255)
 */

/**
 * @ORM\Entity(repositoryClass="App\Repository\ImageRepository")
 * @ORM\HasLifecycleCallbacks
 */

/**
 * @ORM\PrePersist()
 */
public function prePersist()
{
}

/**
 * @ORM\OneToOne(targetEntity="App\Entity\Image", cascade={"all"}, orphanRemoval=true)
 * @var ?\App\Entity\Image
 */
private $image;

/**
 * @ORM\ManyToOne(targetEntity="Category", inversedBy="articles")
 */

/**
 * @ORM\OneToMany(targetEntity"Article", mappedBy="category")
 */

/**
 * @ORM\ManyToMany(targetEntity="App\Entity\Category", inversedBy="articles")
 * @var ?\Doctrine\Common\Collections\ArrayCollection
 */
private $categories;

/**
 * @ORM\ManyToMany(targetEntity="App\Entity\Articles", mappedBy="categories)
 */
private $articles;

// Panier
/**
 * @ORM\OneToMany(targetEntity="PanierProduit", mappedBy="panier")
 */

// PanierProduit
/**
 * @ORM\ManyToOne(targetEntity="Panier", inversedBy="panierProduits")
 */

/**
 * @ORM\ManyToOne(targetEntity="Produit", inversedBy="panierProduits")
 */

// Produit
/**
* @ORM\ManyToOne(targetEntity="PanierProduit", mappedBy="produit")
*/

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ->add('title')
        ->add('content')
    ;
}

// use Symfony\Component\Form\Extension\Core\Type;
$builder->add('status', Type\ChoiceType::class, array(
    'label' => 'article.status',
    'choices' => array(
        'status.public' => 'public',
        'status.private' => 'private',
        'status.draft' => 'draft',
    ),
    'expanded' => true, // Affiche le champ sous forme de radio
    'multiple' => false, // Choix multiple ou non ()
    'required' => true, // champ requis ou non 
) ) // type string dans la db

->add('categories', null, array( // Type\EntityType::class
    'label' => 'article.categories',
    'expanded' => true,
    'query_builder' => function(EntityRepository $er) {
        return $er->createQueryBuilder('c')
            ->orderBy('c.name', 'ASC')
            // ->where('c.status = "public"')
        ;
    } 
))

// Evénement pour ajouter ou non le champ "deleteImage" 
$builder->addEventListener(FormEvents::PRE_SET_DATA, function(FormEvent $event) {
    $entity = $event->getData(); // Entité envoyée au formulaire 
    $form = $event->getForm(); // Récupére le formulaire

    if (!is_null($entity->getImage())) { // S'il y a une image dans mon article
        // Ajout du champ "deleteImage" seulement s'il y a une image
        $form->add('deleteImage', Type\CheckboxType::class, array(
            'label' => 'image.delete',
            'required' => false, // Désactive le required
        ));
    }
});

// use App\Form\ImageType;
$builder->add('image', ImageType::class)

// src/Twig

namespace App\Twig;

use Twig\Extension\AbstractExtension;
use Twig\TwigFilter;
use Twig\TwigFunction;

class AppExtension extends AbstractExtension
{
    public function getFilters()
    {
        return [
            new TwigFilter('nom', [$this, 'nomDeLaMethode'])
        ];
    }
}

public function findPublishedByUser(User $user)
{
    $qb = $this->createQueryBuilder('a')
        ->andWhere('a.pusblished = :published')
        ->andWhere('a.user = :user')
        ->setParameter('published', true)
        ->setParameter('user', $user) // Objet User
        ->getQuery()
    ;

    // Retourne un tableau d'objets Article
    return $qb->getResult(); // $qb->execute();
}

public function findByPage($page = 1, $count = 10)
{
    $offset = ($page - 1) * $count; // Calcul offset de la requête

    $queryBuilder = $this->createQueryBuilder('a')
        ->select('a, u, c') // Ajoute l'utilisateur et les catégories pour optimiser le nombre de requêtes
        ->leftJoin('a.user', 'u')
        ->leftJoin('a.categories', 'c')
        ->setFirstResult($offset) // OFFSET
        ->setMaxResults($count) // LIMIT
        ->orderBy('a.id', 'DESC')
    ;

    return new Paginator($queryBuilder); // Liste + nombre total
}

public function findLastByUser($user)
{
    $qb = $this->createQueryBuilder('a')
        ->andWhere('a.user = :user')
        ->setParameter('user', $user) // Objet User
        ->orderBy('a.id', 'DESC')
        ->setMaxResults(1)
        ->getQuery()
    ;

    return $qb->getOneOrNullResult(); // 1 objet Article ou null
}

// Sf < 4.2
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Security;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;

use Symfony\Component\Translation\TranslatorInterface;

/**
 * Définit un prefix pour le nom et le chemin des routes de ce controller
 * @Route('admin/article', name="article_admin_")
 * 
 * Autorise seulement les membre avec ces rôles
 * @Security("is_granted('ROLE_ADMIN') and is_granted('ROLE_MODERATOR')")
 */
class ArticleController extends AbstractController
{
    /**
     * @Route("/index", name="index")
     */
    public function index(Request $request, ArticleRepository $articleRepository /* SF 4 */) : Response // Sf < 4 => indexAction
    {
        // SF < 4
        /*
        $em = $this->getDoctrine()->getManager();
        $articles = $em->getRepository(Article::class)->findAll();
        */

        // SF 4
        $articles = $articleRepository->findAll();

        // Retourne une réponse avec le rendu de la vue twig
        return $this->render('admin/article/index.html.twig', array(
            'articles' => $articles,
        ));
    }

    /**
     * @Route("/new", name="new")
     */
    public function new(Request $request, TranslatorInterface $translator /* SF 4 */) : Response
    {
        $entity = new Article;
        $entity->setUser($this->getUser()); // Récupére l'utilisateur connecté
        // Création du formulaire à partir de la classe ArticleType
        $form = $this->createForm(ArticleType::class, $entity);
        // Envois la requête au formulaire
        $form->handleRequest($request);

        // Tester si le formulaire est envoyé et s'il est valide
        if ($form->isSubmitted() && $form->isValid()) {

            $em = $this->getDoctrine()->getManager();
            $em->persist($entity); // PDO -> prepare
            $em->flush(); // PDO -> execute

            // SF < 4.2
            //$translator = $this->get('translator');

            $this->addFlash('success', $translator->trans('article.new.success'));

            return $this->redirectToRoute('article_admin_index');
        }

        return $this->render('admin/article/new.html.twig', array(
            'form' => $form->createView()
        ));
    }
}

if ($request->isXmlHttpRequest()) {

    return $this->json(array(
        'var' => $var,
    ));
} 

// src/Form/AdminMenuBuilder.php
public function createMenu()
{
    $menu = $this->factory->createItem('root');

    // Ajouter un item
    $parent = $menu->addChild('chaine.a.traduire', [
        'route' => 'nom_de_la_route', 
        'routeParameters' => ['id' => 1 ],
        'attributes' => ['class' => 'test']
    ]);

    // ajouter un sous-menu, on ajoute des item au menu parent
    $parent->addChild('sous-item');

    // Item avec lien externe
    $menu->addChild('page.facebook', ['uri' => 'http://www.facebook.com']);
}