# PHPUnit Json String Compare Function

### What is Purpose of the Json String Compare Method?

The Json compare method is used to expedite the development of unit tests. It removes the need to perform multiple assertions on a resultset to validate a single test. By simply comparing the received resultset to an expected resultset in 1 assertion, all values can be verified at once. It is designed to ignore date fields such as:

* created\_date
* updated\_date

This is due to SeedData files using the time() method which dynamically timestamps data at the time of seeding.

### How Does the Json Compare Method Work? <a href="#user-content-how-does-the-json-compare-method-work" id="user-content-how-does-the-json-compare-method-work"></a>

The Json Compare Method is included in the `JsonResponseHelper` trait. This trait is part of the `/tests` framework in the `elentra-1x-api` repo. It is not part of the production directories, and is only intended to work within the PHPUnit tests.

Changes have been made to the `phpunit.xml` file which now includes a bootstrap file to configure the current testing directory path. Other defined values can be added here if needed – ones that are only to be used within the PHPUnit test files.

The method is intended to be used in Integration tests. These are tests that check how well a method can integrate with an external resource (eg: a database or sftp directory).

When the method is called, the results from a call are passed into:

`assertJsonEqualsIgnoreDates(array $response) : void;`

This method will convert the passed in array to a JSON string and save it to a local directory.

The directory path is:

`/var/www/vhosts/elentra-1x-api/tests/_output/`

The file naming convention is:

`Integration/[Class Name].[Function Name].received.txt`

An example file generated from a test is:

`/tests/_output/Integration/LotteryControllerTest.list_lotteries.received.txt`

The assertion performed on the JSON result will compare it against a preconfigured JSON file. The file MUST match the name of the received text file.

An example of the expected file naming convention is:

`/tests/_output/Integration/LotteryControllerTest.list_lotteries.expected.txt`

The expected file must exist before the test is executed. The developer must create the exact JSON array and save it to the specified filepath.

### Sample Usage <a href="#user-content-sample-usage" id="user-content-sample-usage"></a>

#### JSON Structure <a href="#user-content-json-structure" id="user-content-json-structure"></a>

```
{
        "lottery_id": 1,
        "cperiod_id": 1,
        "schedule_draft_id": 1,
        "title": "Test Lottery 1",
        "available_on": "1636482300",
        "created_date": "1636482358",
        "updated_date": "1636482358",
        "deleted_date": null,
        "course_ids": [],
        "stage_count": 3,
        "audience_count": 0,
        "archived": true,
        "open_date": 1636482917,
        "close_date": 1576915199,
        "draft": {
            "cbl_schedule_draft_id": 1,
            "draft_title": "Test Draft Title",
            "status": "draft",
            "course_id": 1,
            "cperiod_id": 1,
            "created_date": "1649134829",
            "created_by": 1,
            "deleted_date": null,
            "updated_date": "1649134829",
            "updated_by": 1
        }
    }
```

#### Sample Assertions Performed Manually <a href="#user-content-sample-assertions-performed-manually" id="user-content-sample-assertions-performed-manually"></a>

```
$response = $lotteriesController->get(LotteriesSeedData::BASE_LOTTERY_ID);

$this->assertEquals($result[‘lottery_id’], LotteriesSeedData::BASE_LOTTERY_ID);
$this->assertEquals($result[‘cperiod_id’],CurriculumPeriodsSeedData::BASE_CPERIOD_ID);
$this->assertEquals($result[‘schedule_draft_id’], ScheduleDraftsSeedData::BASE_DRAFT_ID);
$this->assertEquals($result[‘title’], LotteriesSeedData::BASE_LOTTERY_TITLE);
$this->assertTrue(array_key_exists(‘draft’, $result));
$this->assertEquals($result[‘draft’][‘cbl_schedule_draft_id’], ScheduleDraftsSeedData::BASE_DRAFT_ID);
$this->assertEquals($result[‘draft’][‘draft_title’], ScheduleDraftsSeedData::BASE_DRAFT_TITLE);
```

\
This will manually assert that the expected JSON is structured as intended.

#### Sample Assertion Performed Using JSON Compare <a href="#user-content-sample-assertion-performed-using-json-compare" id="user-content-sample-assertion-performed-using-json-compare"></a>

```
const IGNORED_DATE_COLUMNS = ['created_at', 'modified_at'];

$response = $lotteriesController->get(LotteriesSeedData::BASE_LOTTERY_ID);

$this->assertJsonEquals($response, self::IGNORED_DATE_COLUMNS);
```

This will programmatically assert that the expected JSON is structured as intended.

Once the unit tests are successful, it is important to include the expected and received text files in the git commit. The CICD will require the expected file for comparison when executing the unit tests in the build pipeline once a Pull Request is created.

### TLDR <a href="#user-content-tldr" id="user-content-tldr"></a>

To compare a method's output:

`$this->assertJsonEqualsIgnoreDates($response);`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.elentra.org/technical/developers/troubleshooting/testing-with-codeception/unit-testing/phpunit-json-string-compare-function.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.