ServBay

Bahasa Melayu

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Polski
Nederlands
Українська
ไทย
한국어

Bahasa Melayu

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Polski
Nederlands
Українська
ไทย
한국어

Appearance

Cipta dan Jalankan Projek FacturaScripts di ServBay ​

FacturaScripts ialah penyelesaian ERP (Perancangan Sumber Enterprise) dan CRM (Pengurusan Hubungan Pelanggan) sumber terbuka yang berkuasa dan fleksibel, sangat sesuai untuk perniagaan kecil hingga sederhana serta pekerja bebas. Dengan persekitaran pembangunan web tempatan yang mudah dari ServBay, anda boleh mencipta, menguji dan menjalankan projek FacturaScripts dengan mudah di macOS tanpa konfigurasi yang rumit.

Panduan ini akan membimbing anda secara terperinci melalui keseluruhan proses pemasangan dan konfigurasi FacturaScripts secara tempatan menggunakan ServBay.

Pengenalan Ringkas FacturaScripts ​

FacturaScripts ialah perisian ERP dan CRM sumber terbuka yang dibangunkan berasaskan PHP dan Bootstrap. Ia direka untuk membantu perniagaan mengurus operasi teras mereka, termasuk:

  • Pengeluaran dan pengurusan invois
  • Perakaunan
  • Kawalan inventori
  • Pengurusan pelanggan dan pembekal
  • Pengurusan projek
  • Dan banyak lagi fungsi tambahan melalui modul dan pemalam...

Sebagai projek sumber terbuka yang aktif, FacturaScripts mempunyai komuniti sokongan yang kukuh dan membenarkan pengguna memperluaskan serta mengubah suai fungsi melalui pemalam bagi memenuhi pelbagai keperluan perniagaan.

Ciri dan Kelebihan Utama FacturaScripts ​

  • Sumber terbuka & percuma: Tiada bayaran lesen yang tinggi – bebas digunakan, diubah suai dan diedarkan.
  • Ciri menyeluruh: Merangkumi keperluan teras harian perniagaan kecil/sederhana; penyelesaian serba lengkap.
  • Mudah digunakan: Antara muka mesra pengguna dengan pembelajaran yang singkat.
  • Sangat boleh dikembangkan: Pasaran pemalam yang kaya serta API terbuka membolehkan integrasi dan tambahan ciri baharu dengan mudah.
  • Akses rentas platform: Berasaskan web, boleh diakses melalui mana-mana peranti dengan pelayar moden.
  • Komuniti aktif: Bantuan global daripada komuniti pembangun tersedia bila-bila masa.
  • Sokongan pelbagai bahasa: Antara muka tersedia dalam pelbagai bahasa untuk kemudahan pengguna dari pelbagai wilayah.

Kelebihan Menjalankan FacturaScripts dengan ServBay ​

ServBay ialah persekitaran pembangunan web tempatan direka khas untuk pembangun, menawarkan platform ideal untuk menjalankan aplikasi PHP seperti FacturaScripts. Ia mengintegrasikan semua komponen yang anda perlukan, termasuk pelayan web Apache/Nginx, pelbagai versi PHP, pangkalan data MySQL/MariaDB/PostgreSQL dan alat biasa seperti Redis – semua ini diuruskan melalui antara muka grafik yang mesra pengguna.

Kelebihan dan langkah utama menjalankan FacturaScripts secara tempatan di ServBay termasuk:

  • Persekitaran bersepadu: Semua komponen utama yang diperlukan bagi FacturaScripts (pelayan web, PHP, pangkalan data) telah dipasang dan dikonfigurasi siap dalam ServBay, menjimatkan masa tanpa perlu pemasangan manual setiap perisian berasingan.
  • Pengurusan versi: Tukar versi PHP dengan mudah untuk memenuhi keperluan versi FacturaScripts, atau menjalankan ujian keserasian.
  • Pengurusan pangkalan data: Alat bawaan seperti phpMyAdmin atau Adminer untuk penciptaan dan pengurusan pangkalan data serta pengguna FacturaScripts.
  • Konfigurasi laman yang mudah: Bina laman tempatan dengan pantas melalui GUI ServBay, lengkap dengan tetapan domain, root folder, pelayan web dan versi PHP.
  • Pengurusan auto fail hosts: ServBay menguruskan fail hosts secara automatik, membolehkan anda mengakses laman tempatan melalui domain tersuai (contoh: facturascripts.servbay.demo) tanpa kerja tambahan.
  • Sokongan SSL: Konfigurasi SSL/HTTPS dengan mudah menggunakan User CA dalaman atau ACME awam – mensimulasikan persekitaran produksi sebenar.

