Beranda Blog Panduan Otomasi Pengujian Script PHP dengan GitHub Actions: Cara Rilis Update Produk Digital Bebas Bug

Panduan Otomasi Pengujian Script PHP dengan GitHub Actions: Cara Rilis Update Produk Digital Bebas Bug

Bagi developer yang menjual script aplikasi atau source code di MixToko, momen merilis versi pembaruan (*product update*) seringkali menjadi situasi yang menegangkan. Memperbaiki satu fitur kecil di modul checkout terkadang tanpa sengaja merusak alur perhitungan keranjang belanja (*regression bug*), atau penambahan fungsi baru di PHP 8.3 memicu error fatal saat dijalankan oleh pembeli yang masih menggunakan PHP 8.1.

Menguji seluruh alur transaksi, autentikasi, dan logika lisensi secara manual setiap kali Anda ingin merilis file ZIP baru tidak hanya membuang waktu puluhan jam, tetapi juga rentan terhadap kelalaian manusia (*human error*). Solusi modern untuk mengatasi masalah ini adalah menerapkan Continuous Integration & Continuous Delivery (CI/CD) Pipeline menggunakan GitHub Actions dan PHPUnit. Setiap kali Anda melakukan *push* kode ke repository, sistem akan menguji integritas script secara otomatis dalam hitungan detik.

3 Pilar Pengujian Otomatis untuk Script Komersial

Sebelum memaketkan kode menjadi arsip unduhan resmi di marketplace, paket software Anda harus melewati tiga lapisan gerbang kualitas (*quality gates*):

  1. Analisis Statis (PHPStan / Psalm): Mendeteksi variabel undefined, return type mismatch, akses properti null yang tidak aman, dan pemanggilan method yang tidak ada tanpa perlu menjalankan aplikasi.
  2. Pengujian Unit & Integrasi (PHPUnit): Menguji fungsi-fungsi inti secara terisolasi—seperti validasi format lisensi, perhitungan diskon kupon, kalkulasi pajak, dan hashing password.
  3. Build Packaging Otomatis: Mengeliminasi berkas non-produksi (seperti folder .git, file konfigurasi development, berkas mock testing, dan cache lokal) lalu membungkusnya menjadi file ZIP bersih beserta checksum SHA-256.

Contoh Implementasi Unit Test dengan PHPUnit

Berikut adalah contoh pengujian otomatis untuk memvalidasi algoritma format Serial Key Lisensi dan kalkulasi diskon kupon menggunakan PHPUnit:

<?php

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;
use App\Libraries\LicenseValidator;
use App\Libraries\CouponCalculator;

class ProductCommerceTest extends TestCase
{
    private LicenseValidator $license;
    private CouponCalculator $coupon;

    protected function setUp(): void
    {
        parent::setUp();
        $this->license = new LicenseValidator();
        $this->coupon  = new CouponCalculator();
    }

    /**
     * Uji format serial key: MXTK-XXXX-XXXX-XXXX-LIVE
     */
    public function testValidLicenseKeyFormat(): void
    {
        $key = 'MXTK-8F2A-99B1-401C-LIVE';
        $this->assertTrue($this->license->isValidFormat($key));

        $invalidKey = 'INVALID-KEY-123';
        $this->assertFalse($this->license->isValidFormat($invalidKey));
    }

    /**
     * Uji perhitungan diskon voucher persentase dan nilai maksimal
     */
    public function testPercentageDiscountCalculation(): void
    {
        $subtotal = 500000;
        $discountPercent = 20; // 20%
        $maxDiscount = 50000;  // Maksimal potongan Rp 50.000

        $discountAmount = $this->coupon->calculate($subtotal, $discountPercent, $maxDiscount);
        
        // 20% dari 500.000 adalah 100.000, namun dibatasi max 50.000
        $this->assertEquals(50000, $discountAmount);
        $this->assertEquals(450000, $subtotal - $discountAmount);
    }
}

Konfigurasi GitHub Actions Workflow (.github/workflows/ci.yml)

Buat berkas konfigurasi di folder repository Anda .github/workflows/ci.yml untuk menjalankan pengujian lintas versi PHP (PHP 8.1, 8.2, dan 8.3) secara paralel pada setiap *Pull Request* dan *Git Tag*:

name: Quality Gate & Release Pipeline

on:
  push:
    branches: [ main ]
    tags: [ 'v*' ]
  pull_request:
    branches: [ main ]

jobs:
  test-suite:
    name: PHPUnit & PHPStan (PHP ${{ matrix.php-version }})
    runs-on: ubuntu-latest
    strategy:
      matrix:
        php-version: ['8.1', '8.2', '8.3']

    steps:
      - name: Checkout Source Code
        uses: actions/checkout@v4

      - name: Setup PHP Environment
        uses: shivammathur/setup-php@v2
        with:
          php-version: ${{ matrix.php-version }}
          extensions: mbstring, xml, ctype, iconv, intl, pdo_mysql, zip
          coverage: none

      - name: Install Composer Dependencies
        run: composer install --prefer-dist --no-progress --no-interaction

      - name: Run PHPStan Static Analysis
        run: vendor/bin/phpstan analyse --level=8 src/

      - name: Run PHPUnit Test Suite
        run: vendor/bin/phpunit --testdox

  build-package:
    name: Build Production Release ZIP
    needs: test-suite
    if: startsWith(github.ref, 'refs/tags/v')
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Source Code
        uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.2'

      - name: Install Production Vendors Only
        run: composer install --no-dev --optimize-autoloader

      - name: Create Clean Distribution Zip
        run: |
          mkdir dist
          zip -r dist/mixtoko-release-${{ github.ref_name }}.zip . -x "*.git*" "*tests*" "*.github*" "phpunit.xml" "phpstan.neon"
          sha256sum dist/mixtoko-release-${{ github.ref_name }}.zip > dist/checksums.txt

      - name: Upload Artifact
        uses: actions/upload-artifact@v4
        with:
          name: production-package
          path: dist/

Keuntungan Nyata bagi Seller di MixToko

Dengan mengadopsi alur otomasi ini, Anda memperoleh keunggulan kompetitif yang signifikan:

  • Zero-Downtime Updates: Tidak ada lagi cerita script gagal jalan di server pembeli karena ada fungsi yang tidak kompatibel dengan PHP versi tertentu.
  • Hemat Waktu Rilis: Pembuatan berkas ZIP produksi siap jual dilakukan oleh server GitHub dalam waktu kurang dari 1 menit.
  • Lolos Kurasi Cepat: Tim kurasi teknis MixToko memberikan prioritas review bagi seller yang menyertakan laporan test pass dan badge status build hijau di repository mereka.

Kesimpulan

Mengembangkan produk digital komersial bukan hanya tentang menulis kode baru secepat mungkin, melainkan tentang membangun sistem yang menjamin kode tersebut tetap dapat diandalkan dari waktu ke waktu. Dengan GitHub Actions dan PHPUnit, Anda dapat merilis pembaruan produk di MixToko dengan percaya diri dan reputasi profesional yang terjaga.

Bagikan Artikel:
Ada pertanyaan belanja? Tanya AI yuk!
Asisten MixToko
Online • Respons otomatis
Halo! Saya Asisten MixToko yang didukung AI.

Saya bisa bantu kamu:
• Cari produk & cek rekomendasi
• Cara beli & metode pembayaran
• Garansi, refund, & komplain
• Cek status pesanan
• Tanya seputar layanan mixtoko.net

Silakan ketik pertanyaanmu di bawah atau pilih topik cepat: