Step 2: Introducing the Project

• • Revealing the Project
  • Looking at the Final Infrastructure Diagram

Introducing the Project

As the book has to be released during SymfonyCon Amsterdam, it might be nice if the project is somehow related to Symfony and conferences. What about a ? A livre d’or as we say in French. I like the old-fashioned and outdated feeling of developing a guestbook in 2019!

We have it. The project is all about getting feedback on conferences: a list of conferences on the homepage, a page for each conference, full of nice comments. A comment is composed of some small text and an optional photo taken during the conference. I suppose I have just written down all the specifications we need to get started.

The project will contain several applications. A traditional web application with an HTML frontend, an API, and an SPA for mobile phones. How does that sound?

Learning is doing. Period. Reading a book about Symfony is nice. Coding an application on your personal computer while reading a book about Symfony is even better. This book is very special as everything has been done to let you follow along, code, and be sure to get the same results as I had locally on my machine when I coded it initially.

The book contains all the code you need to write and all the commands you need to execute to get the final result. No code is missing. All commands are written down. This is possible because modern Symfony applications have very little boilerplate code. Most of the code we will write together is about the project’s business logic. Everything else is mostly automated or generated automatically for us.

Even if the project idea seems simple, we are not going to build an “Hello World”-like project. We won’t only use PHP and a database.

The goal is to create a project with some of the complexities you might find in real-life. Want a proof? Have a look at the final infrastructure of the project:

One of the great benefit of using a framework is the small amount of code needed to develop such a project:

• 20 PHP classes under for the website;
• 550 PHP Logical Lines of Code (LLOC) as reported by PHPLOC;
• 40 lines of configuration tweaks in 3 files (via annotations and YAML), mainly to configure the backend design;
• 20 lines of development infrastructure configuration (Docker);
• 100 lines of production infrastructure configuration (SymfonyCloud);

Ready for the challenge?

To continue on the old-fashioned theme, I could have created a CD containing the source code, right? But what about a Git repository companion instead?

Clone the somewhere on your local machine:

This repository contains all the code of the book.

Note that we are using symfony new instead of as the command does more than just cloning the repository (hosted on Github under the the-fast-track organization: ). It also starts the web server, the containers, migrates the database, loads fixtures, … After running the command, the website should be up and running, ready to be used.

The code is 100% guaranteed to be synchronized with the code in the book (use the exact repository URL listed above). Trying to manually synchronize changes from the book with the source code in the repository is almost impossible. I tried in the past. I failed. It is just impossible. Especially for books like the ones I write: books that tells you a story about developing a website. As each chapter depends on the previous ones, a change might have consequences in all following chapters.

Even better, the repository is not just about the final version of the code on the master branch. The script executes each action explained in the book and it commits its work at the end of each section. It also tags each step and substep to ease browsing the code. Nice, isn’t it?

If you are lazy, you can get the state of the code at the end of a step by checking out the right tag. For instance, if you’d like to read and test the code at the end of step 10, execute the following:

Like for cloning the repository, we are not using but symfony book:checkout. The command ensures that whatever the state you are currently in, you end up with a functional website for the step you ask for. Be warned that all data, code, and containers are removed by this operation.

You can also check out any substep:

Again, I highly recommend you code yourself. But if you get stuck, you can always compare what you have with the content of the book.

Not sure that you got everything right in substep 10.2? Get the diff:

Want to know when a file has been created or modified?

This work, including the code samples, is licensed under a Creative Commons BY-NC-SA 4.0 license.