··············································
:                                            :
:                                       _    :
:  _ __   ___  _ __ ___  _ __ ___   ___| |_  :
: | '_ \ / _ \| '_ ` _ \| '_ ` _ \ / _ \ __| :
: | |_) | (_) | | | | | | | | | | |  __/ |_  :
: | .__/ \___/|_| |_| |_|_| |_| |_|\___|\__| :
: |_|                                        :
:                                            :
··············································

pommet

Toolkit Pengembangan PHP Lokal yang Ringan
Laporkan Bug · Berkontribusi

Note

Dokumentasi ini ditulis dalam Bahasa Indonesia. Klik di sini untuk versi bahasa Inggris.

---

Tentang Pommet

Pommet adalah alternatif ringan untuk XAMPP yang dirancang khusus untuk pengembangan PHP di Windows. Berbeda dengan solusi serupa yang cenderung berat dan memakan banyak resource, Pommet hadir dengan pendekatan minimalis tanpa mengorbankan fungsionalitas yang diperlukan.

Pommet mengelola komponen-komponen berikut:

• Apache HTTP Server (v2.4.63)
• PHP (v8.4.7)
• MariaDB (v11.4.7)
• phpMyAdmin (v5.2.2)

Aplikasi ini dibangun menggunakan Rust dengan antarmuka terminal yang sederhana namun efektif untuk mengelola seluruh layanan pengembangan lokal Anda.

Status Pengembangan

Pommet saat ini masih dalam tahap pengembangan awal dengan versi 0.x. Hal ini berarti:

• Belum direkomendasikan untuk lingkungan produksi
• Cocok untuk pengembangan aplikasi skala kecil hingga menengah
• Ideal untuk pembelajaran dan eksperimen
• Stabil untuk kebutuhan pengembangan sehari-hari

---

Mengapa Memilih Pommet

Penggunaan Resource yang Efisien

Pommet dirancang dengan prinsip minimalis. Aplikasi ini hanya menggunakan resource yang benar-benar diperlukan, berbeda dengan alternatif lain yang sering kali membawa komponen-komponen yang tidak terpakai.

Instalasi Otomatis

Seluruh proses instalasi dan konfigurasi dilakukan secara otomatis. Anda tidak perlu repot mengunduh dan mengatur setiap komponen secara manual.

Konfigurasi yang Sudah Siap Pakai

Semua layanan telah dikonfigurasi untuk bekerja bersama tanpa konflik. Anda dapat langsung mulai mengembangkan aplikasi tanpa harus melalui proses troubleshooting yang merepotkan.

Antarmuka yang Bersih

Terminal interface yang sederhana namun powerful memungkinkan Anda mengelola semua layanan dari satu tempat dengan navigasi keyboard yang intuitif.

---

Panduan Instalasi

Persyaratan Sistem

• Sistem operasi Windows 10 atau 11
• Koneksi internet untuk mengunduh komponen
• Hak akses administrator (hanya untuk instalasi)

Pilihan Instalasi

Pilih salah satu metode instalasi berikut:

Opsi 1: PowerShell (Otomatis)

Buka PowerShell sebagai administrator dan jalankan:

# Buat direktori pommet
New-Item -ItemType Directory -Force -Path "C:\pommet"

# Download executable terbaru
$url = "https://github.com/hippocampa/pommet/releases/latest/download/pommet.exe"
Invoke-WebRequest -Uri $url -OutFile "C:\pommet\pommet.exe"

# Tambahkan ke PATH
$currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
if ($currentPath -notlike "*C:\pommet*") {
    [Environment]::SetEnvironmentVariable("PATH", "$currentPath;C:\pommet", "User")
}

Write-Host "Instalasi selesai! Restart terminal dan jalankan 'pommet' untuk memulai."

Opsi 2: Command Prompt (Otomatis)

Buka Command Prompt sebagai administrator dan jalankan:

:: Buat direktori pommet
mkdir C:\pommet

:: Download executable (membutuhkan curl yang tersedia di Windows 10+)
curl -L -o C:\pommet\pommet.exe https://github.com/hippocampa/pommet/releases/latest/download/pommet.exe

:: Tambahkan ke PATH
setx PATH "%PATH%;C:\pommet" /M

echo Instalasi selesai! Restart terminal dan jalankan 'pommet' untuk memulai.

Opsi 3: Download Manual

1. Kunjungi halaman GitHub Releases
2. Unduh file pommet.exe dari rilis terbaru
3. Buat folder C:\pommet dan pindahkan file pommet.exe ke dalamnya
4. Tambahkan C:\pommet ke PATH environment variable:
   • Buka System Properties → Advanced → Environment Variables
   • Pilih PATH di User variables → Edit
   • Tambahkan C:\pommet ke daftar