Langkah utama menjalankan FacturaScripts di ServBay adalah:

  1. Muat turun kod sumber FacturaScripts.
  2. Cipta direktori projek di bawah root laman ServBay.
  3. Cipta pangkalan data dan pengguna MySQL yang diperlukan.
  4. Konfigurasi pelayan web Apache atau Nginx di ServBay dan arahkan ke direktori projek.
  5. Semak serta aktifkan extension PHP yang diperlukan.
  6. Layari domain tempatan dan lengkapkan wizard pemasangan FacturaScripts dalam pelayar.

Prasyarat ​

Sebelum mula, pastikan anda telah memenuhi syarat berikut:

  • Telah memuat turun, memasang dan menjalankan ServBay di macOS. Dapatkan versi terbaharu dari Laman Rasmi ServBay.
  • Pakej teras dalam ServBay (pelayan web Apache atau Nginx, versi PHP yang dirancang, serta MySQL atau MariaDB) telah dimulakan serta berjalan lancar.
  • Mempunyai asas pengetahuan pembangunan web dan konsep asas pangkalan data.

Cipta Projek FacturaScripts (Berdasarkan Muat Turun Pakej Zip) ​

Ini antara cara paling mudah dan lazim untuk memasang FacturaScripts dalam persekitaran tempatan.

  1. Muat turun FacturaScripts:

  2. Cipta direktori projek:

    • Buka Finder, navigasi ke direktori root laman web tempatan dalam ServBay, yang disyorkan terletak di /Applications/ServBay/www/.
    • Di dalam direktori itu, cipta satu folder baharu untuk projek FacturaScripts anda, contohnya bernama facturascripts_project.
    • Contoh laluan penuh projek: /Applications/ServBay/www/facturascripts_project

  3. Ekstrak fail:

    • Cari fail .zip FacturaScripts yang telah dimuat turun, klik dua kali untuk ekstrak.
    • Salin atau pindahkan SEMUA fail dan folder hasil ekstrak (contohnya: index.php, Core, Dinamic, Plugins dan lain-lain) ke folder /Applications/ServBay/www/facturascripts_project yang baru anda cipta.

Konfigurasi Awal (Konfigurasi Pangkalan Data MySQL, dll.) ​

FacturaScripts memerlukan satu pangkalan data untuk menyimpan semua data perniagaan, pengguna, konfigurasi dan lain-lain. Di sini kita akan menggunakan MySQL atau MariaDB yang diuruskan oleh ServBay. ServBay sepenuhnya menyokong kedua-dua MySQL dan MariaDB.

  1. Pastikan pakej MySQL/MariaDB sedang berjalan:

    • Buka aplikasi ServBay.
    • Dalam menu kiri, pilih “Pakej” > “MySQL” atau “MariaDB” (ikut jenis pangkalan data yang dikehendaki).
    • Pastikan pakej pangkalan data pilihan anda sudah dimulakan. Jika belum, klik butang suis sebelahnya untuk mulakan.

  2. Cipta pangkalan data dan pengguna:

    • Anda boleh menggunakan alat pengurusan ServBay (seperti phpMyAdmin yang biasanya disertakan bersama MySQL/MariaDB) atau alat baris perintah (terminal) disediakan oleh ServBay. phpMyAdmin umumnya lebih mudah untuk pemula.
    • Menggunakan phpMyAdmin (Disyorkan):
      • Dalam antara muka ServBay, tumpukan pada bahagian “Pangkalan Data”. Cari dan klik ikon phpMyAdmin di baris pakej MySQL/MariaDB. Satu tetingkap pelayar baharu akan terbuka dengan halaman log masuk phpMyAdmin.
      • Log masuk ke phpMyAdmin. Secara lalai, pengguna boleh gunakan root dengan kata laluan yang anda tetapkan semasa pemasangan awal ServBay. Jika terlupa, anda boleh reset melalui halaman butiran pakej pangkalan data dalam ServBay.
      • Sebaik log masuk, pilih tab “Pangkalan Data” di atas.
      • Pada ruangan “Cipta Pangkalan Data”, masukkan nama yang berkaitan projek, cth. facturascripts_servbay_db.
      • Pilih set aksara dan collate – disyorkan utf8mb4_general_ci atau utf8mb4_unicode_ci agar menyokong pelbagai karakter dan emoji.
      • Klik “Cipta”.
      • Cipta pengguna pangkalan data (Pilihan tetapi Disyorkan): Untuk keselamatan, elakkan gunakan pengguna root. Cipta satu pengguna khusus untuk FacturaScripts.
        • Kembali ke laman utama phpMyAdmin, klik tab “Akaun Pengguna”.
        • Klik “Tambah akaun pengguna”.
        • Masukkan nama pengguna (contoh: facturascripts_servbay_user).
        • Hos = localhost atau 127.0.0.1.
        • Jana kata laluan yang kukuh dan pastikan anda CATAT kata laluan ini di tempat selamat.
        • Untuk akses, boleh tanda “Cipta pangkalan data dengan nama sama dan berikan semua keistimewaan (GRANT ALL)”, atau pilih akses hanya pada pangkalan data projek tadi (facturascripts_servbay_db).
        • Klik “Laksanakan” untuk simpan.

  3. Catat maklumat sambungan pangkalan data: Anda akan gunakan semasa pemasangan FacturaScripts:

    • Nama pangkalan data (cth. facturascripts_servbay_db)
    • Nama pengguna pangkalan data (cth. facturascripts_servbay_user)
    • Kata laluan pengguna pangkalan data
    • Hos pangkalan data (localhost atau 127.0.0.1)
    • Port pangkalan data (lalai MySQL/MariaDB ialah 3306, sila semak pada senarai pakej ServBay jika berbeza)

