Symfony Standard Edition Upgrade ================================ From Symfony 2.0 to Symfony 2.1 ------------------------------- ### Project Dependencies As of Symfony 2.1, project dependencies are managed by [Composer](http://getcomposer.org/): * The `bin/vendors` script can be removed as `composer.phar` does all the work now (it is recommended to install it globally on your machine). * The `deps` file need to be replaced with the `composer.json` one. * The `composer.lock` is the equivalent of the generated `deps.lock` file and it is automatically generated by Composer. Download the default [`composer.json`](https://raw.github.com/symfony/symfony-standard/master/composer.json) and [`composer.lock`](https://raw.github.com/symfony/symfony-standard/master/composer.lock) files for Symfony 2.1 and put them into the main directory of your project. If you have customized your `deps` file, move the added dependencies to the `composer.json` file (many bundles and PHP libraries are already available as Composer packages -- search for them on [Packagist](http://packagist.org/)). Remove your current `vendor` directory. Finally, run Composer: $ composer.phar install ### `app/autoload.php` The default `autoload.php` reads as follows (it has been simplified a lot as autoloading for libraries and bundles declared in your `composer.json` file is automatically managed by the Composer autoloader): add('', __DIR__.'/../vendor/symfony/symfony/src/Symfony/Component/Locale/Resources/stubs'); } AnnotationRegistry::registerLoader(array($loader, 'loadClass')); return $loader; ### `app/config/config.yml` The `framework.charset` setting must be removed. If you are not using `UTF-8` for your application, override the `getCharset()` method in your `AppKernel` class instead: class AppKernel extends Kernel { public function getCharset() { return 'ISO-8859-1'; } // ... } You might want to add the new `strict_requirements` parameter to `framework.router` (it avoids fatal errors in the production environment when a link cannot be generated): framework: router: strict_requirements: %kernel.debug% You can even disable the requirements check on production with `null` as you should know that the parameters for URL generation always pass the requirements, e.g. by validating them beforehand. This additionally enhances performance. See [config_prod.yml](https://github.com/symfony/symfony-standard/blob/master/app/config/config_prod.yml). The `default_locale` parameter is now a setting of the main `framework` configuration (it was under the `framework.session` in 2.0): framework: default_locale: %locale% The `auto_start` setting under `framework.session` must be removed as it is not used anymore (the session is now always started on-demand). If `auto_start` was the only setting under the `framework.session` entry, don't remove it entirely, but set its value to `~` (`~` means `null` in YAML) instead: framework: session: ~ The `trust_proxy_headers` setting was added in the default configuration file (as it should be set to `true` when you install your application behind a reverse proxy): framework: trust_proxy_headers: false An empty `bundles` entry was added to the `assetic` configuration: assetic: bundles: [] The default `swiftmailer` configuration now has the `spool` setting configured to the `memory` type to defer email sending after the response is sent to the user (recommended for better end-user performance): swiftmailer: spool: { type: memory } The `jms_security_extra` configuration was moved to the `security.yml` configuration file. ### `app/config/config_dev.yml` An example of how to send all emails to a unique address was added: #swiftmailer: # delivery_address: me@example.com ### `app/config/config_test.yml` The `storage_id` setting must be changed to `session.storage.mock_file`: framework: session: storage_id: session.storage.mock_file ### `app/config/parameters.ini` The file has been converted to a YAML file which reads as follows: parameters: database_driver: pdo_mysql database_host: localhost database_port: ~ database_name: symfony database_user: root database_password: ~ mailer_transport: smtp mailer_host: localhost mailer_user: ~ mailer_password: ~ locale: en secret: ThisTokenIsNotSoSecretChangeIt Note that if you convert your parameters file to YAML, you must also change its reference in `app/config/config.yml`. ### `app/config/routing_dev.yml` The `_assetic` entry was removed: #_assetic: # resource: . # type: assetic ### `app/config/security.yml` Under `security.access_control`, the default rule for internal routes was changed: security: access_control: #- { path: ^/_internal/secure, roles: IS_AUTHENTICATED_ANONYMOUSLY, ip: 127.0.0.1 } Under `security.providers`, the `in_memory` example was updated to the following: security: providers: in_memory: memory: users: user: { password: userpass, roles: [ 'ROLE_USER' ] } admin: { password: adminpass, roles: [ 'ROLE_ADMIN' ] } ### `app/AppKernel.php` The following bundles have been added to the list of default registered bundles: `new JMS\AopBundle\JMSAopBundle(), `new JMS\DiExtraBundle\JMSDiExtraBundle($this), ### `web/app.php` The default `web/app.php` file now reads as follows: register(true); */ require_once __DIR__.'/../app/AppKernel.php'; //require_once __DIR__.'/../app/AppCache.php'; $kernel = new AppKernel('prod', false); $kernel->loadClassCache(); //$kernel = new AppCache($kernel); $request = Request::createFromGlobals(); $response = $kernel->handle($request); $response->send(); $kernel->terminate($request, $response); ### `web/app_dev.php` The default `web/app_dev.php` file now reads as follows: loadClassCache(); $request = Request::createFromGlobals(); $response = $kernel->handle($request); $response->send(); $kernel->terminate($request, $response);