在 ServBay 上建立並運行 FacturaScripts 專案
FacturaScripts 是一套功能強大且彈性的開源 ERP(企業資源規劃)及 CRM(客戶關係管理)解決方案,特別適合中小企業與自由工作者。透過 ServBay 所提供的便利本地 Web 開發環境,您可以在 macOS 系統上輕鬆建立、測試與運行 FacturaScripts 專案,無需繁複設定。
本指南將詳細引導您完成如何使用 ServBay 在本機安裝並配置 FacturaScripts 的全流程。
FacturaScripts 概述
FacturaScripts 是一套基於 PHP 與 Bootstrap 框架開發的開源 ERP/CRM 軟體,旨在協助企業管理其核心業務流程,包括:
- 發票開立及管理
- 會計核算
- 庫存控制
- 客戶與供應商管理
- 專案管理
- 以及透過模組和外掛所帶來的更多功能...
作為活躍的開源專案,FacturaScripts 擁有強大的社群支援,並允許用戶藉由外掛擴充與客製化功能,以滿足不同企業的需求。
FacturaScripts 的主要特色與優勢
- 開源免費: 完全免授權費,自由使用、修改與分發。
- 功能全面: 涵蓋中小企業日常運營之多數核心功能,提供一站式解決方案。
- 易於使用: 直觀且友善的操作介面,使用者上手迅速。
- 高度可擴展: 擁有豐富的外掛市集及開放 API,輕鬆增添新功能或與其他服務整合。
- 跨平台存取: 基於 Web 技術,可於任何支援現代瀏覽器的設備上使用。
- 社群活躍: 全球開發者社群能快速提供協助與支援。
- 多語言支援: 提供多國語言介面,適用於不同地區用戶。
在 ServBay 運行 FacturaScripts 的優勢
ServBay 為開發者量身打造的本地 Web 開發環境,是運行 PHP 應用(如 FacturaScripts)的理想平台。它整合所有所需元件,包括 Apache/Nginx Web 伺服器、多版本 PHP、MySQL/MariaDB/PostgreSQL 資料庫以及 Redis 等工具,並以圖形化介面統一管理。
在 ServBay 本地運行 FacturaScripts 的優勢與步驟包括:
- 完整集成環境: ServBay 預裝並配置了 FacturaScripts 所需各項元件(Web 伺服器、PHP、資料庫),免去逐一安裝配置的麻煩。
- 版本管理方便: 輕鬆切換不同 PHP 版本,以符合法定 FacturaScripts 版本需求或進行相容性測試。
- 資料庫管理便利: 內建 phpMyAdmin 或 Adminer 等工具,輕鬆建置與管理 FacturaScripts 所需的資料庫與用戶。
- 簡易網站設定: 透過 ServBay 圖形介面快速建立本地網站,配置網域、根目錄、Web 伺服器及 PHP 版本。
- Hosts 文件自動化管理: ServBay 自動處理本機 Hosts 文件,可自訂如
facturascripts.servbay.demo
的域名直接來訪本地站點。 - SSL 支援: 透過內建使用者 CA 或 ACME 公開憑證機制,為本地網站配置 SSL/HTTPS,以模擬正式環境。
在 ServBay 上運行 FacturaScripts 的主要步驟如下:
- 下載 FacturaScripts 原始碼。
- 在 ServBay 管理的網站根目錄下新建專案資料夾。
- 建立 FacturaScripts 需要的 MySQL 資料庫與用戶。
- 以 ServBay 設定 Web 伺服器(Apache 或 Nginx)對應專案目錄。
- 檢查並啟用必要 PHP 擴充套件。
- 透過瀏覽器進入本地域名,完成 FacturaScripts 線上安裝流程。
前置條件
在開始之前,請確保已滿足下列條件:
- 已於 macOS 上正確下載、安裝並啟動 ServBay。由 ServBay 官方網站 取得最新版。
- ServBay 的核心軟體包(如您選用的 Web 伺服器 Apache/Nginx、目標 PHP 版本及 MySQL 或 MariaDB 資料庫)已於 ServBay 介面啟動並正常執行。
- 具備基礎 Web 開發及資料庫概念。
建立 FacturaScripts 專案(以下載 Zip 套件為例)
這是於本地安裝 FacturaScripts 最簡單且常見的方式之一。
下載 FacturaScripts:
- 前往 FacturaScripts 官方網站下載頁面 https://facturascripts.com/descargar。
- 找到最新穩定版
.zip
套件並下載至 macOS 電腦。
建立專案目錄:
- 開啟 Finder,前往 ServBay 預設本地網站資料夾根目錄。ServBay 建議之預設根目錄為
/Applications/ServBay/www/
。 - 在此資料夾下新建一個專案資料夾,例如命名為
facturascripts_project
。 - 完整專案路徑範例:
/Applications/ServBay/www/facturascripts_project
- 開啟 Finder,前往 ServBay 預設本地網站資料夾根目錄。ServBay 建議之預設根目錄為
解壓檔案:
- 找到下載好的 FacturaScripts
.zip
檔案並雙擊解壓。 - 將解壓所得的所有檔案及資料夾(如
index.php
,Core
,Dinamic
,Plugins
等)全部複製或移動至剛剛新建的/Applications/ServBay/www/facturascripts_project
資料夾內。
- 找到下載好的 FacturaScripts
初始化配置(MySQL 資料庫設定)
FacturaScripts 需以資料庫儲存全部業務資料、用戶、組態設定等。我們將利用 ServBay 管理的 MySQL 或 MariaDB 軟體包來建立資料庫。ServBay 完全支援 MySQL 與 MariaDB。
確保資料庫軟體包正在運行:
- 啟動 ServBay 應用程式。
- 於側邊選單選擇「軟體包」-「MySQL」或「MariaDB」(視您偏好選用哪一類型)。
- 確認選中資料庫已啟動。未執行時請按開關啟動。
新建資料庫與用戶:
- 可運用 ServBay 內建的資料庫管理工具(如 phpMyAdmin,隨 MySQL/MariaDB 附帶)或指令行工具(ServBay 提供的終端機入口)建立資料庫與用戶。初學者建議用 phpMyAdmin 圖形介面操作。
- 推薦:使用 phpMyAdmin 操作
- 於 ServBay 介面尋找「資料庫」部分,點擊當前資料庫(MySQL 或 MariaDB)右側的 phpMyAdmin 圖示。ServBay 將在瀏覽器開啟 phpMyAdmin 登入頁。
- 登入 phpMyAdmin。預設為
root
用戶名,密碼則以您首次啟動 ServBay 時設定者為主。若忘記密碼,ServBay 支援密碼重置,可於資料庫軟體包詳細頁面找到。 - 登入後,點擊頂部「資料庫」分頁。
- 在「新建資料庫」欄位輸入資料庫名稱。建議以專案相關字詞(如
facturascripts_servbay_db
)避免衝突。 - 選擇合適字元集與排序方式,建議
utf8mb4_general_ci
或utf8mb4_unicode_ci
。 - 點擊「建立」按鈕。
- 建立資料庫用戶(可選但強烈建議): 為提升安全性,避免以高權限
root
用戶操作資料庫,建議建立 FacturaScripts 專用用戶。- 在 phpMyAdmin 首頁頂部點「使用者帳號」分頁。
- 點「新增使用者帳號」。
- 輸入用戶名稱(例:
facturascripts_servbay_user
)。 - 主機名稱選擇
localhost
或127.0.0.1
,僅允許本地端連接。 - 產生或設定一組強密碼,並務必妥善保存。
- 下方可選授權:可勾選「建立與使用者同名的資料庫並授與全部權限」(如與資料庫名稱相同),或使用「指定資料庫權限」並在下拉選單選取剛創建的
facturascripts_servbay_db
,勾選「全部」以授與必要權限 (ALL PRIVILEGES
)。 - 點選頁面下方「執行」儲存用戶資料。
記錄資料庫連接資訊: 安裝 FacturaScripts 時需要填寫這些連接資料,請記下以下資訊:
- 資料庫名稱(例:
facturascripts_servbay_db
) - 資料庫用戶(例:
facturascripts_servbay_user
) - 資料庫密碼(註記您剛為
facturascripts_servbay_user
設定者) - 資料庫主機(通常為
localhost
或127.0.0.1
) - 資料庫埠號(MySQL/MariaDB 預設為
3306
,實際運行埠號可於 ServBay 軟體包內查詢)
- 資料庫名稱(例:
配置 Web 伺服器(支援 Apache 或 Nginx)
現在要指定由哪個 Web 伺服器(Apache 或 Nginx)存取您的 FacturaScripts 專案。ServBay 完全支援兩者。
確認 Web 伺服器軟體包已啟動:
- 在 ServBay 的「軟體包」頁確認選定的 Web 伺服器已啟動。
新增網站設定:
- 於 ServBay 側欄點選「網站」。
- 於右側網站列表頂部點擊「+」按鈕,新增一組站點設定。
- 於彈出視窗填寫如下資料:
- 名稱 (Name): 例如
FacturaScripts Demo Site
。 - 網域 (Domain): 輸入預定用於存取 FacturaScripts 的本地網域。建議遵循
.servbay.demo
開發網域慣例,如facturascripts.servbay.demo
。 - 站型 (Website Type): 選擇
PHP
,表明此為 PHP 應用程式。 - 根目錄 (Root Directory): 點「瀏覽」或「選擇」選項,找到剛才建立並放置 FacturaScripts 的目錄(
/Applications/ServBay/www/facturascripts_project
)。注意: 某些框架需指向子目錄(如public
或web
),但 FacturaScripts 預設根目錄即可,請閱官方說明確認是否需另外調整。 - PHP 版本 (PHP Version): 挑選與 FacturaScripts 相容的 PHP 版本。建議選用官方建議的最新版,如 PHP 8.1、8.2 或更高。ServBay 可任意切換多版本 PHP。
- 其他設定: 通常維持預設即可。ServBay 也提供方便的 SSL/HTTPS(ServBay User CA 及 ACME 公開憑證)、CORS 設定等功能,請視需求加以設定。
- 名稱 (Name): 例如
儲存設定並自動更新 Hosts:
- 完成輸入後於視窗底部點「新增」或「儲存」。
- ServBay 會自動配置 Web 伺服器之虛擬主機(Virtual Host)或 Server Block。並且會提示需系統管理員權限以更新
hosts
檔,把本地域名 (facturascripts.servbay.demo
) 指向本機 IP (127.0.0.1
),讓您可以直接訪問這個網域而無需手動編輯 hosts 文件。
檢查並啟用所需 PHP 擴展:
- FacturaScripts 可能需要某些特定 PHP 擴展才能順利運作。常見必需包含
pdo_mysql
、gd
(圖像處理)、intl
(國際化)、zip
(壓縮/解壓)、xml
、curl
(網路存取)等。ServBay 預設安裝啟用多數主流擴展,但若 FacturaScripts 安裝或運行時顯示某擴充缺少,請於 ServBay 啟用。 - 在 ServBay 啟用 PHP 擴展:
- 於左側選單選「語言」-「PHP」。
- 挑選您的網站所用 PHP 版本(例:PHP 8.2)。
- 進入該版本詳情,點選「擴展」分頁。
- 在已安裝/已啟用清單中,找到缺少之擴展(例:
opcache
)並在其右側勾選啟用。 - 點頁底「套用」或「儲存」。部分擴展更動後須重啟 PHP 服務,可於「語言」-「PHP」介面右側點重啟按鈕啟動。
- FacturaScripts 可能需要某些特定 PHP 擴展才能順利運作。常見必需包含
ServBay 網站設定畫面範例
存取網站並完成 FacturaScripts 安裝
您目前設置好的 ServBay 環境已準備好 FacturaScripts,可開始進行線上安裝。
開啟瀏覽器: 使用常用瀏覽器(例:Chrome、Firefox、Safari)。
輸入網址: 於網址列輸入 FacturaScripts 設定好的本地網域,如
http://facturascripts.servbay.demo
。若已於 ServBay 配置 SSL(ServBay CA 或 ACME),可用https://facturascripts.servbay.demo
存取,然後按 Enter。FacturaScripts 安裝精靈:
- 若網站設定、Hosts 及 Web 伺服器/PHP 皆正常,應可直接於瀏覽器見到 FacturaScripts 的歡迎頁或安裝精靈。
- 語言選擇: 首先請選您偏好的介面語言。
- 系統檢查: 安裝程式會自動掃查您的執行環境(PHP 版本、必需擴展、資料夾寫入權限等)是否符合最低需求。若 ServBay 配置正確且擴展齊全,此處應全部為綠色通過,出現紅色錯誤或黃警告請依說明查核 PHP 版本、擴展或專案資料夾(
/Applications/ServBay/www/facturascripts_project
)權限等,確保 Web 伺服器有權限寫入指定目錄。 - 資料庫設定: 關鍵步驟,需填入剛才於 ServBay 建立好並記錄的資料庫參數:
- 資料庫型態: 請選 MySQL。
- 主機: 輸入
localhost
或127.0.0.1
。 - 埠號:
3306
(或以 ServBay 查詢的實際埠號)。 - 資料庫名稱: 輸入您建立的名稱(如
facturascripts_servbay_db
)。 - 用戶名: 輸入建立的資料庫用戶(例
facturascripts_servbay_user
)。 - 密碼: 輸入該用戶設定之密碼。
- 資料表前綴: 可用預設值
fs_
,也可自訂。
- 管理員帳戶: 設定 FacturaScripts 後台的管理員用戶名、密碼與電子郵件。請使用安全強密碼且妥善紀錄,後續登入管理台將以此帳密。
- 開始安裝: 資料無誤後點安裝。FacturaScripts 會自行連接資料庫,建立所有必要資料表以及寫入組態。
安裝完成:
- 完成後,如畫面提示,由於安全考量 FacturaScripts 建議刪除專案根目錄下的
install
資料夾(若仍存在且導覽畫面有提示)。請依照指示進行刪除。 - 現可於
http://facturascripts.servbay.demo
(或 HTTPS)登入 FacturaScripts 首頁,並以新設定之管理員帳密登入,開始體驗 FacturaScripts!
- 完成後,如畫面提示,由於安全考量 FacturaScripts 建議刪除專案根目錄下的
常見問題集 (FAQ)
- 問:FacturaScripts 安裝過程提示缺少 PHP 擴展怎麼辦?
- 答:於 ServBay 左側點「語言」-「PHP」,選出 FacturaScripts 網站對應的 PHP 版本,切換至「擴展」分頁,找到缺少的擴展(如
opcache
),勾選後「套用」並重啟該 PHP 服務。
- 答:於 ServBay 左側點「語言」-「PHP」,選出 FacturaScripts 網站對應的 PHP 版本,切換至「擴展」分頁,找到缺少的擴展(如
- 問:前往
facturascripts.servbay.demo
出現「Forbidden」或空白頁?- 答:先檢查 ServBay 內 Web 伺服器(Apache/Nginx)與 PHP 是否皆在運作,再確認網站根目錄設定正確指向 FacturaScripts 專案根。如果是空白頁可能有 PHP 執行錯誤,請檢查 Web 伺服器或 PHP 錯誤日誌。若是「Forbidden」多半因檔案/資料夾權限不足,請確認 Web 伺服器用戶有足夠讀寫權限(特別是如
Dinamic
資料夾)。
- 答:先檢查 ServBay 內 Web 伺服器(Apache/Nginx)與 PHP 是否皆在運作,再確認網站根目錄設定正確指向 FacturaScripts 專案根。如果是空白頁可能有 PHP 執行錯誤,請檢查 Web 伺服器或 PHP 錯誤日誌。若是「Forbidden」多半因檔案/資料夾權限不足,請確認 Web 伺服器用戶有足夠讀寫權限(特別是如
- 問:FacturaScripts 資料庫連線失敗?
- 答:檢查 MySQL/MariaDB 軟體包是否已啟動及埠號設定(正常為
3306
),再核對安裝精靈內主機(localhost
/127.0.0.1
)、埠號、資料庫名稱、用戶名、密碼與實際於 ServBay 建立者是否完全一致。
- 答:檢查 MySQL/MariaDB 軟體包是否已啟動及埠號設定(正常為
小結
透過 ServBay 這套強大的本地 Web 開發平台,在 macOS 安裝與運行 FacturaScripts 變得前所未有的簡單。ServBay 不僅提供 FacturaScripts 所需之全套依賴元件(Web 伺服器、PHP、資料庫),配置過程更因直覺圖形介面大幅精簡。依本指南步驟操作,即可快速建構 FacturaScripts 的本地開發或測試環境,專注於財務業務管理與功能開發。ServBay 的彈性及高效率,將大大提升您的本地開發體驗。