Installing and Configuring Symfony2 on Windows

Overview

Notes and instructions on installing Symfony2 on Windows, including notes and instructions on setting up a new project.

Prerequisites

• Composer, a dependency management library for PHP
  • Can be installed anywhere on the local computer. > curl -sS https://getcomposer.org/installer | php
  • littledamienii: c:/Composer
  • Using Composer: > php composer.phar

(Composer can also be configured to run by simply entering a composer command. See Executing .phar Files on Windows)

Creating a new project

Download Symfony distribution

> php composer.phar create-project symfony/framework-standard-edition /path/to/webroot/Symfony/ 2.3.4

• php composer.phar
  • Use Composer to download and install.
  • If composer.phar cannot be located use php c:\Composer\composer.phar
• create-project "Create project" parameter.
• symfony/framework-standard-edition
  • Symfony distribution to install.
  • TODO: Investigate options and determine best one. Esp. standard distribution vs. distribution without vendors.
• /path/to/webroot/Symfony/
  • Location of the Symfony project.
  • E.g. ./develop/littledamien/newproject/
  • TODO: A directory named web is installed below Symfony/ or newproject/. This is where requests are routed. All other files and directories should be non-public. Figure out the best naming convention for the project root directory, and where on the staging and production servers it should be located relative to public directories.
• 2.3.4 The version of Symfony to install. Leave this off to install the most recent version.

Create a new site in IIS

• The root directory of the site is [drive]:[\base\path\]newproject\web\

Test the new installation

• http://newproject.dbarchowsky.com/config.php
  • This will list recommendations to create an optimal environment for Symfony.
  • It's necessary to add the static IP of the gateway to the list of allowed IP address in web/config.php.
• If not connecting to the site using http://localhost, edit web/app_dev.php to add the remote address to the list of allowed addresses.
• In a browser go to http://newproject.dbarchowsky.com/app_dev.php.
• A welcome page should load. If it does, the site is ready for development.
• See also, removing sample scripts from the distribution.

Confirming the version

$ php app/console --version

Dev environment

Simply visiting the site will load the production environment (web/app.php).

To load the development environment, load the site using `http://[siteurl.com]/app_dev.php[/path/to/page/]`.

Upgrading

Starting with Symfony 2.3, from the project root:

$ composer update

This will update Symfony to the latest point release. To update to the latest version if it's a different minor version, first update the require.symfony/symfony version in composer.json in the project's root directory. Then run composer update.

N.B. composer itself can be updated if necessary with composer self-update.

See also

External links

• Kev Web Dev: Installing PHP 5.4 on Windows 7 for Developing With Symfony2