在 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
解壓檔案：
- 找到下載好的 FacturaScripts .zip 檔案並雙擊解壓。
- 將解壓所得的所有檔案及資料夾（如 index.php, Core, Dinamic, Plugins 等）全部複製或移動至剛剛新建的 /Applications/ServBay/www/facturascripts_project 資料夾內。

初始化配置（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 設定等功能，請視需求加以設定。
儲存設定並自動更新 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」介面右側點重啟按鈕啟動。

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！

常見問題集 (FAQ)

問：FacturaScripts 安裝過程提示缺少 PHP 擴展怎麼辦？
- 答：於 ServBay 左側點「語言」-「PHP」，選出 FacturaScripts 網站對應的 PHP 版本，切換至「擴展」分頁，找到缺少的擴展（如 opcache），勾選後「套用」並重啟該 PHP 服務。
問：前往 facturascripts.servbay.demo 出現「Forbidden」或空白頁？
- 答：先檢查 ServBay 內 Web 伺服器（Apache/Nginx）與 PHP 是否皆在運作，再確認網站根目錄設定正確指向 FacturaScripts 專案根。如果是空白頁可能有 PHP 執行錯誤，請檢查 Web 伺服器或 PHP 錯誤日誌。若是「Forbidden」多半因檔案/資料夾權限不足，請確認 Web 伺服器用戶有足夠讀寫權限（特別是如 Dinamic 資料夾）。
問：FacturaScripts 資料庫連線失敗？
- 答：檢查 MySQL/MariaDB 軟體包是否已啟動及埠號設定（正常為 3306），再核對安裝精靈內主機（localhost/127.0.0.1）、埠號、資料庫名稱、用戶名、密碼與實際於 ServBay 建立者是否完全一致。

小結

透過 ServBay 這套強大的本地 Web 開發平台，在 macOS 安裝與運行 FacturaScripts 變得前所未有的簡單。ServBay 不僅提供 FacturaScripts 所需之全套依賴元件（Web 伺服器、PHP、資料庫），配置過程更因直覺圖形介面大幅精簡。依本指南步驟操作，即可快速建構 FacturaScripts 的本地開發或測試環境，專注於財務業務管理與功能開發。ServBay 的彈性及高效率，將大大提升您的本地開發體驗。

在 ServBay 上建立並運行 FacturaScripts 專案 ​

FacturaScripts 概述 ​

FacturaScripts 的主要特色與優勢 ​

在 ServBay 運行 FacturaScripts 的優勢 ​

前置條件 ​

建立 FacturaScripts 專案（以下載 Zip 套件為例） ​

初始化配置（MySQL 資料庫設定） ​

配置 Web 伺服器（支援 Apache 或 Nginx） ​

存取網站並完成 FacturaScripts 安裝 ​

常見問題集 (FAQ) ​

小結 ​