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*):
- 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.
- Pengujian Unit & Integrasi (PHPUnit): Menguji fungsi-fungsi inti secara terisolasi—seperti validasi format lisensi, perhitungan diskon kupon, kalkulasi pajak, dan hashing password.
- 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.
