PHPackages                             symfony/symfony-installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. symfony/symfony-installer

AbandonedArchivedLibrary[Framework](/categories/framework)

symfony/symfony-installer
=========================

The official installer to create projects based on the Symfony full-stack framework.

v1.5.11(8y ago)3542.3k110[1 issues](https://github.com/symfony/symfony-installer/issues)MITPHPPHP &gt;=5.4.0

Since Nov 5Pushed 7y ago43 watchersCompare

[ Source](https://github.com/symfony/symfony-installer)[ Packagist](https://packagist.org/packages/symfony/symfony-installer)[ RSS](/packages/symfony-symfony-installer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (44)Used By (0)

Symfony Installer
=================

[](#symfony-installer)

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

Creating Symfony 4 projects
---------------------------

[](#creating-symfony-4-projects)

**This installer is not compatible with Symfony 4** and newer versions. Instead, use [Composer](https://getcomposer.org/) and create your Symfony 4 project as follows:

```
$ composer create-project symfony/skeleton my_project_name
```

See the [Symfony Installation article](https://symfony.com/doc/current/setup.html)on the official Symfony Documentation for more details.

Installing the installer
------------------------

[](#installing-the-installer)

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

### Linux and Mac OS X

[](#linux-and-mac-os-x)

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

### Windows

[](#windows)

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

Move the downloaded `symfony` file to your projects directory and execute it as follows:

```
c:\> php symfony
```

If you prefer to create a global `symfony` command, execute the following:

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

Then, move both files (`symfony` and `symfony.bat`) to any location included in your execution path. Now you can run the `symfony` command anywhere on your system.

Using the installer
-------------------

[](#using-the-installer)

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

Execute the `new` command and provide the name of your project as the only argument:

```
# Linux, Mac OS X
$ symfony new my_project

# Windows
c:\> php symfony new my_project
```

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

Execute the `new` command and provide the name of your project as the first argument and `lts` as the second argument. The installer will automatically select the most recent LTS (*Long Term Support*) version available:

```
# Linux, Mac OS X
$ symfony new my_project lts

# Windows
c:\> php symfony new my_project lts
```

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

Execute the `new` command and provide the name of your project as the first argument and the branch number as the second argument. The installer will automatically select the most recent version available for the given branch:

```
# Linux, Mac OS X
$ symfony new my_project 2.8

# Windows
c:\> php symfony new my_project 2.8
```

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

Execute the `new` command and provide the name of your project as the first argument and the exact Symfony version as the second argument:

```
# Linux, Mac OS X
$ symfony new my_project 2.8.1

# Windows
c:\> 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 Symfony Best Practices:

```
# Linux, Mac OS X
$ symfony demo

# Windows
c:\> php symfony demo
```

Updating the installer
----------------------

[](#updating-the-installer)

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

```
# Linux, Mac OS X
$ symfony self-update

# Windows
c:\> php symfony self-update
```

> **NOTE**
>
> If your system requires the use of a proxy server to download contents, the installer tries to guess the best proxy settings from the `HTTP_PROXY` and `http_proxy` environment variables. Make sure any of them is set before executing the Symfony Installer.

Troubleshooting
---------------

[](#troubleshooting)

### SSL and certificates issues on Windows systems

[](#ssl-and-certificates-issues-on-windows-systems)

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

1. Check that the OpenSSL extension is enabled in your `php.ini` configuration:

```
; make sure that the following line is uncommented
extension=php_openssl.dll
```

2. Check that the path to the file that contains the security certificates exists and is defined in `php.ini`:

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

If you can't locate the `cacert.pem` file anywhere on your system, you can safely download it from the official website of the cURL project:

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community33

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 65.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Recently: every ~153 days

Total

43

Last Release

2963d ago

Major Versions

v0.5.0 → v1.0.02015-02-27

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/47313?v=4)[Fabien Potencier](/maintainers/fabpot)[@fabpot](https://github.com/fabpot)

---

Top Contributors

[![javiereguiluz](https://avatars.githubusercontent.com/u/73419?v=4)](https://github.com/javiereguiluz "javiereguiluz (229 commits)")[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (56 commits)")[![xabbuh](https://avatars.githubusercontent.com/u/1957048?v=4)](https://github.com/xabbuh "xabbuh (13 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (6 commits)")[![Pierstoval](https://avatars.githubusercontent.com/u/3369266?v=4)](https://github.com/Pierstoval "Pierstoval (6 commits)")[![lyrixx](https://avatars.githubusercontent.com/u/408368?v=4)](https://github.com/lyrixx "lyrixx (6 commits)")[![jzawadzki](https://avatars.githubusercontent.com/u/1220891?v=4)](https://github.com/jzawadzki "jzawadzki (5 commits)")[![ogizanagi](https://avatars.githubusercontent.com/u/2211145?v=4)](https://github.com/ogizanagi "ogizanagi (4 commits)")[![1ed](https://avatars.githubusercontent.com/u/162986?v=4)](https://github.com/1ed "1ed (2 commits)")[![regniblod](https://avatars.githubusercontent.com/u/3084323?v=4)](https://github.com/regniblod "regniblod (2 commits)")[![aitboudad](https://avatars.githubusercontent.com/u/1753742?v=4)](https://github.com/aitboudad "aitboudad (2 commits)")[![94noni](https://avatars.githubusercontent.com/u/1358361?v=4)](https://github.com/94noni "94noni (2 commits)")[![JulienItard](https://avatars.githubusercontent.com/u/1370893?v=4)](https://github.com/JulienItard "JulienItard (2 commits)")[![sstok](https://avatars.githubusercontent.com/u/904790?v=4)](https://github.com/sstok "sstok (1 commits)")[![tvlooy](https://avatars.githubusercontent.com/u/391674?v=4)](https://github.com/tvlooy "tvlooy (1 commits)")[![victorhaggqvist](https://avatars.githubusercontent.com/u/1887628?v=4)](https://github.com/victorhaggqvist "victorhaggqvist (1 commits)")[![wouterj](https://avatars.githubusercontent.com/u/749025?v=4)](https://github.com/wouterj "wouterj (1 commits)")[![zanbaldwin](https://avatars.githubusercontent.com/u/123245?v=4)](https://github.com/zanbaldwin "zanbaldwin (1 commits)")[![chalasr](https://avatars.githubusercontent.com/u/7502063?v=4)](https://github.com/chalasr "chalasr (1 commits)")[![fivestar](https://avatars.githubusercontent.com/u/30999?v=4)](https://github.com/fivestar "fivestar (1 commits)")

---

Tags

installerphpsymfonyphpsymfonyframeworkinstaller

### Embed Badge

![Health badge](/badges/symfony-symfony-installer/health.svg)

```
[![Health](https://phpackages.com/badges/symfony-symfony-installer/health.svg)](https://phpackages.com/packages/symfony-symfony-installer)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[silverstripe/framework

The SilverStripe framework

7213.5M2.5k](/packages/silverstripe-framework)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[dragon-code/support

Support package is a collection of helpers and tools for any project.

238.7M101](/packages/dragon-code-support)[dingo-d/wp-pest

A package that will add WordPress integration test suite with Pest framework

12923.9k7](/packages/dingo-d-wp-pest)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