5. Restart terminal dan jalankan pommet

Setelah Instalasi

Setelah instalasi selesai:

1. Buka terminal baru (Command Prompt atau PowerShell) - tidak perlu sebagai administrator
2. Jalankan perintah pommet
3. Biarkan Pommet mengunduh dan menginstal semua komponen secara otomatis
4. Aplikasi siap digunakan

Catatan: Setelah terinstal, Pommet dapat dijalankan tanpa hak administrator. Hak admin hanya diperlukan saat instalasi awal.

Akses Layanan

Setelah layanan berjalan, Anda dapat mengakses:

Layanan	Alamat	Keterangan
Web server	http://localhost/	Server pengembangan utama
phpMyAdmin	http://localhost/phpmyadmin	Antarmuka manajemen database
MariaDB	Port 3306	Koneksi database langsung
User default	root (tanpa password)	Kredensial database

---

Konfigurasi

Jika Anda perlu melakukan penyesuaian, berikut adalah lokasi file konfigurasi:

C:/pommet/bin/
├── Apache24/conf/httpd.conf
├── php8/php.ini
├── mariadb-11.4.7-winx64/my.ini
└── Apache24/htdocs/phpMyAdmin-5.2.2-english/config.inc.php

Pastikan untuk membuat backup sebelum melakukan perubahan pada file konfigurasi, dan restart layanan yang terkait setelah melakukan modifikasi.

Panduan Uninstall

Untuk menghapus Pommet dari sistem:

Opsi 1: Powershell (Automatis)

# Hentikan semua layanan Pommet jika sedang berjalan
taskkill /f /im "httpd.exe" 2>$null
taskkill /f /im "mysqld.exe" 2>$null
taskkill /f /im "pommet.exe" 2>$null

# Hapus direktori Pommet
Remove-Item -Recurse -Force "C:\pommet" -ErrorAction SilentlyContinue

# Hapus dari PATH
$currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
$newPath = $currentPath -replace ";C:\\pommet", "" -replace "C:\\pommet;", "" -replace "C:\\pommet", ""
[Environment]::SetEnvironmentVariable("PATH", $newPath, "User")

Write-Host "Pommet berhasil dihapus dari sistem."

Opsi 2: Manual

1. Hentikan semua pelayanan Pommet jika sedang berjalan.
2. Hapus folder C:\pommet beserta seluruh isinya.
3. Hapus C:\pommet dari PATH environment variable:

• Buka System Properties → Advanced → Environment Variables
• Pilih PATH di User variables → Edit
• Hapus C:\pommet dari daftar
• Restart terminal untuk memastikan perubahan PATH diterapkan

---

Pengembangan

Membangun dari Source Code

Untuk membangun Pommet dari source code, pastikan Rust sudah terinstal di sistem Anda:

# Clone repository
git clone https://github.com/hippocampa/pommet.git
cd pommet

# Build project
cargo build --release

# Jalankan aplikasi
./target/release/pommet.exe

---

Kontribusi

Proyek ini masih membutuhkan bantuan pengembangan dalam beberapa area:

Area yang Membutuhkan Bantuan

• Implementasi log realtime seperti yang ada di XAMPP
• Deteksi otomatis untuk layanan yang masih berjalan
• Refaktoring trait Plugin, kemungkinan memerlukan trait Toggleable

Cara Berkontribusi

1. Fork repository ini
2. Buat branch untuk fitur baru
3. Commit perubahan Anda
4. Push ke branch yang dibuat
5. Buat Pull Request

Melaporkan Bug

Jika Anda menemukan bug, silakan buat issue baru dengan menyertakan:

• Versi sistem operasi dan spesifikasi
• Langkah-langkah untuk mereproduksi bug
• Perilaku yang diharapkan vs yang terjadi
• Screenshot jika diperlukan

---

Lisensi

Proyek ini didistribusikan di bawah Lisensi MIT. Lihat file LICENSE untuk informasi lengkap.

---

Penghargaan

Terima kasih kepada proyek-proyek open source yang membuat Pommet menjadi mungkin:

• Apache HTTP Server - Web server yang handal
• PHP - Bahasa pemrograman web yang powerful
• MariaDB - Sistem manajemen database yang cepat
• phpMyAdmin - Antarmuka manajemen database berbasis web
• Rust - Bahasa pemrograman yang aman dan cepat

---

Berikan bintang untuk Pommet!