Symfony LTS：如何从 2.8 升级到 3.4？
Symfony LTS: how to upgrade from 2.8 to 3.4?
Symfony 2.8 是 2.x 分支的最后一个版本和之前的 LTS。
Symfony 3.4 是 3.x 分支和当前 LTS 的最后一个版本。
将 Symfony 从 2.8 升级到 3.4 并切换到最后一个 LTS 需要哪些步骤？
准备升级
检查composer.json中列出的所有依赖项和包是否发布了与Symfony 3.4兼容的版本，您可以通过在Packagist上搜索每个包来做到这一点，例如EasyAdmin与Symfony兼容3 因为 requires 中的依赖项不限于 Symfony 2（我们会看到类似 symfony/*: ~2.3 的内容）。如果其中一个依赖项与 Symfony 3 不兼容，您将不得不寻找替换包或修补这些库。
composer.json
为了将您的应用程序从 Symfony 2.8 升级到 Symfony 3.4，您必须通过更改 composer.json[=98= 来更新您的依赖项] 文件：
([…]表示代码不变)
旧 (2.8) 版本：
{
[…]
"autoload-dev": {
"files": [ "vendor/symfony/symfony/src/Symfony/Component/VarDumper/Resources/functions/dump.php" ]
},
"require": {
"php": ">=5.3.9",
"doctrine/doctrine-bundle": "~1.4",
"doctrine/orm": "^2.4.8",
"incenteev/composer-parameter-handler": "~2.0",
"sensio/distribution-bundle": "~4.0",
"sensio/framework-extra-bundle": "^3.0.2",
"symfony/monolog-bundle": "^3.0.2",
"symfony/swiftmailer-bundle": "~2.3,>=2.3.10",
"symfony/symfony": "2.8.*",
"twig/twig": "^1.0||^2.0"
},
"require-dev": {
"sensio/generator-bundle": "~3.0",
"symfony/phpunit-bridge": "~2.7"
},
"config": {
"bin-dir": "bin",
"platform": {
"php": "5.6"
},
"sort-packages": true
},
"extra": {
"symfony-app-dir": "app",
"symfony-web-dir": "web",
"symfony-assets-install": "relative",
[…]
"branch-alias": {
"dev-master": "2.8-dev"
}
}
}
新（3.4）版本：
{
[…]
"autoload-dev": {
"psr-4": { "Tests\": "tests/" },
"files": [ "vendor/symfony/symfony/src/Symfony/Component/VarDumper/Resources/functions/dump.php" ]
},
"require": {
"php": ">=5.5.9",
"doctrine/doctrine-bundle": "^1.6",
"doctrine/orm": "^2.5",
"incenteev/composer-parameter-handler": "^2.0",
"sensio/distribution-bundle": "^5.0.19",
"sensio/framework-extra-bundle": "^5.0.0",
"symfony/monolog-bundle": "^3.1.0",
"symfony/polyfill-apcu": "^1.0",
"symfony/swiftmailer-bundle": "^2.6.4",
"symfony/symfony": "3.4.*",
"twig/twig": "^1.0||^2.0"
},
"require-dev": {
"sensio/generator-bundle": "^3.0",
"symfony/phpunit-bridge": "^3.0"
},
"config": {
"platform": {
"php": "5.6"
},
"sort-packages": true
},
"extra": {
"symfony-app-dir": "app",
"symfony-bin-dir": "bin",
"symfony-var-dir": "var",
"symfony-web-dir": "web",
"symfony-tests-dir": "tests",
"symfony-assets-install": "relative",
[…]
"branch-alias": {
"dev-master": "3.4-dev"
}
}
}
总结
autoload-dev.psr-4 已添加（必须使用测试目录的路径进行更改）- Symfony 和依赖项已更新
symfony/polyfill-apcu是一个新的依赖extra 已更新以使用新的目录结构：var 用于临时文件等 config.bin-dir 已删除
有关升级的更多详细信息：→ 3.0, → 3.1, → 3.2, → 3.3, → 3.4
app/AppKernel.php
添加 getRootDir 并更新 registerContainerConfiguration 功能：
public function getRootDir()
{
return __DIR__;
}
public function registerContainerConfiguration(LoaderInterface $loader)
{
$loader->load($this->getRootDir().'/config/config_'.$this->getEnvironment().'.yml');
}
缓存和日志
如果您想将 cache 和 logs 放入 var/，您必须通过添加以下行来更新 app/AppKernel.php 文件：
public function getCacheDir()
{
return dirname(__DIR__).'/var/cache/'.$this->getEnvironment();
}
public function getLogDir()
{
return dirname(__DIR__).'/var/logs';
}
然后创建var/目录，放一个空文件.gitkeep
并将这些更改应用于您的 .gitignore 文件：
/var/cache/*
/var/logs/*
!var/cache/.gitkeep
!var/logs/.gitkeep
另请参阅：What is the new Symfony 3 directory structure?
最后的步骤
更新 composer.json 文件后，您必须更新依赖项：
composer update
那么您可能需要刷新缓存：
php app/console cache:clear --env=dev
注意：我使用了以下命令来获取 composer.json 文件：
# create Symfony "2.8.*" project in the "2.8" directory
composer create-project symfony/framework-standard-edition "2.8" "2.8.*" --no-interaction -v
# create Symfony "3.4.*" project in the "3.4" directory
composer create-project symfony/framework-standard-edition "3.4" "3.4.*" --no-interaction -v
# compare the Symfony 2.8 and 3.4 composer.json files
diff -u 2.8/composer.json 3.4/composer.json
差异也可在 GitHub 获得。
奖金：.
2019+即时升级版
如今，您可以使用名为 Rector（我是其作者）的即时升级工具来自动化大部分工作。它为许多框架准备了集合，Symfony 的最完整。还包括您可能需要的 PHP 升级。
您可以在以下位置阅读有关此特定升级路径的更多信息：How to Upgrade Symfony 2.8 to 3.4
Symfony 2.8 是 2.x 分支的最后一个版本和之前的 LTS。
Symfony 3.4 是 3.x 分支和当前 LTS 的最后一个版本。
将 Symfony 从 2.8 升级到 3.4 并切换到最后一个 LTS 需要哪些步骤？
准备升级
检查composer.json中列出的所有依赖项和包是否发布了与Symfony 3.4兼容的版本，您可以通过在Packagist上搜索每个包来做到这一点，例如EasyAdmin与Symfony兼容3 因为 requires 中的依赖项不限于 Symfony 2（我们会看到类似 symfony/*: ~2.3 的内容）。如果其中一个依赖项与 Symfony 3 不兼容，您将不得不寻找替换包或修补这些库。
composer.json
为了将您的应用程序从 Symfony 2.8 升级到 Symfony 3.4，您必须通过更改 composer.json[=98= 来更新您的依赖项] 文件：
([…]表示代码不变)
旧 (2.8) 版本：
{
[…]
"autoload-dev": {
"files": [ "vendor/symfony/symfony/src/Symfony/Component/VarDumper/Resources/functions/dump.php" ]
},
"require": {
"php": ">=5.3.9",
"doctrine/doctrine-bundle": "~1.4",
"doctrine/orm": "^2.4.8",
"incenteev/composer-parameter-handler": "~2.0",
"sensio/distribution-bundle": "~4.0",
"sensio/framework-extra-bundle": "^3.0.2",
"symfony/monolog-bundle": "^3.0.2",
"symfony/swiftmailer-bundle": "~2.3,>=2.3.10",
"symfony/symfony": "2.8.*",
"twig/twig": "^1.0||^2.0"
},
"require-dev": {
"sensio/generator-bundle": "~3.0",
"symfony/phpunit-bridge": "~2.7"
},
"config": {
"bin-dir": "bin",
"platform": {
"php": "5.6"
},
"sort-packages": true
},
"extra": {
"symfony-app-dir": "app",
"symfony-web-dir": "web",
"symfony-assets-install": "relative",
[…]
"branch-alias": {
"dev-master": "2.8-dev"
}
}
}
新（3.4）版本：
{
[…]
"autoload-dev": {
"psr-4": { "Tests\": "tests/" },
"files": [ "vendor/symfony/symfony/src/Symfony/Component/VarDumper/Resources/functions/dump.php" ]
},
"require": {
"php": ">=5.5.9",
"doctrine/doctrine-bundle": "^1.6",
"doctrine/orm": "^2.5",
"incenteev/composer-parameter-handler": "^2.0",
"sensio/distribution-bundle": "^5.0.19",
"sensio/framework-extra-bundle": "^5.0.0",
"symfony/monolog-bundle": "^3.1.0",
"symfony/polyfill-apcu": "^1.0",
"symfony/swiftmailer-bundle": "^2.6.4",
"symfony/symfony": "3.4.*",
"twig/twig": "^1.0||^2.0"
},
"require-dev": {
"sensio/generator-bundle": "^3.0",
"symfony/phpunit-bridge": "^3.0"
},
"config": {
"platform": {
"php": "5.6"
},
"sort-packages": true
},
"extra": {
"symfony-app-dir": "app",
"symfony-bin-dir": "bin",
"symfony-var-dir": "var",
"symfony-web-dir": "web",
"symfony-tests-dir": "tests",
"symfony-assets-install": "relative",
[…]
"branch-alias": {
"dev-master": "3.4-dev"
}
}
}
总结
autoload-dev.psr-4已添加（必须使用测试目录的路径进行更改）- Symfony 和依赖项已更新
symfony/polyfill-apcu是一个新的依赖extra已更新以使用新的目录结构：var用于临时文件等config.bin-dir已删除
有关升级的更多详细信息：→ 3.0, → 3.1, → 3.2, → 3.3, → 3.4
app/AppKernel.php
添加 getRootDir 并更新 registerContainerConfiguration 功能：
public function getRootDir()
{
return __DIR__;
}
public function registerContainerConfiguration(LoaderInterface $loader)
{
$loader->load($this->getRootDir().'/config/config_'.$this->getEnvironment().'.yml');
}
缓存和日志
如果您想将 cache 和 logs 放入 var/，您必须通过添加以下行来更新 app/AppKernel.php 文件：
public function getCacheDir()
{
return dirname(__DIR__).'/var/cache/'.$this->getEnvironment();
}
public function getLogDir()
{
return dirname(__DIR__).'/var/logs';
}
然后创建var/目录，放一个空文件.gitkeep
并将这些更改应用于您的 .gitignore 文件：
/var/cache/*
/var/logs/*
!var/cache/.gitkeep
!var/logs/.gitkeep
另请参阅：What is the new Symfony 3 directory structure?
最后的步骤
更新 composer.json 文件后，您必须更新依赖项：
composer update
那么您可能需要刷新缓存：
php app/console cache:clear --env=dev
注意：我使用了以下命令来获取 composer.json 文件：
# create Symfony "2.8.*" project in the "2.8" directory
composer create-project symfony/framework-standard-edition "2.8" "2.8.*" --no-interaction -v
# create Symfony "3.4.*" project in the "3.4" directory
composer create-project symfony/framework-standard-edition "3.4" "3.4.*" --no-interaction -v
# compare the Symfony 2.8 and 3.4 composer.json files
diff -u 2.8/composer.json 3.4/composer.json
差异也可在 GitHub 获得。
奖金：
2019+即时升级版
如今，您可以使用名为 Rector（我是其作者）的即时升级工具来自动化大部分工作。它为许多框架准备了集合，Symfony 的最完整。还包括您可能需要的 PHP 升级。
您可以在以下位置阅读有关此特定升级路径的更多信息：How to Upgrade Symfony 2.8 to 3.4