Bagian 4: Validasi dan Error Handling

<?php

declare(strict_types=1);

/**
 * Pengelola Daftar Tugas — Bagian 4: Validasi dan Error Handling.
 *
 * Program kini menolak masukan yang buruk sebelum menyentuh
 * penyimpanan: judul wajib berisi, ID wajib angka >= 1, dan
 * berkas JSON yang rusak dilaporkan dengan pesan yang jelas.
 * Seluruh kegagalan mengalir ke satu error boundary di jalankan().
 */

require_once __DIR__ . '/storage.php';

const KELUAR_OK = 0;
const KELUAR_GAGAL = 1;

function perintahBantuan(): int
{
    echo <<<TEKS
Pengelola Daftar Tugas — manajemen daftar tugas pribadi

Penggunaan:
  php main.php                   Tampilkan bantuan ini
  php main.php list              Tampilkan daftar tugas
  php main.php tambah <judul>    Tambah tugas baru
  php main.php selesai <id>      Tandai tugas sebagai selesai
  php main.php hapus <id>        Hapus tugas

Contoh:
  php main.php tambah "Belajar PHP dasar"
  php main.php selesai 1
  php main.php hapus 2

TEKS;

    return KELUAR_OK;
}

// ---------------------------------------------------------------------------
// Operasi murni atas array tugas — tanpa I/O, mudah diuji terpisah.
// ---------------------------------------------------------------------------

/** Bentuk satu tugas baru dengan status belum selesai. */
function tugasBaru(int $id, string $judul): array
{
    return ['id' => $id, 'judul' => $judul, 'selesai' => false];
}

/** Hitung ID untuk tugas berikutnya: selalu terbesar + 1. */
function idBerikutnya(array $tugas): int
{
    $terbesar = 0;

    foreach ($tugas as $t) {
        $terbesar = max($terbesar, $t['id']);
    }

    return $terbesar + 1;
}

/** Kembalikan daftar tugas baru yang sudah berisi tugas tambahan. */
function tambahTugas(array $tugas, string $judul): array
{
    $tugas[] = tugasBaru(idBerikutnya($tugas), $judul);

    return $tugas;
}

/** Cari satu tugas berdasarkan ID; null bila tidak ada. */
function cariTugas(array $tugas, int $id): ?array
{
    foreach ($tugas as $t) {
        if ($t['id'] === $id) {
            return $t;
        }
    }

    return null;
}

/** Kembalikan daftar baru dengan status selesai true; lempar bila ID tidak ada. */
function tandaiSelesai(array $tugas, int $id): array
{
    foreach ($tugas as $i => $t) {
        if ($t['id'] === $id) {
            $tugas[$i]['selesai'] = true;

            return $tugas;
        }
    }

    throw new RuntimeException("tugas dengan ID {$id} tidak ditemukan.");
}

/** Kembalikan daftar baru tanpa tugas tersebut; lempar bila ID tidak ada. */
function hapusTugas(array $tugas, int $id): array
{
    foreach ($tugas as $i => $t) {
        if ($t['id'] === $id) {
            array_splice($tugas, $i, 1);

            return $tugas;
        }
    }

    throw new RuntimeException("tugas dengan ID {$id} tidak ditemukan.");
}

/** Cetak daftar tugas ke layar dengan format centang. */
function tampilkanTugas(array $tugas): void
{
    if ($tugas === []) {
        echo "Belum ada tugas.\n";

        return;
    }

    echo "Daftar Tugas:\n";

    foreach ($tugas as $t) {
        printf("  %d. [%s] %s\n", $t['id'], $t['selesai'] ? 'x' : ' ', $t['judul']);
    }
}

// ---------------------------------------------------------------------------
// Validasi input — salah format langsung ditolak sebelum menyentuh berkas.
// ---------------------------------------------------------------------------

/**
 * Ambil dan validasi judul dari argumen perintah.
 *
 * Argumen hilang atau hanya berisi whitespace membuat fungsi ini
 * melempar InvalidArgumentException.
 */
function bacaJudul(array $argv): string
{
    $judul = $argv[2] ?? throw new InvalidArgumentException(
        'judul tugas wajib diisi. Contoh: php main.php tambah "Belajar PHP"'
    );

    $judul = trim($judul);

    if ($judul === '') {
        throw new InvalidArgumentException('judul tugas tidak boleh kosong.');
    }

    return $judul;
}

/**
 * Ambil dan validasi ID dari argumen perintah.
 *
 * Argumen wajib berupa digit dan bernilai >= 1; selain itu fungsi
 * ini melempar InvalidArgumentException.
 */
function bacaId(array $argv): int
{
    $input = $argv[2] ?? throw new InvalidArgumentException(
        'ID tugas wajib diisi. Contoh: php main.php selesai 1'
    );

    if (!ctype_digit($input) || (int) $input < 1) {
        throw new InvalidArgumentException("ID harus berupa angka, diterima: {$input}");
    }

    return (int) $input;
}

// ---------------------------------------------------------------------------
// Perintah CLI — tiap fungsi memuat, mengubah, lalu menyimpan.
// ---------------------------------------------------------------------------

