# Bekerja Dengan Model

Dalam framework yang menggunakan pola desain MVC, model merupakan komponen yang merepresentasikan modeling object data yang digunakan pada aplikasi.

Mari kita mulai membuat sebuah model pada O2System Framework. Sebagai contoh kita akan membuat model untuk menampilkan artikel dari database yang paling populer digunakan yaitu MySQL.

## 1. Mengubah Konfigurasi

Untuk mulai bekerja dengan database anda harus melakukan konfigurasi database terlebih dahulu. Konfigurasi database tersimpan pada [directory Config](/pengantar/struktur-direktori.md#direktori-config) dari aplikasi anda.

Bukalah file konfigurasi Database.php anda akan melihat source code seperti dibawah ini. Lakukanlah perubahan sesuai dengan konfigurasi MySQL anda.

{% code title="/path/to/app/Config/Database.php" %}

```php
<?php

$database[ 'default' ] = [
    'driver'       => 'mysql',
    'dsn'          => '',
    'hostname'     => 'localhost',
    'port'         => 3306,
    'username'     => 'root',
    'password'     => 'mysql',
    'database'     => 'o2system_tutorial',
    'charset'      => 'utf8',
    'collate'      => 'utf8_general_ci',
    'tablePrefix'  => '',
    'strictOn'     => false,
    'encrypt'      => false,
    'compress'     => false,
    'buffered'     => false,
    'persistent'   => true,
    'transEnable' => false,
    'cacheEnable' => false,
    'debugEnable' => true,
];
```

{% endcode %}

## 2. Membuat Table Database

Buatlah sebuah table database dengan perintah MySQL dibawah ini:

```sql
CREATE TABLE `articles` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `title` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `content` text COLLATE utf8_unicode_ci DEFAULT NULL,
  `record_status` enum('DELETE','ARCHIVE','DRAFT','UNPUBLISH','PUBLISH') COLLATE utf8_unicode_ci DEFAULT 'PUBLISH',
  `record_create_timestamp` datetime DEFAULT NULL,
  `record_create_user` int(10) unsigned DEFAULT NULL,
  `record_update_timestamp` timestamp NULL DEFAULT NULL ON UPDATE current_timestamp(),
  `record_update_user` int(10) unsigned DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci ROW_FORMAT=COMPACT;
```

> Di O2System Framework modeling anda akan diperkenalkan dengan sebuah konsep skema table database baru dimana pada setiap table akan terdapat kolom-kolom berawalan record yang selanjutnya akan disebut sebagai record set.

Isi table dengan 2 contoh data melalui perintah MySQL dibawah ini:

```sql
INSERT INTO `o2system_tutorial`.`articles`(`id`, `title`, `content`, `record_status`, `record_create_timestamp`, `record_create_user`, `record_update_timestamp`, `record_update_user`) VALUES (1, 'My First Article', 'This is my first article.', 'PUBLISH', '2018-10-08 09:06:21', NULL, '2018-10-08 09:06:21', NULL);
INSERT INTO `o2system_tutorial`.`articles`(`id`, `title`, `content`, `record_status`, `record_create_timestamp`, `record_create_user`, `record_update_timestamp`, `record_update_user`) VALUES (2, 'My Second Article', 'This is my second article.', 'PUBLISH', '2018-10-08 09:08:31', NULL, '2018-10-08 09:08:31', NULL);
```

## 3. Membuat Model

Buatlah sebuah file Model berekstensi [php](http://filext.com/file-extension/PHP) dan simpanlah pada [directory Model](/pengantar/struktur-direktori.md#direktori-models), berisikan source code seperti pada contoh dibawah ini:

{% code title="/path/to/app/Models/Articles.php" %}

```php
<?php
namespace App\Models;
​
use O2System\Framework\Models\Sql\Model;
​
/**
* Class Articles
*
* @package App\Models
*/
class Articles extends Model
{
    public $table = 'articles';
}
```

{% endcode %}

## 4. Membuat Controller

Buatlah sebuah file Controller baru, berisikan source code seperti pada contoh dibawah ini:

{% code title="/path/to/app/Controllers/Articles.php" %}

```php
<?php
namespace App\Controllers;
​
use O2System\Framework\Http\Controller;
​
/**
* Class Articles
*
* @package App\Controllers
*/
class Articles extends Controller
{
    public function index() 
    {
        print_out( $this->model->allWithPaging() );
    }
}
```

{% endcode %}

Pada langkah pembuatan Controller kali ini anda akan berkenalan dengan 4 fitur   pintar dari O2System Framework yaitu:

### 4.1 Debugger Print Out

Fungsi print\_out merupakan salah satu fitur debugging dari [Atom Gear](https://github.com/o2system/gear) pada O2System Framework. Fitur ini sangat membantu sekali, karena secara pintar O2System akan mengumpulkan informasi-informasi penting untuk membantu kita melakukan proses debugging.&#x20;

Sebagai contoh ilustrasi kita perlu melihat bagaimana struktur object model data articles yang telah kita buat pada langkah-langkah sebelumnya. Cobalah akses melalui browser anda ke alamat URL

```
http://localhost:8000/articles
```

Anda akan melihat tampilan debugger print\_out yang dilengkapi dengan beberapa informasi penting salah satunya adalah debug backtrace, yang akan selalu memberitahu kepada anda dari mana fungsi print\_out ini dijalankan serta perjalanan prosesnya.

### 4.2 Identical Model Autoloading

Identical Model Autoloading salah satu fitur dari O2System Framework dimana O2System secara pintar akan mencari Model yang memiliki nama class yang sama dengan nama class Controller yang diakses pada namespace Models. Jadi anda tidak perlu repot memanggilnya karena secara pintar O2System telah menyediakannya sebagai property pada class Controller yang anda akses dengan property *"model"*. Pada contoh diatas anda telah mempergunakannya yaitu:

```php
$this->model
```

### 4.3 Built-in Finder-Trait

Class model yang anda buat di langkah sebelumnya merupakan turunan dari class SQL Model pada O2System Framework. Didalamnya telah terdapat Finder-Trait yang merupakan salah satu modeling reusable-code pada O2System Framework, berfungsi untuk menyediakan metode-metode pencarian pada model. Pada contoh diatas anda telah mempergunakan salah satunya yaitu:

```php
$this->model->allWithPaging();
```

Perhatikan source code model yang anda miliki, didalamnya hanya terdapat pendefinisian property table dengan nilai articles yang merujuk kepada nama table articles pada database. Secara pintar O2System Framework akan melakukan kalkulasi pembangunan SQL Statement melalui fitur Query Builder yang merupakan salah satu fitur dari [Atom Database](https://github.com/o2system/database), lalu mengeksekusinya sebagai perintah MySQL dan menyediakan hasilnya kepada anda dalam bentuk Data Object Result.

### 4.4 Data Object Result

Data Object Result merupakan bentuk Modeling Data Object pintar berfitur unik yang akan sangat mempercepat kinerja anda. Beberapa fitur diantaranya adalah:

1. [Object Relation Mapping (ORM)](https://en.wikipedia.org/wiki/Object-relational_mapping)
2. [SPL Array Iterator](http://php.net/manual/en/class.arrayiterator.php)
3. [JsonSerializeable Interface](http://php.net/manual/en/jsonserializable.jsonserialize.php)
4. User Interface Pagination Component

Masih banyak lagi fitur-fitur yang tertanam didalamnya. Anda dapat mempelajarinya pada bagian pendalaman ORM.

## 5. Membuat View

Buatlah sebuah file View baru, berisikan source code seperti pada contoh dibawah ini:

{% code title="/path/to/app/Views/articles.phtml" %}

```markup
<h1>Articles</h1>
{{ if($articles) }}
    {{ foreach($articles as $article) }}
        <h2>{{ $article->title }}</h2>
        <p>{{ $article->content }}</p>
        <hr>
    {{ /foreach }}
    {{ $articles->pagination() }}
{{ /if }}
```

{% endcode %}

Pada langkah pembuatan view sebelumnya kita diajarkan untuk menggunakan fungsi echo bahasa programming PHP. Namun pada langkah pembuatan view kali ini anda diperkenalkan dengan salah satu fitur template parser pada O2System Framework yaitu Noodle Template Parser. Noodle Template Parser memiliki kesederhanaan bahasa templating karena memiliki banyak kesamaan perintah dengan bahasa programming PHP.&#x20;

## 6. Melakukan Kombinasi MVC

Setelah kita selesai membuat Controller, Model dan View langkah selanjutnya adalah memadukannya sesuai dengan pola MVC melalui Controller.

Bukalah kembali file Controller Articles yang telah kita buat tadi lakukan perubahan dengan mengganti line source code kita yang berisikan fungsi print\_out tadi seperti source code dibawah ini:

{% code title="/path/to/app/Controllers/Articles.php" %}

```php
<?php
namespace App\Controllers;
​
use O2System\Framework\Http\Controller;
​
/**
* Class Articles
*
* @package App\Controllers
*/
class Articles extends Controller
{
    public function index() 
    {
        $this->load->view('articles', [
            'articles' => $this->model->allWithPaging();
        ]);
    }
}
```

{% endcode %}

Untuk penggunaan lebih lanjut anda dapat membacanya pada bagian pendalaman [Model](/pendalaman/model.md).


---

# 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://userguide.o2system.id/tutorial/bekerja-dengan-model.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.