Membuat dan Menjalankan Proyek FacturaScripts di ServBay

FacturaScripts adalah solusi ERP (Enterprise Resource Planning) dan CRM (Customer Relationship Management) open source yang kuat serta fleksibel, ideal digunakan oleh UKM dan pekerja lepas. Dengan kemudahan konfigurasi dari lingkungan pengembangan web lokal ServBay, Anda dapat membuat, menguji, dan menjalankan proyek FacturaScripts di macOS tanpa perlu pengaturan yang rumit.

Panduan ini akan membantu Anda secara mendetail melewati proses instalasi dan konfigurasi FacturaScripts secara lokal menggunakan ServBay.

Sekilas tentang FacturaScripts

FacturaScripts merupakan perangkat lunak ERP dan CRM open source yang dibangun dengan PHP dan framework Bootstrap. Tujuan utamanya adalah membantu bisnis mengelola proses inti seperti:

• Pembuatan dan manajemen faktur
• Akuntansi
• Kontrol inventaris
• Manajemen klien dan pemasok
• Manajemen proyek
• Serta banyak fitur tambahan lain yang tersedia melalui modul dan plugin...

Sebagai proyek open source yang sangat aktif, FacturaScripts memiliki dukungan komunitas yang kuat serta memungkinkan pengguna memperluas atau menyesuaikan fiturnya dengan plugin untuk memenuhi kebutuhan bisnis yang beragam.

Fitur dan Keunggulan Utama FacturaScripts

• Open Source Gratis: Tidak ada biaya lisensi mahal, bebas digunakan, dimodifikasi, dan didistribusikan.
• Fitur Lengkap: Meliputi hampir semua kebutuhan inti operasional harian perusahaan kecil hingga menengah dalam satu solusi terintegrasi.
• Mudah Digunakan: Tampilan antarmuka intuitif dan ramah pengguna, kurva pembelajaran yang relatif landai.
• Sangat Dapat Diperluas: Memiliki marketplace plugin yang kaya dan API terbuka, memudahkan integrasi atau penambahan fitur baru.
• Akses Antar Platform: Berbasis web, dapat diakses melalui browser pada perangkat apa pun yang mendukung browser modern.
• Komunitas Aktif: Jika mengalami kendala, Anda dapat memperoleh bantuan dari komunitas pengembang global.
• Dukungan Multi-Bahasa: Mendukung berbagai bahasa pada tampilan, memudahkan penggunaan bagi pengguna di berbagai negara.

Keunggulan Menjalankan FacturaScripts Menggunakan ServBay

ServBay adalah lingkungan pengembangan web lokal yang dirancang khusus untuk pengembang—tempat ideal menjalankan aplikasi PHP seperti FacturaScripts. Semua komponen penting sudah terintegrasi, termasuk server web Apache/Nginx, berbagai versi PHP, database MySQL/MariaDB/PostgreSQL, Redis, serta alat lain yang dikelola melalui GUI yang intuitif.

Keunggulan serta langkah utama menjalankan FacturaScripts secara lokal memakai ServBay antara lain:

• Lingkungan Terintegrasi: Semua komponen utama untuk FacturaScripts (server web, PHP, database) telah diinstal dan dikonfigurasi otomatis, tanpa perlu instalasi manual yang merepotkan.
• Manajemen Versi: Mudah berpindah antar versi PHP untuk menyesuaikan kebutuhan FacturaScripts atau pengujian kompatibilitas.
• Manajemen Database: ServBay menyediakan alat seperti phpMyAdmin/Adminer agar Anda mudah membuat dan mengelola database & user FacturaScripts.
• Konfigurasi Website yang Disederhanakan: Dengan GUI ServBay, Anda dapat dengan cepat menyiapkan website lokal, mengatur domain, root directory, server web, dan versi PHP.
• Otomatisasi Hosts File: ServBay mengelola hosts file macOS otomatis, sehingga Anda dapat mengakses situs lokal lewat domain kustom (misal facturascripts.servbay.demo) tanpa edit manual.
• Dukungan SSL: ServBay memungkinkan konfigurasi SSL/HTTPS di website lokal menggunakan User CA internal atau ACME publik untuk simulasi lingkungan produksi.

Langkah utama menjalankan FacturaScripts di ServBay yaitu:

