升级一个主要版本(例如3.4.0 4.1.0)

编辑该页面

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

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

升级一个主要版本(例如3.4.0 4.1.0)

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

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

主要有几个步骤升级版:

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

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

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

主要版本发布时(例如4.1.0),所有的弃用的特性和功能都被删除了。所以,只要你更新你的代码停止使用这些弃用功能在之前的最后一个版本主要(例如3.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。添加一个typehintob娱乐下载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(成功)和你做!

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

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

(您还可以执行命令ob娱乐下载SYMFONY_DEPRECATIONS_HELPER =弱phpunit))。

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

一旦你的代码是弃用免费的,你可以更新Symfony通过作曲家通过修改你的图书馆ob娱乐下载composer.json文件:

1 2 3 4 5 6 7 8
{“…”:“…”,“需要”:{“ob娱乐下载symfony / symfony”:“^ 4.1”},“…”:“…”}

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

1
美元作曲家更新symfony / sob娱乐下载ymfony

依赖错误

如果你得到一个依赖错误,它可能仅仅意味着你需要升级其他Symfony的依赖关系。ob娱乐下载在这种情况下,试试下面的命令:

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

这个更新ob娱乐下载symfony / symfony所有这取决于包,包括其他几个包。通过严格的版本约束composer.json,你可以控制每个库升级版本。

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

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

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

升级其他包

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

1
美元作曲家更新

谨慎

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

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

下一个主要版本可能还包含新的BC减免BC层并不总是可能的。确保你读了UPGRADE-X.0.md(其中X是新的主要版本)包含在公元前的Symfony库打破,你需要注意的。ob娱乐下载

4)更新的Symfony 4 Flexob娱乐下载目录结构

当升级到Symfony 4,你可能还ob娱乐下载想升级到新的Symfony 4目录结构,这样您就可以利用Symfony Flex。这需要一些工作,但是是可选的。有关详细信息,请参见使用Symfob娱乐下载ony的Flex管理Symfony应用程序

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