Project Directory
Before installing symfony, you first need to create a directory that will host all the files related to your project:
$ mkdir -p /home/sfproject $ cd /home/sfproject
Or on Windows:
c:\> mkdir c:\dev\sfproject c:\> cd c:\dev\sfproject
note
Windows users are advised to run symfony and to setup their new
project in a path which contains no spaces.
Avoid using the Documents and Settings
directory, including anywhere
under My Documents
.
tip
If you create the symfony project directory under the web root directory, you won't need to configure your web server. Of course, for production environments, we strongly advise you to configure your web server as explained in the web server configuration section.
Symfony Installation
Create a directory to host the symfony framework library files:
$ mkdir -p lib/vendor
Now, you need to install symfony. As the symfony framework has several stable branches, you need to choose the one you want to install by reading the installation page on the symfony website.
Go to the installation page for the version you have just chosen, symfony 1.2 for instance.
Under the "Download as an Archive" section, you will find the archive in .tgz
or in .zip
format. Download the archive, put it under the freshly created
lib/vendor/
directory and un-archive it:
$ cd lib/vendor $ tar zxpf symfony-1.2.2.tgz $ mv symfony-1.2.2 symfony $ rm symfony-1.2.2.tgz
Under Windows, unzipping the zip file can be achieved using Windows Explorer.
After you rename the directory to symfony
, there should be a directory
structure similar to c:\dev\sfproject\lib\vendor\symfony
.
tip
If you use Subversion, it is even better to use the svn:externals
property to embed symfony into your project in the lib/vendor/
directory, which benefits from the bug fixes made in the stable branch
automatically:
http://svn.symfony-project.com/branches/1.2/
Check that symfony is correctly installed by using the symfony command line to
display the symfony version (note the capital V
):
$ cd ../.. $ php lib/vendor/symfony/data/bin/symfony -V
On Windows:
c:\> cd ..\.. c:\> php lib\vendor\symfony\data\bin\symfony -V
tip
If you are curious about what this command line tool can do for you, type
symfony
to list the available options and tasks:
$ php lib/vendor/symfony/data/bin/symfony
On Windows:
c:\> php lib\vendor\symfony\data\bin\symfony
The symfony command line is the developer's best friend. It provides a lot of utilities that improve your productivity for day-to-day activities like cleaning the cache, generating code, and much more.
This work is licensed under the Creative Commons Attribution-Share Alike 3.0 Unported License license.