升级一个主要版本(例如4.4.0 5.0.0)

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 5.2,不再维护。

这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。

升级一个主要版本(例如4.4.0 5.0.0)

每两年,Symfony释放一个新的ob娱乐下载主要版本发布(第一个数字的变化)。这些版本的升级是最棘手的,因为他们可以打破向后兼容性。然而,Symfonob娱乐下载y使得这个升级过程尽可能的平滑。

这意味着您可以更新你的代码实际上主要发布前发布。这就是所谓的让你的代码未来的兼容

主要有几个步骤升级版:

  1. 使代码弃用免费的;
  2. 更新到新的主要版本通过作曲家;
  3. 更新你的代码来使用新版本

1)使您的代码弃用免费的

生命周期中一个主要的版本,添加新功能和方法签名和公共API用法发生了变化。然而,小版本不应该包含任何向后不兼容的更改。为此,“老”(如函数、类等)代码仍然适用,但被标记为弃用,这表明它将被删除/改变未来,你应该停止使用它。

主要版本发布时(例如5.0.0),所有的弃用的特性和功能都被删除了。所以,只要你更新你的代码停止使用这些弃用功能主要(如之前在过去的版本。4.4 . *),你应该能够升级没有问题。这意味着你应该放在第一位升级到最后一个小版本(如4.4),这样您就可以看到所有的用法。

帮你找到的用法,通知触发当你最终使用过时的特性。当访问您的应用程序开发环境在您的浏览器中,这些通知web开发工具栏所示:

最后,你应该停止使用弃用功能。有时,警告可能会告诉你什么改变。

但其他时候,警告可能不清楚:某个设置可能会导致一个类更深的触发警报。在这种情况下,Symfonyob娱乐下载它最好给一个明确的信息,但是你可能需要进一步研究警告。

有时,警告可能来自第三方库或者你使用包。如果这是真的,很有可能那些用法已经更新。在这种情况下,升级库来修复它们。

一旦所有的弃用警告,您可以升级和更多的信心。

与此同时在PHPUnit)

当您运行测试时使用PHPUnit),没有弃用通知所示。帮助你在这里,Symfony提供了Pob娱乐下载HPUnit)桥。这座桥将向您展示一个很好的总结所有弃用通知的最后测试报告。

所有您需要做的就是安装PHPUnit)桥:

1
美元作曲家要求- dev symfony / phob娱乐下载punit-bridge

现在,您可以开始修复通知:

1 2 3 4 5 6 7 8 9 10 11 12 13 14
#这个命令可以在运行“作曲家要求- dev symfony / phpunit-bridge”ob娱乐下载美元/ bin / phpunit)…OK(10测试,20断言)剩余的通知(6)“请求”服务是弃用,将被删除3.0。添加一个类型提示ob娱乐下载Symfony \ HttpFoundation \ \组件请求来检索请求,控制器参数:6 x 3 xPageAdminTest::从Symfony testPageSob娱乐下载how \ Cmf \ WebTest \ \ SimpleCmsBundle \测试管理2 xPageAdminTest::从Symfony testPageLob娱乐下载ist \ Cmf \ WebTest \ \ SimpleCmsBundle \测试管理1 xPageAdminTest::从Symfony testPageEob娱乐下载dit \ Cmf \ SimpleCmsBundle \ \ WebTest \管理测试

一旦固定,命令结尾0(成功)和你做!

有时候,你不能解决所有的用法(如4.4中被弃用的东西,你仍然需要支持4.3)。在这些情况下,您仍然可以使用桥修复尽可能多的用法,然后让更多的人让你再次测试通过。为此,您可以使用ob娱乐下载SYMFONY_DEPRECATIONS_HELPERenv变量:

1 2 3 4 5 6 7 8
< !——phpunit.xml。区域- - ><phpunit)>< !——……- - ><php><env的名字=“ob娱乐下载SYMFONY_DEPRECATIONS_HELPER”价值=“马克斯(总)= 999999”/ >< /php>< /phpunit)>

您还可以执行命令:

1
美元ob娱乐下载php SYMFONY_DEPRECATIONS_HELPER = max(总)= 999999 / bin / phpunit)

2)更新到新的主要版本通过作曲家

