Symfony 4 was released on November 30th.
Update now to the best Symfony ever!

You are browsing the Symfony 4 documentation, which changes significantly from Symfony 3.x. If your app doesn't use Symfony 4 yet, browse the Symfony 3.4 documentation.

Installing & Setting up the Symfony Framework

Installing & Setting up the Symfony Framework

Do you prefer video tutorials? Check out the Joyful Development with Symfony screencast series from KnpUniversity.

To create your new Symfony application, first make sure you're using PHP 7.1 or higher and have Composer installed. If you don't, start by installing Composer globally on your system. If you want to use a virtual machine (VM), check out Homestead.

Create your new project by running:

1
$ composer create-project symfony/skeleton my-project

This will create a new my-project directory, download some dependencies into it and even generate the basic directories and files you'll need to get started. In other words, your new app is ready!

Tip

You can also download a specific version of Symfony:

1
2
3
4
5
# use the most recent version in any Symfony branch
$ composer create-project symfony/skeleton my-project "3.3.*"

# use a beta or RC version (useful for testing new Symfony versions)
$ composer create-project symfony/skeleton my-project 3.3.0-BETA1

Some version are long-term support (LTS) versions. Read the Symfony Release process to learn more.

Running your Symfony Application

On production, you should use a web server like Nginx or Apache (see configuring a web server to run Symfony). But for development, it's even easier to use the Symfony PHP web server.

First, move into your new project and install the server:

1
2
cd my-project
composer require server --dev

To start the server, run:

1
$ php bin/console server:run

Open your browser and navigate to http://localhost:8000/. If everything is working, you'll see a welcome page. Later, when you are finished working, stop the server by pressing Ctrl+C from your terminal.

Tip

If you're using a VM, you may need to tell the server to bind to all IP addresses:

1
$ php bin/console server:start 0.0.0.0:8000

You should NEVER listen to all interfaces on a computer that is directly accessible from the Internet.

Storing your Project in git

Storing your project in git is easy! Just initialize you repository, add everything and commit:

1
2
3
$ git init
$ git add .
$ git commit -m "Initial commit"

Your project already has a sensible .gitignore file. And as you install more packages, a system called Flex will add more lines to that file when needed.

Troubleshooting: The Requirements Checker

If you're having any problems running Symfony, your system may be missing some technical requirements. Symfony has a "Requirements Checker" tool that you can use to easily make sure your system is set up. First, move into your project directory and install it:

1
$ composer require req-checker

The req-checker utility adds two PHP scripts to your application: vendor/bin/requirements-checker and public/check.php. Run the first one from your terminal:

1
php vendor/bin/requirements-checker

This will check your CLI environment. Run the second one from a browser (e.g. http://localhost:8000/check.php) to check your web server environment.

Once you've fixed any issues, uninstall the requirements checker:

1
$ composer remove req-checker

Setting up an Existing Symfony Project

If you're working on an existing Symfony application, you'll just need to do a few things to get your project setup. Assuming your team uses Git, you can setup your project with the following commands:

1
2
3
4
5
6
7
# clone the project to download its contents
$ cd projects/
$ git clone ...

# make Composer install the project's dependencies into vendor/
$ cd my-project/
$ composer install

You'll probably also need to customize your .env and do a few other project-specific tasks (e.g. creating database schema).

Checking for Security Vulnerabilities

Symfony provides a utility called the "Security Checker" (or sec-checker) to check whether your project's dependencies contain any known security vulnerability. Run this command to install it in your application:

1
2
$ cd my-project/
$ composer require sec-checker

From now on, this utility will be run automatically whenever you install or update any dependency in the application. If a dependency contains a vulnerability, you'll see a clear message.

The Symfony Demo application

The Symfony Demo Application is a fully-functional application that shows the recommended way to develop Symfony applications. It's a great learning tool for Symfony newcomers and its code contains tons of comments and helpful notes.

To check out its code and install it locally, see symfony/symfony-demo.

Start Coding!

With setup behind you, it's time to Create your first page in Symfony.

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