====== Contrôleur ======

Savoir s'il s'agit d'une requête Ajax :
<code php>$this->get('request')->isXmlHttpRequest()</code>

====== Ressources liées (JS, CSS, images, etc) ======

Les placer dans le sous-répertoire Resources/public/ du Bundle (avec éventuellement d'autres sous-répertoires).

Et côté Twig, les référencer par :
<code>href="{{ asset('@NomDuBundle/Resources/public/...') }}"</code>
Pour les fichiers JS et CSS, on peut déclarer ces fichiers annexes d'un coup, sous formes de tableau et/ou employer un motif type glob :
<code>{% javascripts
    '@AcmeFooBundle/Resources/public/js/thirdparty/jquery.js'
    '@AcmeFooBundle/Resources/public/js/*'
%}
<script src="{{ asset_url }}"></script>
{% endjavascripts %}</code>
<code>{% stylesheets
    '@AcmeFooBundle/Resources/public/main.css'
    '@AcmeFooBundle/Resources/public/css/*'
%}
<link rel="stylesheet" href="{{ asset_url }}" />
{% endstylesheets %}</code>

Leur copie/déploiement se fait avec la commande :
<code>php app/console assets:install web
# en dev ?
php app/console assetic:dump</code>

====== Modèle ======

Définir ses propres méthodes de requêtage :

Créer son repository dans src/**application**/**bundle**/Repository/XRepository.php
Exemple :
<code php><?php
namespace NomApplication\NomBundle\Repository;

use Doctrine\ORM\EntityRepository;

class XRepository extends EntityRepository
{
    public function findAllOrderedByName()
    {
        return $this->getEntityManager()
            ->createQuery('SELECT x FROM NomApplication\NomBundle\Entity\X x ORDER BY x.nom ASC')
            ->getResult();
    }
}</code>
Puis faire le lien au niveau de l'entité par une annotation, src/**application**/**bundle**/Entity/X.php :
<code php>@ORM\Entity(repositoryClass="NomApplication\NomBundle\Repository\XRepository")</code>
(commentaire avant la classe)

Mettre à jour les tables :
<code>cd .../Symfony
php app/console doctrine:schema:update --force</code>

====== Vue (Twig) ======

Créer un lien relatif (a) : path
<code>{{ path('<nom de la route telle que définie dans routing.yml>', { 'param1': 'valeur1', 'param2': 'valeur2' }) }}</code>
Pour un lien absolu, utiliser la fonction url.

Inclure des css, image, js, etc : asset
<code>{{ asset('css/style.css') }}</code>

Affichage en fonction du rôle de l'utilisateur : is_granted
<code html>{% if is_granted('ROLE_ADMIN') %}
<!-- Je suis Administrateur -->
{% endif %}</code>

Alterner les classes/couleurs lors d'un for Twig :
<code html><table>
    {% for element in collection %}
    <tr class="{{ cycle(['even', 'odd'], loop.index) }}">
        <td>{{ element.name }}</td>
    </tr>
    {% endfor %}
</table></code>

====== Messages flash ======

À définir dans le contrôleur :
<code php>$this->get('session')->setFlash('notice', 'Congratulations, your action succeeded!');</code>
L'afficher dans la vue (Twig) :
<code html>{% if app.session.hasFlash('notice') %}
    <div class="flash-notice">{{ app.session.flash('notice') }}</div>
{% endif %}</code>


====== Installer Symfony2 ======

  * Télécharger Symfony2 (without vendors pour les gérer avec git)
  * Mon répertoire d'installation est /home/julp/www/, fichier télécharger dans ~/Downloads/ :<code>tar xzf ~/Downloads/Symfony_Standard_2.0.12.tgz -C ~/www/</code>
  * Déplaçons nous vers ~/www/Symfony :<code>cd ~/www/Symfony</code>
  * Si on n'a pas pris les vendors, les installer :<code>php bin/vendors install</code>
  * éditer la configuration d'Apache (Arborescence Gentoo):<code>sudo vi /etc/apache2/vhosts.d/default_vhost.include</code>
  * Pour modifier :
    * DocumentRoot "/var/www/localhost/htdocs" en DocumentRoot "/home/julp/www/Symfony/web"
    * <Directory "/var/www/localhost/htdocs"> en <Directory "/home/julp/www/Symfony/web">
    * (optionnel) Supprimer le Indexes ou ajouter un moins devant à la ligne Options
    * (optionnel) Ajouter une ligne DirectoryIndex app_dev.php dans le bloc <Directory></Directory>
  * Ici, étant donné qu'on travaille sur le home, il faut modifier quelques permissions (vu que c'est en local, inutile de s'enquiquiner avec des acl) :<code>chmod 0777 app/cache
chmod 0777 app/logs</code>

====== Versionner son projet Symfony2 avec Mercurial ======

  * ça doit être fait du répertoire Symfony :<code>cd ~/www/Symfony/</code>
  * initialiser le dépôt :<code>hg init</code>
  * créer le fichier (~/www/Symfony/).hgignore à la racine tel que (syntaxe glob) :<code>LICENSE
README.md
.lock
web/bundles/
app/bootstrap*
app/cache/*
app/logs/*
vendor/
app/config/parameters.ini</code>
  * par exemple, pour faire un premier commit après avoir supprimé Acme et ajouter .hgignore :<code>rm -rf src/Acme
rm -rf web/bundles/acmedemo
hg add app/AppKernel.php app/config/routing_dev.yml .hgignore
hg commit # un éditeur sera ouvert pour écrire le message
hg push</code>

Dans l'autre sens, il suffit de hg clone (avec . en destination - le répertoire doit être vide) puis d'installer Symfony (sans écraser les fichiers existants).

====== Doctrine, PostgreSQL et types date/heure ======

Comme expliqué dans [[http://readthedocs.org/docs/doctrine-dbal/en/2.0.x/reference/known-vendor-issues.html|la documentation de Doctrine]], à moins de remapper ces types pour Doctrine, il ne faut pas conserver les microsecondes. Ainsi :
  * TIMESTAMP devient TIMESTAMP(0)<code sql>ALTER TABLE <nom de la table> ALTER COLUMN <nom de la colonne> TYPE TIMESTAMP(0);</code>
  * TIME devient TIME(0)