The Symfony Framework Best Practices

What is this Guide About?

This guide aims to fix that by describing the best practices for developing web apps with the Symfony full-stack Framework. These are best practices that fit the philosophy of the framework as envisioned by its original creator Fabien Potencier.

This guide is specially suited for:

• Websites and web applications developed with the full-stack Symfony Framework.

For other situations, this guide might be a good starting point that you can then extend and fit to your specific needs:

• Bundles shared publicly to the Symfony community;
• Advanced developers or teams who have created their own standards;
• Some complex applications that have highly customized requirements;
• Bundles that may be shared internally within a company.

We know that old habits die hard and some of you will be shocked by some of these best practices. But by following these, you'll be able to develop apps faster, with less complexity and with the same or even higher quality. It's also a moving target that will continue to improve.

Keep in mind that these are optional recommendations that you and your team may or may not follow to develop Symfony applications. If you want to continue using your own best practices and methodologies, you can of course do it. Symfony is flexible enough to adapt to your needs. That will never change.

Who this Book Is for (Hint: It's not a Tutorial)

Any Symfony developer, whether you are an expert or a newcomer, can read this guide. But since this isn't a tutorial, you'll need some basic knowledge of Symfony to follow everything. If you are totally new to Symfony, welcome! Start with The Quick Tour tutorial first.

We've deliberately kept this guide short. We won't repeat explanations that you can find in the vast Symfony documentation, like discussions about Dependency Injection or front controllers. We'll solely focus on explaining how to do what you already know.

The Application

In addition to this guide, a sample application has been developed with all these best practices in mind. This project, called the Symfony Demo application, can be obtained through the Symfony Installer. First, download and install the installer and then execute this command to download the demo application:

1
2
3
4
5

# Linux and Mac OS X
$ symfony demo

# Windows
c:\> php symfony demo

The demo application is a simple blog engine, because that will allow us to focus on the Symfony concepts and features without getting buried in difficult implementation details. Instead of developing the application step by step in this guide, you'll find selected snippets of code through the chapters.

Don't Update Your Existing Applications

After reading this handbook, some of you may be considering refactoring your existing Symfony applications. Our recommendation is sound and clear: you should not refactor your existing applications to comply with these best practices. The reasons for not doing it are various:

• Your existing applications are not wrong, they just follow another set of guidelines;
• A full codebase refactorization is prone to introduce errors in your applications;
• The amount of work spent on this could be better dedicated to improving your tests or adding features that provide real value to the end users.

Next: Creating the Project