一旦你的代码是弃用免费的,你可以更新Symfony通过作曲家通过修改你的图书馆ob娱乐下载composer.json文件并开始改变的所有库ob娱乐下载symfony /新的主要版本:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
{“……”:“……”,"需要":{4.4ob娱乐下载——“symfony /缓存”:“。*”,5.0ob娱乐下载 +“symfony /缓存”:“。*”,4.4ob娱乐下载——“symfony / config”:“。*”,5.0ob娱乐下载 +“symfony / config”:“。*”,4.4ob娱乐下载——“symfony /控制台”:“。*”,5.0ob娱乐下载 +“symfony /控制台”:“。*”,“…”:“……”,“……”:“几个库从symfony /遵循自己的版本控制方案。ob娱乐下载您不需要更新这些版本:你可以随时升级他们独立”、“symfony / monolog-bundle”:“^ 3.5“}”,…ob娱乐下载”:“……”,}

在你的底部composer.json的文件,额外的你可以找到一个数据块的Symfony的版本。ob娱乐下载也一定要升级。例如,更新它5.0 . *升级到Symfony 5.0ob娱乐下载:

1 2 3 4 5 6 7
“额外”:{" symfob娱乐下载ony ": {“allow-contrib”:假的,——“需要”:“4.4 . *”5.0 +“要求”:“。*”}}

接下来,使用作曲家下载新版本的库:

1
美元作曲家更新“ob娱乐下载symfony / *”

依赖错误

如果你得到一个依赖错误,它可能意味着你还需要升级Symfony的其他库依赖库。ob娱乐下载允许通过——with-all-dependencies国旗:

1
美元作曲家更新“ob娱乐下载symfony / *”——with-all-dependencies

这个更新ob娱乐下载symfony / *所有依赖包,这些包。通过严格的版本约束composer.json,你可以控制每个库升级版本。

如果这还不起作用,你composer.json文件可以指定一个版本库,与新的Symfony版本不兼容。ob娱乐下载在这种情况下,图书馆一个新版本的更新composer.json可能会解决这个问题。

或者,你可能有更深层次的问题,不同的其他库的库依赖于冲突的版本。调试检查你的错误消息。

另一个可能发生的问题是项目依赖项可以安装在您的本地计算机上而不是在远程服务器上。这通常发生在当PHP版本在每台机器上都是不同的。解决方案是增加的平台配置选项的作曲家。json的文件定义的最高允许PHP版本的依赖关系(设置为服务器的PHP版本)。

升级其他包

你也可以升级你的库。如果你已经做了很好的工作版本约束composer.json你可以安全地通过运行:

1
美元作曲家更新

谨慎

当心,如果你有一些不具体的版本约束在你的composer.json(如。dev-master),这可能一些non-Symfony库升级到新版本包含打破向后ob娱乐下载兼容性的变化。

3)更新菜谱

随着时间的推移,特别是当你升级到一个新版本的库的更新版本配方可能是可用的。这些更新是非常小的,如新评论在配置文件中,但这是一个好主意保持你的文件同步的菜谱。

ob娱乐下载Symfony Flex提供一些命令来帮助升级你的食谱。一定要你在工作开始前提交任何无关的修改:

1.6

菜谱的命令在Symfony Flex 1.6中引入的。ob娱乐下载

1 2 3 4 5 6 7 8
#看到所有已安装的食谱的列表和更新可用美元作曲家的食谱#看到详细信息特定的食谱美元symfony / framewoob娱乐下载rk-bundle作曲家食谱#更新特定的食谱美元作曲家食谱:安装symfony - v / fraob娱乐下载mework-bundle——力量

棘手的这个过程的一部分是食谱“更新”不执行任何代码的智能“升级”。相反,更新过程重新安装最新版本的配方这意味着您的自定义代码将被完全覆盖。更新配方之后,您需要仔细选择改变你想要的,并取消休息。

截屏视频

对于一个详细的示例,请参阅ob娱乐下载SymfonyCasts Symfony 5升级教程

4)使用新版本更新你的代码

在一些罕见的情况下,下一个主要版本可能包含打破向后兼容性。确保你读了UPGRADE-X.0.md(其中X是新的主要版本)包含在公元前的Symfony库打破,你需要注意的。ob娱乐下载

这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。