PHP test reporting

Upload your test results using the results method.

$res = results($data);
// $res is an Associative Array.
// Value for key 'success' is a Boolean.
// True if results successfully uploaded, false otherwise.
echo $res["success"] ? 'true' : 'false';
echo "\n";
// Value for key "message" is a String.
// If success is false, check message to see why upload failed.
echo $res["message"];
echo "\n";

The $data param for results is an Associative Array containing your test results in the form:

<?php
  require 'tesults.php';
    $data = array(
      'target' => 'token',
      'results' => array(
        "cases" => array(
          array(
            "name" => "Test 1",
            "desc" => "Test 1 description",
            "suite" => "Suite A",
            "result" => "pass"
          ),
          array(
            "name" => "Test 2",
            "desc" => "Test 2 description",
            "suite" => "Suite B",
            "result" => "fail",
            "reason" => "Assert fail in line 203 of example.php"
            "_CustomField" => "Custom field value",
            "params" => array(
              "param1" => "value1",
              "param2" => "value2"
            ),
            "steps" => array(
              array(
                "name" => "Step 1",
                "desc" => "Step 1 description",
                "result" => "pass"
              ),
              array(
                "name" => "Step 2",
                "desc" => "Step 2 description",
                "result" => "fail"
                "reason" => "Assert fail in line 203 of example.php"
              )
            )
          ),
          array(
            "name" => "Test 3",
            "desc" => "Test 3 description",
            "suite" => "Suite A",
            "start" => round(microtime(true) * 1000) - 60000,
            "end" => round(microtime(true) * 1000),
            "result" => "pass"
          )
        )
      )
    );

    $res = results($data);
    echo $res["success"] ? 'true' : 'false';
    echo "\n";
    echo $res["message"];
    echo "\n";
?>

The target value, 'token' above should be replaced with your Tesults target token. If you have lost your token you can regenerate one from the config menu. The cases Array should contain your test cases. You would usually add these by looping through the test case objects you currently have in your build and test scripts.

Each test case added to cases must have a name and a result. The result value must be one of 'pass', 'fail' or 'unknown'. All other fields are optional: desc, suite, params, steps, reason and custom fields (prefixed with underscore).

The 'params' value is for use by parameterized test cases and is an Associative Array containing the parameter names and values.