Download and Install

You can choose between several alternatives to install symfony, from the simplest to the most advanced one. If you need a step-by-step guide, refer to the installation chapter of the symfony book.

The sandbox

The sandbox is an empty symfony project where all the required libraries are already included, and where the basic configuration is already done. It is made for symfony beginners, who want to play with the framework or try the tutorials without installing anything.

You can download a sandbox:

• sf_sandbox_1_1.tgz
• sf_sandbox_1_1.zip

Unpack it in your root web directory. Refer to the included README file for more information.

After downloading the sandbox, you might want to follow the My first project tutorial to discover the basics of symfony development.

Source Download

If you want to customize your own installation, or if you want to browse the symfony source without installing it, you might prefer a simple download.

To create a shortcut to the symfony CLI, refer to the installation chapter for more details.

Download as an archive

• symfony-1.1.0.tgz
• symfony-1.1.0.zip

Checkout from the Subversion repository

To check out the 1.1 release, type in a command line:

$ svn co http://svn.symfony-project.com/branches/1.1

Use svn:externals

If your project is already under version control with SVN, you might want to use symfony as a svn:externals dependency. To do so, browse to the root of the project where you want to put symfony in, and type:

$ svn propedit svn:externals lib/vendor

# your favorite text editor then opens, and you must then type
symfony http://svn.symfony-project.com/branches/1.1

Browse the source online

Head to the source browser of the symfony trac.

PEAR installation

The PEAR installation is for those who want to run several symfony-based projects, with an easy way to upgrade. It requires PEAR version 1.4.0 or higher, which is bundled in most PHP distributions.

Type in the command line:

$ pear channel-discover pear.symfony-project.com

Then, to install the latest 1.1 release:

$ pear install symfony/symfony-1.1.0

Linux installation

Some Linux distributions have symfony packages. As of now, packages have been created for Debian like distributions and SUSE.

• Debian/Ubuntu package:
  • Add to your /etc/apt/sources.list:

    $ deb http://www.symfony-project.org/get debian/

  • Run as root:

    $ apt-get update

  • Install it:

    $ apt-get install php5-symfony

• SUSE package is available in the server:php:applications repository:

  http://software.opensuse.org/download/server:/php:/applications/

User-contributed guides

The symfony wiki contains a few articles describing step-by-step installations on various platforms.

The forum has a dedicated section where many installation issues have already been solved, and where you will find a symfony user willing to help you in minutes if you have a new problem.