Konfigurasi Pelayan Web (Apache atau Nginx) ​

Kini, kita perlu memberitahu ServBay bagaimana pelayan web mengakses projek FacturaScripts anda. ServBay menyokong Apache dan Nginx sepenuhnya.

  1. Pastikan pakej pelayan web berjalan:

    • Dalam halaman “Pakej” ServBay, pastikan Apache atau Nginx sudah dimulakan.

  2. Tambah laman baru:

    • Dari menu kiri ServBay, pilih “Laman” (Site).
    • Klik butang “+” di bahagian atas senarai laman untuk tambah konfigurasi laman baru.
    • Dalam tetingkap konfigurasi isikan:
      • Nama: Contoh: FacturaScripts Demo Site.
      • Domain: Tentukan domain yang diinginkan. Mengikut amalan terbaik ServBay, gunakan akhiran .servbay.demo, contohnya facturascripts.servbay.demo.
      • Jenis laman: Pilih PHP (untuk aplikasi PHP dinamik).
      • Root direktori: Klik “Browse/Pilih” dan arahkan ke folder projek FacturaScripts (/Applications/ServBay/www/facturascripts_project). Nota: Kebanyakan kerangka aplikasi web mesti menunjuk ke subdirektori (cth. public/web), namun FacturaScripts biasanya menunjuk ke direktori projek terus. Sila rujuk dokumentasi rasmi.
      • Versi PHP: Pilih versi PHP yang sesuai dengan FacturaScripts (semak keperluan sistem — biasanya PHP 8.1, 8.2 atau terkini).
      • Tetapan lain: Kebiasaannya boleh dibiarkan lalai. Pilihan SSL/HTTPS, tetapan CORS dan opsyen lanjut disediakan untuk anda konfigurasikan jika perlu.

  3. Simpan konfigurasi & kemas kini hosts:

    • Selesai isi maklumat, klik “Tambah/Simpan”.
    • ServBay akan auto-konfigurasi virtual host/server block pada pelayan web yang dipilih. Ia juga memerlukan keizinan pentadbir untuk edit sistem hosts bagi menghala domain baru ke IP tempatan (127.0.0.1). Dengan ini, anda boleh akses laman tempatan melalui domain pilihan di pelayar tanpa edit fail hosts secara manual.

  4. Periksa dan aktifkan extension PHP diperlukan:

    • FacturaScripts biasanya memerlukan beberapa extension PHP seperti pdo_mysql, gd (pemprosesan imej), intl (antarabangsa), zip, xml, curl dan sebagainya. ServBay secara lalai mengaktifkan kebanyakan extension biasa, namun jika pemasangan FacturaScripts memberi amaran extension hilang, sila aktifkan secara manual.
    • Bagaimana aktifkan extension PHP di ServBay:
      • Pergi ke menu kiri > “Bahasa” (Languages) > “PHP”.
      • Pilih versi PHP yang digunakan oleh laman facturascripts.servbay.demo.
      • Dalam halaman perincian PHP, klik tab “Extension”.
      • Senarai extension yang dipasang & diaktif akan dipaparkan. Jika ada extension yang hilang (contoh: opcache), cari dan tandakan pada kotak semak untuk aktifkan.
      • Klik “Apply/Simpan” di bahagian bawah. Beberapa extension memerlukan perkhidmatan PHP di-restart; anda boleh klik butang restart di skrin PHP yang berkenaan.

Contoh antara muka konfigurasi laman di ServBayContoh antara muka konfigurasi laman di ServBay

Akses Laman & Lengkapkan Pemasangan FacturaScripts ​

