如何使用过程代码库在PHP中编写单元测试？

Question

我基本上相信单元测试的好处，我想开始将这个概念应用于用PHP编写的大型现有代码库。 不到10％的代码是面向对象的。

我看了几个单元测试框架（PHPUnit，SimpleTest和phpt）。 但是，我没有找到测试过程代码的任何示例。 什么是我的情况最好的框架，有没有使用非OOP代码单元测试PHP的例子？

Answer 1

你可以对程序PHP进行单元测试，没问题。 如果您的代码与HTML混合在一起，那么您绝对不会运气不好。

在应用程序或验收测试级别，您的过程PHP可能依赖于超级全局（ $_POST, $_GET, $_COOKIE等）的值来确定行为，并以包含模板文件和吐出输出结束。

要进行应用程序级测试，您只需设置超全局值; 启动一个输出缓冲区（以防止一堆html充斥你的屏幕）; 打电话给页面; 断言缓冲区内的东西; 并在最后废弃缓冲区。 所以，你可以这样做：

public function setUp()
{
    if (isset($_POST['foo'])) {
        unset($_POST['foo']);
    }
}

public function testSomeKindOfAcceptanceTest()
{
    $_POST['foo'] = 'bar';
    ob_start();
    include('fileToTest.php');
    $output = ob_get_flush();
    $this->assertContains($someExpectedString, $output);
}

即使对于包含大量包含的巨大“框架”，这种测试也会告诉您是否有应用程序级功能正常工作。 当您开始改进代码时，这将非常重要，因为即使您确信数据库连接器仍然可以工作并且看起来比以前更好，您也可以单击一个按钮看看，是的，您仍然可以通过数据库登录和注销。

在较低级别，根据变量范围以及函数是否通过副作用（返回true或false）起作用或直接返回结果，存在微小的变化。

变量是否明确地传递，作为函数之间的参数或参数数组？ 或者是在许多不同的地方设置变量，并作为全局变量隐式传递？ 如果它是（好的）显式情况，你可以通过（1）包括保存函数的文件，然后（2）直接输入函数测试值，以及（3）捕获输出并对其断言来单元测试函数。 如果你正在使用全局变量，你只需要格外小心（如上所述，在$ _POST示例中），小心地将测试之间的所有全局变量归零。 在处理推动和拉动大量全局变量的函数时，保持测试非常小（5-10行，1-2断言）也特别有用。

另一个基本问题是函数是通过返回输出还是通过改变传入的参数来工作，而是返回true / false。 在第一种情况下，测试更容易，但同样，在两种情况下都可以：

// assuming you required the file of interest at the top of the test file
public function testShouldConcatenateTwoStringsAndReturnResult()
{
  $stringOne = 'foo';
  $stringTwo = 'bar';
  $expectedOutput = 'foobar';
  $output = myCustomCatFunction($stringOne, $stringTwo);
  $this->assertEquals($expectedOutput, $output);
}

在坏的情况下，你的代码通过副作用工作并返回true或false，你仍然可以很容易地测试：

/* suppose your cat function stupidly 
 * overwrites the first parameter
 * with the result of concatenation, 
 * as an admittedly contrived example 
 */
public function testShouldConcatenateTwoStringsAndReturnTrue()
    {
      $stringOne = 'foo';
      $stringTwo = 'bar';
      $expectedOutput = 'foobar';
      $output = myCustomCatFunction($stringOne, $stringTwo);
      $this->assertTrue($output);
      $this->Equals($expectedOutput, $stringOne);
    }

希望这可以帮助。

Answer 2

什么单元测试做得很好，以及你应该使用它们的是，当你有一段代码，你提供了一些输入，并且你希望得到一些输出。 我们的想法是，当您稍后添加功能时，您可以运行测试并确保它仍然以相同的方式执行旧功能。

因此，如果您有一个过程代码库，则可以在测试方法中完成此函数调用

require 'my-libraries.php';
class SomeTest extends SomeBaseTestFromSomeFramework {
    public function testSetup() {
        $this->assertTrue(true);
    }

    public function testMyFunction() {
        $output = my_function('foo',3);

        $this->assertEquals('expected output',$output);
    }
}

PHP代码库的这个技巧通常是您的库代码会干扰测试框架的运行，因为您的代码库和测试框架将有大量与在Web浏览器中设置应用程序环境相关的代码（会话，共享）全局变量等）。 期待花一些时间到达可以包含库代码并运行简单测试（上面的testSetup函数）的点。

如果你的代码没有函数，并且只是一系列输出HTML页面的PHP文件，那你就有点不走运了。 您的代码不能分成不同的单元，这意味着单元测试对您没有多大用处。 使用Selenium和Watir等产品，您最好花时间在“验收测试”级别。 这些将允许您自动化浏览器，然后检查页面中的内容作为特定位置/表单。

Answer 3

您可以尝试将非oop代码包含到测试类中

require_once 'your_non_oop_file.php' # Contains fct_to_test()

使用phpUnit，您可以定义测试功能：

testfct_to_test() {
   assertEquals( result_expected, fct_to_test(), 'Fail with fct_to_test' );
}