\Aksara\Laboratory\Core->insertData()

The documentation and cheat sheet of our framework

insertData() inserts a row through the Core CRUD pipeline.

Purpose

insertData() inserts a row through the Core CRUD pipeline. It lets a controller customize Aksara Core behavior while keeping the request inside the built-in CRUD, rendering, permission, validation, and response pipeline.

When to Use

Use it when you need to extend the Core CRUD flow while keeping Aksara validation, hooks, formatting, and response handling.

Reference

insertData(?string $table = null, array $data = [])

Parameters

Parameter	Type	Required	Default	Description
`$table`	`?string`	No	`null`	Database table name.
`$data`	`array`	No	`[]`	Data row, rows, or submitted values.

Return Value

object|null

Returns an Aksara response object on success or failure, or null when the flow has no explicit response to return.

Behavior

insertData() runs inside the Core data/rendering pipeline. Depending on the method, it may format data, validate input, execute a CRUD operation, or return an Aksara response.

[!WARNING]
Direct CRUD helpers still execute Core hooks and response handling. Use them only when the normal render() flow is not enough.

Basic Usage

$result = $this->insertData('orders', ['status' => 'draft']);

Advanced Usage

$this->setValidation('status', 'required|in_list[draft,paid,cancelled]');

return $this->render('orders');

Complete Example

namespace Modules\Orders\Controllers;

use Aksara\Laboratory\Core;

class Orders extends Core
{
    public function process()
    {
        $result = $this->insertData('orders', ['status' => 'draft']);

        return throw_exception(200, phrase('The request has been processed.'));
    }
}

Result

The Core pipeline returns the documented value while preserving Aksara validation, hook, permission, audit, and response behavior where applicable.

Notes

These methods are usually called by render() internally, but can be useful for advanced modules.
Keep direct calls close to the surrounding CRUD logic so the response flow is easy to audit.

Common Mistakes

Bypassing Core validation or hooks unintentionally by writing directly to the database.
Returning raw arrays when the caller expects an Aksara response object.