PHPackages                             koyabu/webapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. koyabu/webapi

ActiveLibrary[Framework](/categories/framework)

koyabu/webapi
=============

Koyabu API Framework

v8.2.2.x-dev(1w ago)0133MITPHPPHP &gt;=8.3

Since Apr 17Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/stievenk/phpframework-koyabu)[ Packagist](https://packagist.org/packages/koyabu/webapi)[ Docs](https://github.com/stievenk/phpframework-koyabu)[ RSS](/packages/koyabu-webapi/feed)WikiDiscussions v8.2.2 Synced today

READMEChangelog (4)Dependencies (43)Versions (6)Used By (0)

Koyabu Webapi - Form Framework Documentation
============================================

[](#koyabu-webapi---form-framework-documentation)

[![Latest Stable Version](https://camo.githubusercontent.com/7c0702b404926bfafc70f8a5140895f4bbd8067c9288ab8e9845cf54b76ffad8/68747470733a2f2f706f7365722e707567782e6f72672f6b6f796162752f7765626170692f646f776e6c6f616473)](https://packagist.org/packages/koyabu/webapi)

**Koyabu Framework** adalah library PHP utilitas yang dirancang untuk mempercepat pengembangan aplikasi web melalui abstraksi database, pengolahan gambar, manajemen waktu, dan integrasi API pihak ketiga seperti Dropbox, QR Code, dan Google 2FA.

Informasi Versi
---------------

[](#informasi-versi)

- **Versi Core**: 8.2.2
- **Terakhir Diperbarui**: 14 April 2026
- **Kebutuhan Minimum**: PHP 8.3+
- **Rekomendasi Database**: MariaDB 10+ atau MySQL 8+

---

Fitur Utama
-----------

[](#fitur-utama)

### 1. Database Wrapper (Multi-Driver)

[](#1-database-wrapper-multi-driver)

Mendukung driver `mysql`, `mysqli`, `pdo`, dan `odbc` secara otomatis melalui konfigurasi.

- **`get($params)`**: Mengambil satu baris data berdasarkan kriteria field tunggal atau array menggunakan operasi AND.
- **`saveTable($params)`**: Otomatis memfilter data berdasarkan struktur tabel yang ada. Mendukung metode `INSERT`, `UPDATE`, `REPLACE`, dan `DUPLICATEUPDATE` (`ON DUPLICATE KEY UPDATE`).
- **`delete($params, $table)`**: Menghapus data berdasarkan kriteria array atau query SQL mentah.
- **Transaction Support**: Dilengkapi dengan metode `start_transaction()`, `commit_transaction()`, dan `rollback_transaction()`.

### 2. Utilitas Angka &amp; Lokalisasi (ID/EN)

[](#2-utilitas-angka--lokalisasi-iden)

- **`terbilang($nilai)`**: Konversi angka ke teks bahasa Indonesia, mendukung nilai negatif dan angka desimal (koma).
- **`numberShort($num, $lan, ...)`**: Menyingkat angka besar (contoh: 1.5M / 1.5Jt) dengan dukungan satuan dari Ribuan hingga Kuintiliun dalam bahasa Indonesia atau Inggris.

### 3. Pengolahan Gambar &amp; Filter Visual

[](#3-pengolahan-gambar--filter-visual)

- **`resizeAndWatermarkImage($params)`**:
    - Mengubah ukuran gambar secara proporsional sesuai rasio aspek.
    - Mendukung 9 posisi watermark (seperti `top-right`, `center`, `bottom-left`).
    - **Filter Visual**: Pixelate, Negatif, Smooth, Colorize, Gaussian Blur, dan Selective Blur.

### 4. Markdown &amp; Teks Parser

[](#4-markdown--teks-parser)

- **`markdownToHtml($markdown)`**: Konverter Markdown ke HTML yang mendukung:
    - Blok kode, tabel, daftar (list), dan kutipan (blockquote).
    - **Auto-Link Detection**: Otomatis mendeteksi URL, Email, dan nomor telepon.
    - **WhatsApp Integration**: Otomatis mendeteksi nomor telepon Indonesia dan mengarahkannya ke link `wa.me`.

### 5. Keamanan &amp; Integrasi API

[](#5-keamanan--integrasi-api)

- **QR Code**: Generate QR Code ke format Base64 atau file fisik, serta fitur `QRcodeRead` untuk membaca isi file QR.
- **Google 2FA**: Membangun sistem otentikasi dua faktor termasuk pembuatan Secret Key dan validasi OTP.
- **Dropbox Storage**: Integrasi upload (overwrite) dan delete file dengan pembuatan shared link secara otomatis.
- **Logging System**: Mencatat log aktivitas atau error secara otomatis ke database tabel `z_debug` dan file fisik.

---

Contoh Penggunaan
-----------------

[](#contoh-penggunaan)

### Inisialisasi &amp; Simpan Data

[](#inisialisasi--simpan-data)

```
use Koyabu\Webapi\Form;

$config = [
    'database' => [
        'driver' => 'mysqli',
        'host'   => 'localhost',
        'user'   => 'root',
        'pass'   => 'password',
        'name'   => 'nama_database'
    ]
];

$form = new Form($config);

// Menyimpan data dengan auto-filter field tabel
$id = $form->save(['username' => 'stieven', 'status' => 'aktif'], 'users');
```

### Konversi Angka &amp; Waktu

[](#konversi-angka--waktu)

```
// Hasil: seratus lima puluh ribu koma lima
echo $form->terbilang(150000.50);

// Hasil: Rp 2.5Jt
echo $form->numberShort(2500000, 'ID', 1, 'SHORT', 'Rp');

// Hasil: 1 Hari 1 Jam 1 Menit 1 Detik
echo $form->formatWaktu(90061);
```

---

Instalasi
---------

[](#instalasi)

```
composer require koyabu/webapi:^v8.2.2
```

### composer.json

[](#composerjson)

```
{
    "minimum-stability": "dev",
    "prefer-stable": false
}
```

**Author**:

```

```

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance92

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~107 days

Total

5

Last Release

10d ago

PHP version history (3 changes)v8.1.1.x-devPHP ^8.1

v8.2.0.x-devPHP &gt;=8.1

v8.2.2.x-devPHP &gt;=8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/486428?v=4)[Stieven Kalengkian](/maintainers/stievenk)[@stievenk](https://github.com/stievenk)

---

Top Contributors

[![stievenk](https://avatars.githubusercontent.com/u/486428?v=4)](https://github.com/stievenk "stievenk (178 commits)")

### Embed Badge

![Health badge](/badges/koyabu-webapi/health.svg)

```
[![Health](https://phpackages.com/badges/koyabu-webapi/health.svg)](https://phpackages.com/packages/koyabu-webapi)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1235.9k20](/packages/fleetbase-core-api)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k17.8k](/packages/prestashop-prestashop)[filament/filament

A collection of full-stack components for accelerated Laravel app development.

3829.6M3.6k](/packages/filament-filament)[contao/core-bundle

Contao Open Source CMS

1231.6M2.8k](/packages/contao-core-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
