ApplicationTestCase

Checks if CSRF token has been tampered with.

Simulates an HTTP GET request to a given URI by resolving and executing the corresponding controller and action, capturing the output.

Supports URI segments in the form of /controller/action/param1/param2, and maps them to a controller class and action method with optional parameters passed positionally.

Example:

• get('/') → HomeController::indexAction()
• get('/products/show/3') → ProductsController::showAction(3)

Makes JSON Response for error payloads.

Sends a JSON response with headers and status code.

Respond to CORS preflight.

Inject JSON body by providing payload parameter. Also performs cleanup to avoid leaking into other tests.

Assert that a record exists in the specified database table with the given conditions.

This method builds a SQL WHERE clause from the provided key-value array and checks whether a matching row exists. It fails the test if no such row is found.

Assert that no record exists in the specified database table with the given conditions.

This method builds a SQL WHERE clause from the provided key-value array and verifies that no matching row exists. It fails the test if such a row is found.

Asserts that a property exists on the View object captured via controllerOutput().

Optionally asserts that the value matches.

Clean buffer to avoid risky test error.

Simulates a controller action based on URL-style input and captures its output.

Simulates a DELETE request to a specified URI. This sets the request method to DELETE and runs the matching controller action.

Set JsonResponse::$testing to true so we can test responses.

Simulate a session where a function we are testing expects a user to be authenticated.

Simulates a JSON request to a controller/action route (bypassing the Router) and returns a {TestResponse} containing the captured output and status.

This helper is designed for testing API-style controller actions that use the {\Core\Lib\Http\JsonResponse} trait. It injects a raw JSON payload into {\Core\Lib\Http\JsonResponse::get()} via {\Core\Lib\Http\JsonResponse::$rawInputOverride}, enables test mode so JSON responses do not call exit, and sets the request method and JSON content type.

URI mapping behavior:

• "/" segments are interpreted as "/{controller}/{action}/param1/param2"
• Default controller is "home"
• Default action is "index"

Note: This does not invoke the framework Router; it directly instantiates the controller and executes the action via {\Core\Lib\Testing\controllerOutput()}.

Create a mock file for actions that require file input in form submissions.

Simulates a PATCH request to a specified URI. This sets the request method to PATCH and runs the matching controller action.

Simulates a POST request by setting $_POST data and executing the specified controller and action. Returns a TestResponse with the output and status.

Simulates a PUT request to a specified URI. This sets the request method to PUT and runs the matching controller action.

Simulates a form-style request to a controller/action route (bypassing the Router) and returns a {TestResponse} containing the captured output and status.

This helper populates the superglobals {$_POST} and {$_REQUEST} with the provided data, sets {$_SERVER['REQUEST_METHOD']} to the requested method, and executes the targeted controller action via {\Core\Lib\Testing\controllerOutput()}.

URI mapping behavior:

• "/" segments are interpreted as "/{controller}/{action}/param1/param2"
• Default controller is "home"
• Default action is "index"

Note: This does not invoke the framework Router; it directly instantiates the controller and executes the action via {\Core\Lib\Testing\controllerOutput()}.

Resolves action based on controller name and action name found in segments array.

Resolves params found in segments array.

Simulates a JSON request through the full framework routing layer and returns a {TestResponse} containing the captured output and status.

This helper is intended for end-to-end API tests where you want to exercise the Router's URL parsing and controller dispatch (i.e., closer to a real HTTP request).

It enables test-mode behavior in {\Core\Lib\Http\JsonResponse} (preventing exit), injects a raw JSON payload via {\Core\Lib\Http\JsonResponse::$rawInputOverride}, sets {$_SERVER['PATH_INFO']} and {$_SERVER['REQUEST_URI']} to the provided path, and executes {\Core\Router::route()} while capturing output buffering.

Status code behavior:

• If your JsonResponse implementation records the last status (e.g., in JsonResponse::$lastStatus), that value is used.
• Otherwise, defaults to 200.

Simulates a non-JSON request through the full framework routing layer and returns a {TestResponse} containing the captured output and status.

This helper is intended for end-to-end tests where you want to exercise the Router's URL parsing and dispatch for traditional controller/view behavior (or form submissions).

It temporarily mutates global request state:

• {$_SERVER['REQUEST_METHOD']}
• {$_SERVER['PATH_INFO']} (preferred by the Router)
• {$_SERVER['REQUEST_URI']} (fallback behavior)
• {$_GET}/{@see $_POST}/{$_REQUEST} depending on the HTTP method

The Router is then executed via {\Core\Router::route()} while output buffering is captured. All globals are restored in a finally block to reduce cross-test contamination.

Note: This helper returns status 200 on successful router execution. If a {\Throwable} is thrown, the helper returns status 500 with the exception message as content. Many "not found" or ACL flows may redirect rather than throw, depending on your Router design.

Simulates a request.

Implements setUp function from TestCase class.