A bit tweaked "Symfony Standard Edition" distribution
This distribution is based on the Symfony Standard Edition, where the AcmeDemo
bundle has been removed and the .gitignore tweaked. A new file
has been added to centralized the IP allowed to access the application in development
web/config.php). This feature allows you to easily manage
external IP when you're developing on a remote server. You should howewer remove the
web/config.php file when your app goes to production.
When you want to allow a new IP, just add it to the
app/AllowedIP.php file. As this
file is added to the
.gitignore, your modif will not be commited.
Welcome to the Symfony Standard Edition - a fully-functional Symfony2 application that you can use as the skeleton for your new applications.
This document contains information on how to download, install, and start using Symfony. For a more detailed explanation, see the Installation chapter of the Symfony Documentation.
- Installing the Standard Edition
When it comes to installing the Symfony Standard Edition, you have the following options.
As Symfony uses Composer to manage its dependencies, the recommended way to create a new project is to use it.
If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:
curl -s http://getcomposer.org/installer | php
Then, use the
create-project command to generate a new Symfony application:
php composer.phar create-project --stability="dev" pyrech/symfony-standard-edition path/to/install
Composer will install Symfony and all its dependencies under the
To quickly test Symfony, you can also download an archive of the Standard Edition and unpack it somewhere under your web server root directory.
If you downloaded an archive "without vendors", you also need to install all the necessary dependencies. Download composer (see above) and run the following command:
php composer.phar install
- Checking your System Configuration
Before starting coding, make sure that your local system is properly configured for Symfony.
check.php script from the command line:
The script returns a status code of
0 if all mandatory requirements are met,
config.php script from a browser:
If you get any warnings or recommendations, fix them before moving on.
- Browsing the Demo Application
Congratulations! You're now ready to use Symfony.
config.php page, click the "Bypass configuration and go to the
Welcome page" link to load up your first Symfony page.
You can also use a web-based configurator by clicking on the "Configure your
Symfony Application online" link of the
- Getting started with Symfony
This distribution is meant to be the starting point for your Symfony applications, but it also contains some sample code that you can learn from and play with.
A great way to start learning Symfony is via the Quick Tour, which will take you through all the basic features of Symfony2.
Once you're feeling good, you can move onto reading the official Symfony2 book.
You should also tweak the
security.providers entry in the
security.yml file to
fit your needs.
The Symfony Standard Edition is configured with the following defaults:
Twig is the only configured template engine;
Doctrine ORM/DBAL is configured;
Swiftmailer is configured;
Annotations for everything are enabled.
It comes pre-configured with the following bundles:
FrameworkBundle - The core Symfony framework bundle
SensioFrameworkExtraBundle - Adds several enhancements, including template and routing annotation capability
DoctrineBundle - Adds support for the Doctrine ORM
TwigBundle - Adds support for the Twig templating engine
SecurityBundle - Adds security by integrating Symfony's security component
SwiftmailerBundle - Adds support for Swiftmailer, a library for sending emails
MonologBundle - Adds support for Monolog, a logging library
AsseticBundle - Adds support for Assetic, an asset processing library
WebProfilerBundle (in dev/test env) - Adds profiling functionality and the web debug toolbar
SensioDistributionBundle (in dev/test env) - Adds functionality for configuring and working with Symfony distributions
SensioGeneratorBundle (in dev/test env) - Adds code generation capabilities
All libraries and bundles included in the Symfony Standard Edition are released under the MIT or BSD license.