function perintahList(string $berkas): int
{
    tampilkanTugas(muatTugas($berkas));

    return KELUAR_OK;
}

function perintahTambah(array $argv, string $berkas): int
{
    $judul = bacaJudul($argv);

    $tugas = muatTugas($berkas);
    $tugas = tambahTugas($tugas, $judul);
    simpanTugas($tugas, $berkas);

    $baru = $tugas[array_key_last($tugas)];

    printf("Tugas ditambahkan: [%d] %s\n\n", $baru['id'], $baru['judul']);
    tampilkanTugas($tugas);

    return KELUAR_OK;
}

function perintahSelesai(array $argv, string $berkas): int
{
    $id = bacaId($argv);

    $tugas = muatTugas($berkas);
    $hasil = tandaiSelesai($tugas, $id);
    simpanTugas($hasil, $berkas);

    $terkait = cariTugas($hasil, $id);

    printf("Tugas ditandai selesai: [%d] %s\n\n", $terkait['id'], $terkait['judul']);
    tampilkanTugas($hasil);

    return KELUAR_OK;
}

function perintahHapus(array $argv, string $berkas): int
{
    $id = bacaId($argv);

    $tugas = muatTugas($berkas);
    $terhapus = cariTugas($tugas, $id);
    $hasil = hapusTugas($tugas, $id);
    simpanTugas($hasil, $berkas);

    printf("Tugas dihapus: [%d] %s\n\n", $terhapus['id'], $terhapus['judul']);
    tampilkanTugas($hasil);

    return KELUAR_OK;
}

function perintahTidakDikenal(string $perintah): int
{
    printf("Error: perintah tidak dikenal: %s\n\n", $perintah);
    perintahBantuan();

    return KELUAR_GAGAL;
}

/**
 * Titik masuk program sekaligus error boundary: seluruh exception
 * yang wajar bagi pengguna CLI ditangkap di satu tempat, dicetak
 * sebagai pesan ramah, dan diterjemahkan menjadi exit code 1.
 */
function jalankan(array $argv, string $berkas = BERKAS_TUGAS): int
{
    try {
        return jalankanPerintah($argv, $berkas);
    } catch (RuntimeException | InvalidArgumentException | JsonException $e) {
        printf("Error: %s\n", $e->getMessage());

        return KELUAR_GAGAL;
    }
}

function jalankanPerintah(array $argv, string $berkas): int
{
    $perintah = $argv[1] ?? '';

    if ($perintah === '') {
        return perintahBantuan();
    }

    return match ($perintah) {
        'list' => perintahList($berkas),
        'tambah' => perintahTambah($argv, $berkas),
        'selesai' => perintahSelesai($argv, $berkas),
        'hapus' => perintahHapus($argv, $berkas),
        default => perintahTidakDikenal($perintah),
    };
}

// Jalankan hanya bila dieksekusi langsung sebagai skrip CLI,
// bukan saat di-include dari berkas lain (blok contoh, pengujian).
if (PHP_SAPI === 'cli' && isset($argv[0]) && realpath($argv[0]) === __FILE__) {
    exit(jalankan($argv));
}

<?php

declare(strict_types=1);

/**
 * Penyimpanan daftar tugas dalam berkas JSON — Bagian 4.
 *
 * Berbeda dari Bagian 3, kedua fungsi ini kini melempar
 * RuntimeException ketika berkas tidak dapat dibaca atau
 * isinya bukan JSON valid — kegagalan tidak lagi disembunyikan
 * sebagai daftar kosong.
 */

const BERKAS_TUGAS = __DIR__ . '/tugas.json';

/**
 * Muat seluruh tugas dari berkas JSON.
 *
 * Berkas yang belum ada tetap dianggap daftar kosong — itu
 * kondisi normal untuk pemakaian pertama. Selain itu, setiap
 * kegagalan dibaca atau didekode menjadi exception.
 */
function muatTugas(string $berkas = BERKAS_TUGAS): array
{
    if (!is_file($berkas)) {
        return [];
    }

    $isi = file_get_contents($berkas);

    if ($isi === false) {
        throw new RuntimeException("gagal membaca berkas tugas: {$berkas}");
    }

    if (!json_validate($isi)) {
        throw new RuntimeException('berkas tugas rusak: JSON tidak valid.');
    }

    $tugas = json_decode($isi, true);

    if (!is_array($tugas)) {
        throw new RuntimeException('berkas tugas rusak: format tidak dikenal.');
    }

    return $tugas;
}

/**
 * Simpan seluruh tugas ke berkas JSON.
 *
 * JSON_THROW_ON_ERROR mengubah kegagalan encoding menjadi
 * JsonException, sementara kegagalan penulisan berkas menjadi
 * RuntimeException — keduanya tertangkap error boundary di main.php.
 */
function simpanTugas(array $tugas, string $berkas = BERKAS_TUGAS): void
{
    $json = json_encode(
        $tugas,
        JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR,
    );

    if (file_put_contents($berkas, $json . "\n", LOCK_EX) === false) {
        throw new RuntimeException("gagal menulis berkas tugas: {$berkas}");
    }
}