diff --git a/UPGRADE-2.2.md b/UPGRADE-2.2.md deleted file mode 100644 index cad9eeb..0000000 --- a/UPGRADE-2.2.md +++ /dev/null @@ -1,30 +0,0 @@ -UPGRADE FROM 2.1 to 2.2 -======================= - - * The [`web/.htaccess`](https://github.com/symfony/symfony-standard/blob/2.2/web/.htaccess) - file has been enhanced substantially to prevent duplicate content with and - without `/app.php` in the URI. It also improves functionality when using - Apache aliases or when mod_rewrite is not available. So you might want to - update your `.htaccess` file as well. - - * The ``_internal`` route is not used any more. It should then be removed - from both your routing and security configurations. A ``fragments`` key has - been added to the framework configuration and must be specified when ESI or - Hinclude are in use. No security configuration is required for this path as - by default ESI access is only permitted for trusted hosts and Hinclude - access uses an URL signing mechanism. - - ``` - framework: - # ... - fragments: { path: /_proxy } - ``` - -Functional Tests ----------------- - - * The profiler has been disabled by default in the test environment. You can - enable it again by modifying the ``config_test.yml`` configuration file or - even better, you can just enable it for the very next request by calling - ``$client->enableProfiler()`` when you need the profiler in a test (that - speeds up functional tests quite a bit). diff --git a/UPGRADE-2.3.md b/UPGRADE-2.3.md deleted file mode 100644 index eb4b3ec..0000000 --- a/UPGRADE-2.3.md +++ /dev/null @@ -1,52 +0,0 @@ -UPGRADE FROM 2.2 to 2.3 -======================= - -When upgrading Symfony from 2.2 to 2.3, you need to do the following changes -to the code that came from the Standard Edition: - - * The debugging tools are not enabled by default anymore and should be added - to the - [`web/app_dev.php`](https://github.com/symfony/symfony-standard/blob/2.3/web/app_dev.php) - front controller manually, just after including the bootstrap cache: - - use Symfony\Component\Debug\Debug; - - Debug::enable(); - - You also need to enable debugging in the - [`app/console`](https://github.com/symfony/symfony-standard/blob/2.3/app/console) - script, after the `$debug` variable is defined: - - use Symfony\Component\Debug\Debug; - - if ($debug) { - Debug::enable(); - } - - * The `parameters.yml` file can now be managed by the - `incenteev/composer-parameter-handler` bundle that comes with the 2.3 - Standard Edition: - - * add `"incenteev/composer-parameter-handler": "~2.0"` to your - `composer.json` file; - - * add `/app/config/parameters.yml` to your `.gitignore` file; - - * create a - [`app/config/parameters.yml.dist`](https://github.com/symfony/symfony-standard/blob/2.3/app/config/parameters.yml.dist) - file with sensible values for all your parameters. - - * It is highly recommended that you switch the minimum stability to `stable` - in your `composer.json` file. - - * If you are using Apache, have a look at the new - [`.htaccess`](https://github.com/symfony/symfony-standard/blob/2.3/web/.htaccess) - configuration and change yours accordingly. - - * In the - [`app/autoload.php`](https://github.com/symfony/symfony-standard/blob/2.3/app/autoload.php) - file, the section about `intl` should be removed as it is not needed anymore. - -You can also have a look at the -[diff](https://github.com/symfony/symfony-standard/compare/v2.2.0%E2%80%A62.3) -between the 2.2 version of the Standard Edition and the 2.3 version. diff --git a/UPGRADE-2.4.md b/UPGRADE-2.4.md deleted file mode 100644 index a3e3395..0000000 --- a/UPGRADE-2.4.md +++ /dev/null @@ -1,9 +0,0 @@ -UPGRADE FROM 2.3 to 2.4 -======================= - -When upgrading Symfony from 2.3 to 2.4, you need to do the following changes -to the code that came from the Standard Edition: - - * We recommend to comment or remove the `firephp` and `chromephp` Monolog - handlers as they might cause issues with some configuration (`chromephp` - with Nginx for instance). diff --git a/UPGRADE.md b/UPGRADE.md deleted file mode 100644 index a206d37..0000000 --- a/UPGRADE.md +++ /dev/null @@ -1,268 +0,0 @@ -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/2.1/composer.json) -and -[`composer.lock`](https://raw.github.com/symfony/symfony-standard/2.1/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 - -Note: You must complete the upgrade steps below so composer can successfully generate the autoload files. - -### `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), - -You must also rename the DoctrineBundle from: - - new Symfony\Bundle\DoctrineBundle\DoctrineBundle(), - -to: - - new Doctrine\Bundle\DoctrineBundle\DoctrineBundle(), - -### `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);