Editing Setting Up Symfony Projects

== Overview ==

Notes on tasks related to setting up web projects using the [http://symfony.com/doc/current/index.html Symfony] framework.

== Resource locations ==

* '''Controllers:''' `src/AppBundle/Controller/`
* '''Models''' (Entities): `src/AppBundle/Entity/`
* '''Templates:''' `app/Resources/views/`
* '''Sass:''' `app/Resources/assets/`
* '''Stylesheets:'''
** With Assetic: `src/AppBundle/Resources/public/sass/` ''< (?)''
** Without Assetic" `web/css/`
* '''Images:'''
** With Assetic: `src/AppBundle/Resources/public/images/`
** Without Assetic" `web/images/`
* '''JavaScript:'''
** With Assetic: `src/AppBundle/Resources/public/js/`
** Without Assetic" `web/js/`

''With the Assetic paths, `src\AppBundle\` is the location of the default app bundle, use whatever is appropriate for other bundles.''

== Templates ==

=== Twig template documentation ===

* Basics of syntax: [http://twig.sensiolabs.org/doc/templates.html Twig for Template Designers]

== Compass/Sass ==

=== Installation & Configuration ===

Install Compass into `[project_root]app/Resources/assets/`:

<syntaxhighlight lang="powershell">
m:\path\to\project\app\Resources\assets\> compass init
</syntaxhighlight>

The stylesheets will be written to `[project_root]web/css/`.

See also [[Creating_a_New_Local_Development_Site#Install_.26_configure_Sass_.26_Compass|Install & Configure Sass & Compass]]

=== Assetic ===

<span style="color:red">Maybe look into this more. Sass/Assetic combination is not well documented. Not sure how to watch for changes in a whole directory outside of a bundle.</span>

Assetic is an asset management tool created specifically for Symfony2. It looks like it can be used in place of grunt for the purposes of compiling Sass. The main benefit is that it saves the step of opening a shell and start up grunt to compile.<ref>[http://symfony.com/doc/current/cookbook/assetic/asset_management.html How To Use Assetic for Asset Management], Symfony documentation</ref>

==== See also ====

* [http://alexandre-salome.fr/blog/Sass-Compass-Assetic-In-Ten-Minutes Sass, Compass, and Assetic in 10 minutes] (Alexandre Salomé)

== Notes ==
<references/>



[[Category:Symfony]] [[Category:PHP]] [[Category:CMS]] [[Category:Web Development]]