1. Mengunduh source code FacturaScripts.
2. Membuat folder proyek di root directory situs yang dikelola ServBay.
3. Membuat database MySQL untuk FacturaScripts berikut user-nya.
4. Mengatur server web (Apache/Nginx) melalui ServBay untuk mengarah ke direktori proyek.
5. Memastikan serta mengaktifkan ekstensi PHP yang diperlukan.
6. Mengunjungi domain lokal melalui browser dan menyelesaikan wizard instalasi FacturaScripts.

Prasyarat

Pastikan Anda telah memenuhi persyaratan berikut sebelum memulai:

• Aplikasi ServBay sudah diunduh, terpasang, dan dijalankan di macOS Anda. Unduh versi terbaru di ServBay Official Website.
• Semua paket inti ServBay (web server pilihan Anda: Apache/Nginx, versi PHP, serta MySQL/MariaDB) sudah dijalankan dan berjalan lancar melalui panel ServBay.
• Memahami dasar pengembangan web dan konsep database.

Membuat Proyek FacturaScripts (Paket Zip Unduhan)

Metode ini adalah cara tercepat dan termudah untuk instalasi FacturaScripts di lingkungan lokal.

1. Unduh FacturaScripts:

   • Buka halaman unduhan resmi FacturaScripts di https://facturascripts.com/descargar.
   • Cari paket .zip versi stabil terbaru, lalu download ke komputer macOS Anda.

2. Buat Folder Proyek:

   • Buka Finder, lalu arahkan ke root directory website lokal ServBay. Lokasi default dan yang direkomendasikan untuk folder website adalah /Applications/ServBay/www/.
   • Buat folder baru di dalamnya untuk proyek FacturaScripts, misal beri nama facturascripts_project.
   • Contoh path lengkap proyek: /Applications/ServBay/www/facturascripts_project

3. Ekstrak File:

   • Cari file .zip FacturaScripts yang sudah diunduh tadi, lalu klik dua kali untuk ekstraksi.
   • Semua file dan folder hasil ekstrak (misal index.php, Core, Dinamic, Plugins, dll) salin/pindahkan ke folder /Applications/ServBay/www/facturascripts_project yang baru Anda buat.

Inisialisasi Konfigurasi (Konfigurasi Database MySQL)

FacturaScripts memerlukan database untuk menyimpan data bisnis, pengguna, dan konfigurasi. Kita akan menggunakan MySQL atau MariaDB yang dikendalikan oleh ServBay (keduanya didukung penuh).

1. Pastikan Database Berjalan:

   • Jalankan aplikasi ServBay.
   • Pada menu kiri, pilih "Paket" lalu "MySQL" atau "MariaDB" (pilih sesuai kebutuhan Anda).
   • Pastikan database yang Anda pilih sudah aktif. Jika belum, klik tombol switch di sebelahnya untuk mengaktifkan.

2. Buat Database & User:

   • Anda bisa memakai alat manajemen database internal ServBay (seperti phpMyAdmin; biasanya sudah termasuk pada paket MySQL/MariaDB), atau menggunakan command line (ada akses terminal di ServBay). Untuk pemula, phpMyAdmin lebih mudah digunakan.
   • Menggunakan phpMyAdmin (direkomendasikan):
     • Di panel ServBay, cari bagian "Database." Klik ikon phpMyAdmin di sebelah paket database (MySQL/MariaDB) Anda. Halaman login phpMyAdmin akan otomatis dibuka di browser.
     • Masuk ke phpMyAdmin. Secara default, gunakan user root dan password sesuai pengaturan awal ServBay. Jika lupa, ServBay punya fitur reset password root di halaman detail paket database.
     • Setelah login, klik tab "Database" di bagian atas.
     • Pada kolom "Buat Database," isi nama database. Agar rapi serta menghindari konflik, gunakan nama terkait proyek, misal facturascripts_servbay_db.
     • Pilih karakter set dan collation; disarankan utf8mb4_general_ci / utf8mb4_unicode_ci untuk dukungan karakter luas & emoji.
     • Klik tombol "Buat".
     • Buat User Database (opsional tapi sangat dianjurkan): Demi keamanan, jangan gunakan user root di aplikasi. Buatlah user khusus FacturaScripts.
       • Kembali ke home phpMyAdmin, klik tab "User Accounts" di atas.
       • Klik "Add User Account".
       • Masukkan username (misal facturascripts_servbay_user), hostname localhost atau 127.0.0.1 (hanya bisa akses dari lokal).
       • Masukkan/password yang kuat dan catat password tersebut di tempat aman.
       • Pada bagian bawah, Anda bisa memilih memberikan user ini seluruh hak atas database yang barusan dibuat. Cara mudah: cek “Create database with same name and grant all privileges.” Atau, pilih “Grant privileges on specific database,” cari database facturascripts_servbay_db, centang “All privileges.”
       • Klik "Go"/"Execute" untuk menyimpan.

