創建並運行 FacturaScripts 項目

FacturaScripts 是一個強大且靈活的開源 ERP 和 CRM 解決方案，非常適合中小型企業和自由職業者。借助 ServBay 提供的便捷本地開發環境，您可以輕鬆地在本地 macOS 系統上創建、測試和運行 FacturaScripts 項目。

本指南將引導您完成使用 ServBay 安裝和配置 FacturaScripts 的完整過程。

什麼是 FacturaScripts？

FacturaScripts 是一款基於 PHP 和 Bootstrap 框架開發的開源企業資源規劃（ERP）和客戶關係管理（CRM）軟件。它旨在幫助企業管理其核心業務流程，包括：

• 發票開具與管理
• 會計核算
• 库存控制
• 客戶和供應商管理
• 項目管理
• 還有更多...

作為一個開源項目，它擁有活躍的社區支持，並允許用戶通過插件進行功能擴展和定制。

FacturaScripts 的主要特性和優勢

• 開源免費： 無需支付昂貴的許可費用，可以自由使用和修改。
• 功能全面： 涵蓋了中小型企業日常運營所需的大部分核心功能。
• 易於使用： 界面相對直觀，學習曲線平緩。
• 高度可擴展： 擁有豐富的插件市場，可以輕鬆添加新功能或與其他服務集成。
• 跨平台： 基於 Web，可在任何支持現代瀏覽器的設備上訪問。
• 社區活躍： 遇到問題時可以從社區獲得幫助。
• 多語言支持： 支持多種語言，方便不同地區的用戶使用。

使用 ServBay 創建並運行 FacturaScripts 項目

ServBay 為運行 PHP 應用程序（如 FacturaScripts）提供了理想的本地環境。它集成了 Nginx/Apache、多種 PHP 版本、MySQL/MariaDB/PostgreSQL 等常用服務，並提供圖形化界面進行管理。

使用 ServBay 運行 FacturaScripts 的主要步驟包括：

1. 下載 FacturaScripts 源代碼。
2. 在 ServBay 管理的目錄下創建項目文件夾。
3. 創建 FacturaScripts 所需的 MySQL 資料庫和用戶。
4. 通過 ServBay 配置 Apache Web 伺服器指向項目目錄。
5. 通過瀏覽器訪問並完成 FacturaScripts 的安裝向導。

創建 FacturaScripts 項目（基於下載 zip 軟件包）

這是最常見的本地安裝方式之一。

1. 下載 FacturaScripts：

   • 訪問 FacturaScripts 官方網站（https://facturascripts.com/）。
   • 導覽到下載區域，找到最新穩定版的 .zip 軟件包並下載。

2. 創建項目目錄：

   • 打開 Finder，導航到 ServBay 用於存放網站文件的目錄。默認情況我們建議放置在 /Applications/ServBay/www/。
   • 在此目錄下創建一個新的文件夾用於存放 FacturaScripts 項目，例如命名為 facturascripts_project。
   • 完整路徑示例：/Applications/ServBay/www/facturascripts_project

3. 解壓文件：

   • 將下載的 FacturaScripts .zip 文件解壓到剛剛創建的 facturascripts_project 文件夾中。
   • 解壓後，facturascripts_project 文件夾內應包含 index.php, config.php (可能在安裝後生成), Core, Dinamic, Plugins 等文件和目錄。

初始化配置（MySQL 資料庫配置等）

FacturaScripts 需要一個資料庫來存儲所有數據。我們將使用 ServBay 管理的 MySQL 服務。

1. 確保 MySQL 服務運行：

   • 打開 ServBay 應用程序。
   • 在左側選單選擇“服務”-“MySQL”。
   • 確保 MySQL (或 MariaDB) 服務已啟動。如果未啟動，請點擊旁邊的開關按鈕啟動它。

2. 創建資料庫：

   • 您可以使用 ServBay 內置的資料庫管理工具（如 phpMyAdmin）或通過命令行創建資料庫。
   • 使用 phpMyAdmin (推薦):
     • 在 ServBay 界面中，找到“資料庫”-“MySQL”，點擊右上方的 phpMyAdmin。
     • 登錄 phpMyAdmin（通常使用 root 用戶和您在 ServBay 中設置的密碼）。
     • 點擊“資料庫”標籤頁。
     • 在“創建資料庫”字段中，輸入資料庫名稱，例如 facturascripts_db。
     • 選擇合適的字符集，推薦 utf8mb4_general_ci 或 utf8mb4_unicode_ci。
     • 點擊“創建”。
   • 創建資料庫用戶 (可選但推薦): 為了安全起見，建議為 FacturaScripts 創建一個專用的資料庫用戶，而不是使用 root 用戶。
     • 在 phpMyAdmin 中，返回主頁，點擊“用戶賬戶”標籤頁。
     • 點擊“添加用戶賬戶”。
     • 輸入用戶名（例如 facturascripts_user）。
     • 主機名選擇 localhost。
     • 生成或輸入一個強密碼，並務必記下這個密碼。
     • 勾選“創建與用戶同名的資料庫並授予所有權限” 或者 手動轉到“資料庫”部分，為新用戶授予對 facturascripts_db 資料庫的所有權限 (ALL PRIVILEGES)。
     • 點擊頁面底部的“執行”。

