php - PHPunit 配置文件 phpunit.xml.dist 或 phpunit.xml 的命名有什么不同吗

Question

谁能给我解释一下使用名为 phpunit.xml.dist 或 phpunit.xml 的 PHPunit 配置文件有什么区别。

official documentation提到两个名字:

PHPUnit's XML configuration file (Appendix C) can also be used to compose a test suite. Example 5.1 shows a minimal phpunit.xml file that will add all *Test classes that are found in *Test.php files when the tests directory is recursively traversed.

在加载没有configuration 参数的配置时给予phpunit.xml 更高的优先级。

If phpunit.xml or phpunit.xml.dist (in that order) exist in the current working directory and --configuration is not used, the configuration will be automatically read from that file.

我确实发现了一些与以下事实相关的问题(例如 is this .xml.dist file really required to be used )，即 .dist 文件通常用作模板(分发版)，应将其复制到没有 .dist 结束以激活它们(例如 .htaccess.dist)。但这似乎不是 PHPunit 的情况，因为它也会获取并运行 dist 文件。其他问题 ( Can I use phpunit.xml for credentials and phpunit.xml.dist for testsuites?) 似乎涉及关于这两个文件的其他奇怪的使用想法。

在 Symfony 世界中，它是强制性的 for reusable bundles包含一个 phpunit.xml.dist 文件，我想知道为什么不用 phpunit.xml 文件。

A test suite must not contain AllTests.php scripts, but must rely on the existence of a phpunit.xml.dist file.

因此，如果有人能阐明这一点，我会很高兴；-)

Answer 1

如果 phpunit.xml 或 phpunit.xml.dist(按此顺序)存在于当前工作目录中并且 --configuration 是未使用，配置将自动从该文件中读取。

当 phpunit.xml 不存在时回退到 phpunit.xml.dist 的想法是 phpunit.xml.dist 可以 checkin 版本控制，phpunit.xml 可以从版本控制中忽略。这允许开发人员使用自定义配置，而不会冒意外将其 checkin 版本控制的风险。