3. Catat Data Koneksi Database: Informasi berikut dibutuhkan saat instalasi FacturaScripts:

   • Nama database (misal facturascripts_servbay_db)
   • Nama user database (misal facturascripts_servbay_user)
   • Password user database (yang Anda buat di atas)
   • Host database (biasanya localhost atau 127.0.0.1)
   • Port database (default MySQL/MariaDB: 3306, cek nomor port di panel ServBay jika berbeda)

Setting Server Web (Apache atau Nginx)

Selanjutnya, kita akan memberi tahu ServBay bagaimana mengakses file proyek FacturaScripts via server web (Apache/Nginx). Kedua server ini didukung penuh ServBay.

1. Pastikan Web Server Berjalan:

   • Pada panel "Paket" ServBay, pastikan web server pilihan Anda (Apache/Nginx) dalam status aktif.

2. Tambah Website:

   • Pada menu kiri ServBay, pilih "Situs" (Site).
   • Klik tombol "+" di atas daftar situs untuk menambah konfigurasi website baru.
   • Isi data pada form konfigurasi:
     • Nama: Misal FacturaScripts Demo Site.
     • Domain: Masukkan domain lokal yang akan digunakan, disarankan mengikuti konvensi .servbay.demo, contohnya facturascripts.servbay.demo.
     • Tipe Website: Pilih PHP (aplikasi web dinamis PHP).
     • Root Directory: Klik “Browse/Pilih,” arahkan ke folder FacturaScripts (misal /Applications/ServBay/www/facturascripts_project). Catatan: Umumnya root pointing langsung ke folder proyek, namun cek dokumentasi FacturaScripts jika harus pointing ke subfolder khusus.
     • Versi PHP: Pilih versi yang kompatibel dengan FacturaScripts, umumnya PHP 8.1, 8.2, atau terbaru. ServBay memungkinkan pilihan & switching antar versi PHP dengan mudah.
     • Pengaturan Lain: Biasanya bisa dibiarkan default. Anda juga dapat mengatur SSL/HTTPS, CORS, dan opsi lanjutan lain sesuai kebutuhan.

3. Simpan & Update Hosts:

   • Klik "Tambah" atau "Simpan" setelah mengisi seluruh data.
   • ServBay akan otomatis setup virtual host/server block pada server web, dan meminta admin access untuk mengedit file hosts macOS, mengarahkan facturascripts.servbay.demo ke IP lokal (127.0.0.1). Ini akan membuat domain lokal bisa diakses dari browser tanpa edit manual file hosts.

4. Cek & Aktifkan Ekstensi PHP:

   • FacturaScripts memerlukan sejumlah ekstensi PHP untuk berjalan dengan baik, seperti pdo_mysql, gd (olah gambar), intl (internasionalisasi), zip (kompresi), xml, curl (koneksi), dan lainnya. ServBay biasaya sudah mengaktifkan banyak ekstensi umum, namun jika ada notifikasi kekurangan ekstensi saat instalasi/menjalankan FacturaScripts, aktifkan lewat ServBay.
   • Langkah Aktifkan Ekstensi:
     • Di menu kiri, pilih "Languages" > "PHP".
     • Pilih versi PHP yang dikaitkan dengan site (misal PHP 8.2).
     • Pada detail versi PHP, buka tab "Ekstensi".
     • Lihat daftar ekstensi yang terinstall dan enable/disable. Jika FacturaScripts meminta ekstensi tertentu (misal opcache), tinggal centang untuk mengaktifkan.
     • Klik “Terapkan/Simpan.” Beberapa ekstensi memerlukan restart PHP, cukup klik tombol restart di sebelah versi PHP terkait untuk menerapkan perubahan.

Contoh antarmuka konfigurasi situs di ServBay

Akses Website dan Selesaikan Wizard Instalasi FacturaScripts

Lingkungan ServBay Anda kini siap digunakan untuk proses instalasi FacturaScripts secara online.

1. Buka Browser: Gunakan browser favorit Anda (Chrome, Firefox, Safari, dsb).