Persekitaran anda kini telah sedia untuk menjalankan FacturaScripts. Seterusnya, lengkapkan wizard pemasangan dalam pelayar.

  1. Buka pelayar web: Gunakan pelayar kegemaran anda (Chrome, Firefox, Safari dsb.).

  2. Masukkan alamat domain: Ketik domain tempatan yang telah ditetapkan, contohnya http://facturascripts.servbay.demo. Jika laman dikonfigurasi sebagai laman SSL di ServBay, boleh cuba akses https://facturascripts.servbay.demo. Tekan Enter.

  3. Wizard pemasangan FacturaScripts:

    • Jika semua konfigurasi laman, fail hosts, pelayan web/PHP berjalan dengan baik, paparan selamat datang FacturaScripts atau wizard pemasangan akan dipaparkan di pelayar.
    • Pilih Bahasa: Pilih bahasa antara muka yang diingini.
    • Pemeriksaan Sistem: Wizard akan menyemak versi PHP, extension diperlukan, keizinan fail dsb. Sekiranya konfigurasi ServBay betul, semua indikator akan hijau. Jika ada ralat atau amaran, semak versi PHP, extension terlibat dan keizinan folder projek (/Applications/ServBay/www/facturascripts_project mesti boleh tulis untuk pelayan web).
    • Konfigurasi pangkalan data: Masukkan maklumat yang telah anda cipta:
      • Jenis pangkalan data: Pilih MySQL.
      • Hos: localhost atau 127.0.0.1.
      • Port: 3306 (atau port yang digunakan oleh MySQL/MariaDB dalam ServBay).
      • Nama pangkalan data: facturascripts_servbay_db.
      • Nama pengguna: facturascripts_servbay_user.
      • Kata laluan: Masukkan kata laluan pengguna tersebut.
      • Awalan jadual: Boleh kekal fs_ atau tukar ikut keperluan.
    • Akaun pentadbir: Tetapkan nama pengguna, kata laluan dan e-mel admin. Pastikan pilih kata laluan yang kukuh dan catat maklumat ini kerana ia digunakan untuk akses pentadbiran FacturaScripts.
    • Pemasangan: Selepas semak maklumat, tekan butang Pemasangan. FacturaScripts akan menyambungkan ke pangkalan data, cipta semua jadual dan tulis fail konfigurasi.

  4. Selesai pemasangan:

    • Setelah berjaya, anda mungkin disarankan untuk memadam folder install di root projek. Sila ikut arahan demi tujuan keselamatan.
    • Kini, anda sudah boleh akses paparan log masuk FacturaScripts pada http://facturascripts.servbay.demo (atau HTTPS jika tersedia). Log masuk menggunakan maklumat admin yang baru diset, dan mulakan eksplorasi serta pengurusan perniagaan dengan FacturaScripts!

Soalan Lazim (FAQ) ​

  • S: Wizard pemasangan FacturaScripts memberi amaran extension PHP hilang, apa perlu dilakukan?
    • J: Buka aplikasi ServBay, pada menu kiri pilih “Bahasa” > “PHP”, cari versi PHP laman FacturaScripts anda dan masuk ke tab “Extension”. Cari extension yang diperlukan, tick kotak untuk aktifkan, klik “Simpan” dan restart perkhidmatan PHP tersebut.
  • S: Mengapa dapat ralat “Forbidden” atau paparan kosong bila akses facturascripts.servbay.demo?
    • J: Sila pastikan pelayan web (Apache/Nginx) dan perkhidmatan PHP berjalan dalam ServBay. Seterusnya, semak root direktori laman ServBay telah benar-benar menunjuk ke folder projek FacturaScripts (/Applications/ServBay/www/facturascripts_project). Jika paparan kosong, kemungkinan ralat PHP – semak log ralat pelayan web atau PHP untuk maklumat lanjut. Jika “Forbidden”, semak keizinan fail dan pastikan pelayan web mempunyai akses baca & tulis, terutamanya untuk folder seperti Dinamic.
  • S: Gagal sambungan ke pangkalan data FacturaScripts?
    • J: Sila pastikan MySQL/MariaDB berjalan dalam ServBay serta port yang digunakan betul (3306 lazimnya). Semak maklumat sambungan (hos, port, nama DB, pengguna & kata laluan) di wizard pemasangan sama seperti apa yang anda cipta dalam langkah terdahulu.

Rumusan ​

Dengan persekitaran pembangunan tempatan ServBay yang berkuasa, pemasangan dan menjalankan FacturaScripts di macOS menjadi amat mudah! ServBay menyediakan semua keperluan asas (pelayan web, PHP, pangkalan data) dan antara muka konfigurasi yang intuitif. Ikuti setiap langkah dalam panduan ini untuk membangunkan dan menguji FacturaScripts di persekitaran tempatan anda – membolehkan anda menumpukan perhatian kepada pengurusan perniagaan dan eksplorasi fungsi FacturaScripts sepenuhnya. Fleksibiliti dan kemudahan ServBay akan melipatgandakan kecekapan pembangunan tempatan anda!