创建并运行 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 本身的开发和使用。