2. Masukkan Alamat: Pada address bar, ketik domain lokal (misal http://facturascripts.servbay.demo). Jika di ServBay Anda telah mengaktifkan SSL untuk situs ini, bisa juga akses via https://facturascripts.servbay.demo. Tekan Enter.

3. Wizard Instalasi FacturaScripts:

   • Jika seluruh pengaturan situs, hosts, web server, dan PHP sudah benar, Anda akan melihat halaman selamat datang atau wizard instalasi FacturaScripts.
   • Pilih Bahasa: Awali dengan memilih bahasa utama antarmuka.
   • Pemeriksaan Sistem: Installer FacturaScripts otomatis mengecek lingkungan server (versi PHP, ekstensi, hak tulis direktori, dll) sudah memenuhi syarat. Jika semua benar, akan muncul indikator hijau. Jika ada error/warning, cek versi PHP, ekstensi, dan juga hak akses folder proyek (pastikan writable oleh user web server).
   • Konfigurasi Database: Di tahap ini masukkan:
     • Tipe Database: Pilih MySQL.
     • Host: localhost atau 127.0.0.1.
     • Port: 3306 atau sesuai port yang digunakan di ServBay.
     • Nama Database: facturascripts_servbay_db (sesuai yang dibuat di phpMyAdmin).
     • User: facturascripts_servbay_user (user DB yang Anda buat).
     • Password: Password untuk user tersebut.
     • Table Prefix: Bisa dibiarkan default (fs_) atau ganti sesuai kebutuhan.
   • Akun Administrator: Buat username, password, dan email admin untuk FacturaScripts. Pastikan password kuat dan informasinya disimpan aman—akun ini yang dipakai untuk login dashboard FacturaScripts.
   • Instalasi: Setelah semua benar, klik tombol instalasi. FacturaScripts akan mengkoneksi ke database, membuat tabel, dan menyimpan konfigurasi.

4. Instalasi Selesai:

   • Jika berhasil, terkadang FacturaScripts meminta Anda menghapus folder install dari root proyek demi keamanan. Ikuti instruksi tersebut.
   • Kini Anda sudah bisa mengakses halaman login FacturaScripts lewat http://facturascripts.servbay.demo (atau HTTPS jika SSL aktif). Masuklah dengan akun admin yang tadi Anda buat dan eksplorasi fitur-fitur FacturaScripts!

Tanya Jawab (FAQ)

• Tanya: Wizard instalasi FacturaScripts bilang ekstensi PHP kurang?
  • Jawab: Buka ServBay > "Languages" > "PHP", pilih versi PHP yang dipakai FacturaScripts, lalu buka tab "Ekstensi". Centang/enable ekstensi yang diminta (misal opcache). Klik "Terapkan" dan restart layanan PHP jika diperlukan.
• Tanya: Mengakses facturascripts.servbay.demo muncul “Forbidden” atau halaman kosong?
  • Jawab: Cek server web (Apache/Nginx) & layanan PHP di ServBay sudah berjalan. Pastikan path "Root Directory" di pengaturan website ServBay sesuai dengan folder proyek FacturaScripts. Jika halaman kosong, mungkin ada error PHP, cek log error web server atau PHP. Jika “Forbidden”, biasanya terkait hak akses file atau direktori, pastikan user web server di ServBay bisa membaca file proyek dan menulis ke folder seperti Dinamic.
• Tanya: Gagal koneksi database FacturaScripts?
  • Jawab: Pastikan MySQL/MariaDB berjalan dan port-nya cocok (normalnya 3306). Cocokkan seluruh informasi koneksi database yang dimasukkan di wizard FacturaScripts sama persis dengan yang dibuat di ServBay (host, port, nama DB, user, password).

Kesimpulan

Dengan ServBay, proses instalasi serta menjalankan FacturaScripts secara lokal di macOS menjadi sangat mudah. Semua kebutuhan (web server, PHP, database) sudah tersedia serta bisa dikonfigurasi lewat UI yang sederhana. Ikuti setiap langkah panduan ini, Anda akan memiliki lingkungan pengembangan atau uji lokal FacturaScripts dalam waktu singkat—sehingga Anda bisa lebih fokus pada eksplorasi fitur bisnis dan pengelolaan tugas di FacturaScripts. Fleksibilitas serta kemudahan ServBay dapat meningkatkan efisiensi kerja Anda dalam mengembangkan aplikasi secara lokal.