Symfony LTS：如何从 2.8 升级到 3.4？

Posted 2023-02-16

【中文标题】Symfony LTS：如何从 2.8 升级到 3.4？

【英文标题】：Symfony LTS: how to upgrade from 2.8 to 3.4?

【发布时间】：2019-02-21 20:33:22

【问题描述】：

Symfony 2.8 是 2.x 分支和上一个 LTS 的最后一个版本。

Symfony 3.4 是 3.x 分支和当前 LTS 的最后一个版本。

要将 Symfony 从 2.8 升级到 3.4 并切换到最后一个 LTS，需要哪些步骤？

【参考方案1】：

准备升级

检查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 文件来更新依赖项：

（[…]表示代码不变）

旧 (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 获得差异。

奖励：enable autowiring of services.

【讨论】：

所以现在发布一个问题然后立即以这种详细程度回答它是一回事吗？而且您完全忽略了第三方依赖项。这通常是真正的挑战。

@Cerad 我的previous guide 被广泛接受，answering your own question 没有任何问题。我在更新我的一个项目（几乎没有依赖项）时写了这个答案，它对我有用，所以我认为它可能会帮助其他一些用户。我同意升级第三方依赖项是最困难的部分，但我无法解释每个捆绑包的具体步骤。

@Cerad 我添加了关于依赖项的注释，感谢您的输入！

【参考方案2】：

2019+ 即时升级版

今天，您可以使用名为 Rector（我是作者）的即时升级工具自动完成大部分工作。它已经为许多框架准备了集合，其中 Symfony 是最完整的。还包括您可能需要的 PHP 升级。

您可以阅读更多关于此特定升级路径的信息：How to Upgrade Symfony 2.8 to 3.4

【讨论】：

- 校长/校长 ^0.6.14 的安装请求-> 校长/校长 [v0.6.14] 可满足。 -rector/rector v0.6.14 需要 symfony/process ^4.4|^5.0 -> 可以满足 symfony/process[v4.4.0, v4.4.1, v4.4.2, v4.4.3, v5.0.0, v5.0.1, v5。 0.2，v5.0.3]。 - symfony/symfony 的安装请求（锁定在 v2.8.52，要求为 2.8.*）-> 可由 symfony/symfony[v2.8.52] 满足。

getrector.org/blog/2020/01/20/…