3. 記錄資料庫信息： 記下您創建的：

   • 資料庫名稱 (facturascripts_db)
   • 資料庫用戶名 (facturascripts_user)
   • 資料庫用戶密碼 (您設置的密碼)
   • 資料庫主機 (通常是 localhost 或 127.0.0.1)
   • 資料庫端口 (MySQL 默認是 3306，可以在 ServBay 服務列表中確認)

這些信息將在 FacturaScripts 安裝過程中使用。

配置 Web 伺服器（基於 Apache）

現在我們需要告訴 ServBay 如何通過 Apache 服務我們的 FacturaScripts 項目。

1. 確保 Apache 服務運行：

   • 在 ServBay 的“服務”界面，確保 Apache 服務已啟動。

2. 添加主機：

   • 在 ServBay 左側選單選擇“網站”。
   • 點擊右側的“+”按鈕。
   • 在彈出的配置窗口中填寫以下信息：
     • 名稱 (Name): 給這個主機配置起一個描述性名稱，例如 FacturaScripts Demo。
     • 域名 (Domain): 輸入您希望用于訪問本地 FacturaScripts 網站的域名。根據要求，我們使用 facturascripts.demo。
     • 網站類型 (Website Type): 選擇 PHP，表明這是一個動態 PHP 網站。
     • 根目錄 (Root Directory): 點擊“瀏覽”或“選擇”按鈕，導航並選中您之前創建並解壓了 FacturaScripts 文件的目錄 (/Applications/ServBay/www/facturascripts_project)。
     • Web 伺服器 (Web Server): 選擇 Apache 以及您希望使用的 Apache 版本。
     • PHP 版本 (PHP Version): 選擇一個與您下載的 FacturaScripts 版本兼容的 PHP 版本（請查閱 FacturaScripts 的系統要求，通常推薦較新的穩定版本，如 PHP 8.1 或 8.2）。
     • 其他設定: 通常保持默認即可，除非您有特殊需求。

3. 保存配置：

   • 點擊“添加”按鈕。
   • ServBay 會自動配置 Apache 虛擬主機，並可能提示您需要管理員權限來修改系統的 hosts 文件，以便將 facturascripts.demo 指向本地 IP (127.0.0.1)。請允許此操作。

4. 檢查 PHP 擴展：

   • FacturaScripts 可能需要特定的 PHP 擴展才能正常工作（例如 pdo_mysql, gd, intl, zip 等）。
   • 在 ServBay 中，您可以管理已安裝的 PHP 擴展。通常 ServBay 默認安裝的擴展足夠使用，但如果安裝過程中提示缺少擴展，您可以在 ServBay 的 PHP 配置部分啟用它們。

訪問網站

現在，一切準備就緒，可以開始 FacturaScripts 的在線安裝過程了。

1. 打開瀏覽器： 打開您常用的網頁瀏覽器（如 Chrome, Firefox, Safari）。

2. 輸入地址： 在地址欄輸入 https://facturascripts.demo 並按 Enter。

3. FacturaScripts 安裝向導：

   • 如果一切配置正確，您應該會看到 FacturaScripts 的安裝界面。
   • 語言選擇： 選擇您希望使用的語言。
   • 系統檢查： 安裝程序會檢查您的伺服器環境（PHP 版本、必需的擴展、目錄權限等）是否滿足要求。如果 ServBay 配置正確，這裡應該都是綠色的勾。如果出現問題，請根據提示檢查 ServBay 中的 PHP 配置或文件權限。
   • 資料庫配置： 這是關鍵一步。您需要輸入之前創建並記錄下來的資料庫信息：
     • 資料庫類型： 選擇 MySQL。
     • 主機： localhost 或 127.0.0.1。
     • 端口： 3306 (或您在 ServBay 中看到的 MySQL 端口)。
     • 資料庫名稱： facturascripts_db。
     • 用戶名： facturascripts_user。
     • 密碼： 您為 facturascripts_user 設置的密碼。
     • 表前綴： 可以保留默認值 fs_。
   • 管理員帳戶： 設置 FacturaScripts 的管理員用戶名、密碼和電子郵件。請務必記住這些信息，這是您登錄後台的憑據。
   • 安裝： 點擊安裝按鈕，FacturaScripts 會創建資料庫表並寫入配置文件。

4. 安裝完成：

   • 安裝成功後，通常會提示您刪除 install 目錄（如果存在且有提示的話，為了安全）。
   • 您現在應該可以通過 http://facturascripts.demo 訪問您的 FacturaScripts 登錄頁面了。使用您剛剛設置的管理員帳戶登錄，開始探索和使用 FacturaScripts！

---

恭喜！您已成功使用 ServBay 在本地 macOS 環境中創建並運行了一個 FacturaScripts 項目。ServBay 簡化了本地伺服器環境的配置和管理，讓您可以更專注於 FacturaScripts 本身的開發和使用。