Repository files navigation

This is the official installer to start new projects based on the Symfonyfull-stack framework. The installer is only compatible with Symfony 2 and 3.

This installer is not compatible with Symfony 4 and newer versions. Instead,useComposer and create your Symfony 4 project as follows:

$ composer create-project symfony/skeleton my_project_name

See theSymfony Installation articleon the official Symfony Documentation for more details.

This step is only needed the first time you use the installer:

$ sudo curl -LsS https://symfony.com/installer -o /usr/local/bin/symfony$ sudo chmod a+x /usr/local/bin/symfony

c:\> php -r"file_put_contents('symfony', file_get_contents('https://symfony.com/installer'));"

Move the downloadedsymfony file to your projects directory and executeit as follows:

c:\> php symfony

If you prefer to create a globalsymfony command, execute the following:

c:\> (echo @ECHO OFF&echo php"%~dp0symfony" %*)> symfony.bat

Then, move both files (symfony andsymfony.bat) to any location includedin your execution path. Now you can run thesymfony command anywhere on yoursystem.

1. Start a new project with the latest stable Symfony version

Execute thenew command and provide the name of your project as the onlyargument:

# Linux, Mac OS X$ symfony new my_project# Windowsc:\> php symfony new my_project

2. Start a new project with the latest Symfony LTS (Long Term Support) version

Execute thenew command and provide the name of your project as the firstargument andlts as the second argument. The installer will automaticallyselect the most recent LTS (Long Term Support) version available:

# Linux, Mac OS X$ symfony new my_project lts# Windowsc:\> php symfony new my_project lts

3. Start a new project based on a specific Symfony branch

Execute thenew command and provide the name of your project as the firstargument and the branch number as the second argument. The installer willautomatically select the most recent version available for the given branch:

# Linux, Mac OS X$ symfony new my_project 2.8# Windowsc:\> php symfony new my_project 2.8

4. Start a new project based on a specific Symfony version

Execute thenew command and provide the name of your project as the firstargument and the exact Symfony version as the second argument:

# Linux, Mac OS X$ symfony new my_project 2.8.1# Windowsc:\> php symfony new my_project 2.8.1

5. Install the Symfony demo application

The Symfony Demo is a reference application developed using the official SymfonyBest Practices:

# Linux, Mac OS X$ symfony demo# Windowsc:\> php symfony demo

New versions of the Symfony Installer are released regularly. To update yourinstaller version, execute the following command:

# Linux, Mac OS X$ symfony self-update# Windowsc:\> php symfony self-update

NOTE

If your system requires the use of a proxy server to download contents, theinstaller tries to guess the best proxy settings from theHTTP_PROXY andhttp_proxy environment variables. Make sure any of them is set beforeexecuting the Symfony Installer.

If you experience any error related with SSL or security certificates when usingthe Symfony Installer on Windows systems:

1. Check that the OpenSSL extension is enabled in yourphp.ini configuration:

; make sure that the following line is uncommentedextension=php_openssl.dll

2. Check that the path to the file that contains the security certificatesexists and is defined inphp.ini:

openssl.cafile=C:/path/to/cacert.pem

If you can't locate thecacert.pem file anywhere on your system, you cansafely download it from the official website of the cURL project:http://curl.haxx.se/ca/cacert.pem