在 ServBay 环境中安装和配置 OctoberCMS

概述

OctoberCMS 是一个基于强大的 Laravel 框架构建的开源内容管理系统（CMS），以其简洁、灵活和开发者友好的特性而受到青睐。本篇文档旨在指导您如何在 ServBay——一个为 macOS 设计的一站式本地 Web 开发环境——中成功安装和配置 OctoberCMS，以便您可以快速开始基于 OctoberCMS 的项目开发。

什么是 OctoberCMS？

OctoberCMS 提供了一个直观的后台界面和强大的前端开发能力，允许开发者使用熟悉的 Laravel 概念（如 Eloquent ORM, Blade 模板引擎等）来构建各种类型的网站，从简单的博客到复杂的企业应用。

前提条件

在开始安装 OctoberCMS 之前，请确保您满足以下条件：

您的 macOS 系统上已安装并运行 ServBay。
ServBay 中已启用并运行 PHP (推荐 7.4 或更高版本) 和 MySQL/MariaDB 软件包。
ServBay 中已启用 Composer 软件包。
具备基本的命令行操作知识。

安装 OctoberCMS 的步骤

以下是在 ServBay 环境中安装和配置 OctoberCMS 的详细步骤：

步骤 1：创建项目目录

首先，导航到 ServBay 建议的网站根目录 /Applications/ServBay/www，并在此创建一个新的目录用于您的 OctoberCMS 项目。

bash

cd /Applications/ServBay/www
mkdir servbay-octobercms-app
cd servbay-octobercms-app

步骤 2：使用 Composer 安装 OctoberCMS

ServBay 已经自带并配置好了 Composer，确保您在 ServBay 控制面板中启用了 Composer 软件包。现在，在您刚创建的项目目录中运行 Composer 命令来下载和安装 OctoberCMS 的核心文件：

bash

composer create-project october/october .

这个命令会从 OctoberCMS 官方仓库下载最新版本的 OctoberCMS 到当前目录 (.)。

步骤 3：创建数据库和用户

OctoberCMS 需要一个数据库来存储内容、用户、配置等信息。我们将使用 ServBay 自带的 phpMyAdmin 工具来创建数据库和相应的用户。

访问 ServBay 自带的 phpMyAdmin 数据库管理工具
打开浏览器，访问 ServBay 的本地开发面板 https://servbay.host/。点击或导航至 ServBay 提供的 phpMyAdmin 链接，通常是 https://servbay.host/phpmyadmin/，进入 phpMyAdmin 数据库管理工具。
创建数据库用户
为了安全和隔离，建议为每个应用创建独立的数据库用户和数据库。
1. 进入用户账户页面
  在 phpMyAdmin 的主页面，点击顶部菜单中的「用户账户」。
2. 添加新用户
  点击「添加用户账户」。填写以下信息：
  - 用户名：输入一个用于 OctoberCMS 连接数据库的用户名，例如 october_user。
  - 主机名：选择 localhost 或 127.0.0.1，这表示该用户只能从本地连接数据库，增强安全性。
  - 密码：输入一个安全、独特的密码。请勿在生产环境中使用示例密码 password123。
  - 重新输入：再次输入您设置的密码。
  - 在「数据库为用户创建」部分，选择「创建与用户名同名的数据库并授予所有权限」。这会自动创建一个名为 october_user 的数据库，并将所有权限授予给 october_user 用户。
  - 确保勾选了「全局权限」下的「授予所有权限」（如果上一步已勾选创建同名数据库并授权，这一步通常会自动完成或不需要额外操作）。
  - 点击页面底部的「执行」按钮完成用户和数据库的创建。

步骤 4：配置 Web 服务器 (在 ServBay 中添加网站)

为了通过浏览器访问您的 OctoberCMS 应用，您需要在 ServBay 中配置一个本地网站。

添加新网站
打开 ServBay 控制面板，点击左侧导航栏的「网站」（注意：旧版本可能显示为「主机」）标签。点击「添加网站」按钮。
填写以下信息：
- 名字：给这个网站一个易于识别的名称，例如 My OctoberCMS Site。
- 域名：输入您希望在本地访问的域名，例如 servbay-octobercms.local。请使用 .local 后缀以避免与真实域名冲突。
- 网站类型：选择 PHP。
- PHP 版本：选择您希望 OctoberCMS 使用的 PHP 版本，确保与您在 ServBay 中启用的版本一致且满足 OctoberCMS 的版本要求。
- 网站根目录：点击浏览按钮，选择您在步骤 1 中创建的项目目录 /Applications/ServBay/www/servbay-octobercms-app。
保存配置并重启 ServBay
填写完毕后，点击保存按钮。ServBay 会提示您应用更改，通常需要重启相关的软件包（如 Caddy 或 Nginx）以及 ServBay 本身。请按照提示操作，确保更改生效。ServBay 会自动将 servbay-octobercms.local 这个域名解析到本地 (127.0.0.1)。

步骤 5：配置 OctoberCMS 环境变量

OctoberCMS（基于 Laravel）使用 .env 文件来管理应用程序的环境变量，包括数据库连接信息、应用密钥等。

复制环境配置文件示例
在您的 OctoberCMS 项目根目录 (/Applications/ServBay/www/servbay-octobercms-app) 中，复制 .env.example 文件并重命名为 .env：
bash
```
cd /Applications/ServBay/www/servbay-octobercms-app
cp .env.example .env
```
1
2

编辑 .env 文件

使用您喜欢的文本编辑器打开新创建的 .env 文件。找到数据库相关的配置项，并根据您在步骤 3 中创建的数据库信息进行修改：

ini

# ... 其他配置项 ...

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=october_user  # 替换为您创建的数据库名
DB_USERNAME=october_user  # 替换为您创建的数据库用户名
DB_PASSWORD=password123   # 替换为您设置的数据库密码

# ... 其他配置项 ...

重要： 请务必将 DB_DATABASE, DB_USERNAME, 和 DB_PASSWORD 的值替换为您在步骤 3 中实际使用的信息。

步骤 6：运行 OctoberCMS 安装程序

OctoberCMS 提供了一个基于 Web 的安装向导来完成最后的设置，包括数据库迁移和创建管理员账户。

访问安装页面
打开浏览器，访问您在步骤 4 中配置的本地域名，并加上 /install.php 路径。例如：
https://servbay-octobercms.local/install.php
您应该会看到 OctoberCMS 的安装向导页面。
填写数据库信息
安装向导会要求您填写数据库连接信息。请填写您在 .env 文件中配置的相同信息：
- 数据库类型：MySQL
- 数据库主机：localhost 或 127.0.0.1
- 数据库名：october_user
- 数据库用户名：october_user
- 数据库密码：password123
（再次强调，请使用您实际设置的密码）
填写管理员信息
继续按照页面提示，填写您希望用于登录 OctoberCMS 后台的管理员账户信息，包括用户名、密码、邮箱等。
完成安装
点击安装向导页面上的「安装」或相应的按钮。安装程序将执行数据库迁移、生成应用密钥等操作。等待安装过程完成。

步骤 7：安装插件和主题 (可选)

安装完成后，您可以登录到 OctoberCMS 管理后台 (https://servbay-octobercms.local/backend)。

安装插件
在管理后台，导航到「系统」 -> 「更新」 -> 「插件」选项。您可以搜索并安装 OctoberCMS Marketplace 上提供的各种插件来扩展功能。
安装主题
导航到「系统」 -> 「更新」 -> 「主题」选项。您可以浏览并安装适合您项目需求的主题。

安装后的基本配置与使用

成功安装 OctoberCMS 后，您可以开始构建您的网站了。以下是一些常见的初步操作：

访问前台: 访问您的本地域名 https://servbay-octobercms.local/ 即可看到网站的前台页面（通常是默认主题）。
访问后台: 访问 https://servbay-octobercms.local/backend，使用您在安装过程中创建的管理员账户登录。
创建页面: 在后台导航到「CMS」->「页面」来创建和编辑网站页面。
创建内容块: 在后台导航到「CMS」->「内容」来创建可重用的内容片段。
配置主题: 在「CMS」->「主题」下可以配置当前使用的主题设置、布局、部分等。
用户和权限: 在「系统」->「管理」下管理后台用户和他们的权限。

常见问题 (FAQ)

问：访问 servbay-octobercms.local 显示 ServBay 默认页面或错误？
- 答：请检查 ServBay 控制面板中是否已成功添加 servbay-octobercms.local 网站，并且网站根目录是否正确指向 /Applications/ServBay/www/servbay-octobercms-app。确保在添加或修改网站配置后，ServBay 已成功重启应用了更改。检查 ServBay 运行状态，确保 Caddy/Nginx 和 PHP 软件包正在运行。
问：访问 https://servbay-octobercms.local/install.php 出现空白页或错误？
- 答：这通常是 PHP 错误。请检查 ServBay 控制面板中 PHP 的错误日志，查找具体的错误信息。常见原因包括：文件权限问题（确保 storage、themes、plugins 目录及其子目录对 Web 服务器用户可写）、PHP 版本不兼容、扩展缺失等。
问：安装过程中出现数据库连接错误？
- 答：仔细检查 .env 文件中的数据库连接信息 (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) 是否与您在 phpMyAdmin 中创建的用户和数据库信息完全一致。确保 ServBay 中 MySQL/MariaDB 软件包正在运行。
问：运行 composer create-project 命令失败？
- 答：确保您在 ServBay 控制面板中启用了 Composer 软件包，并且 PHP 软件包也已启用且版本正确。检查您的网络连接，Composer 需要下载文件。

总结

通过 ServBay 提供的便捷环境，您可以在 macOS 上轻松快速地安装和配置 OctoberCMS。遵循本指南的步骤，您可以为您的下一个 Web 项目搭建一个功能强大、开发者友好的本地开发平台。现在，您可以开始探索 OctoberCMS 的丰富功能，构建令人惊叹的网站了！

在 ServBay 环境中安装和配置 OctoberCMS ​

概述 ​

什么是 OctoberCMS？ ​

前提条件 ​

安装 OctoberCMS 的步骤 ​

步骤 1：创建项目目录 ​

步骤 2：使用 Composer 安装 OctoberCMS ​

步骤 3：创建数据库和用户 ​

步骤 4：配置 Web 服务器 (在 ServBay 中添加网站) ​

步骤 5：配置 OctoberCMS 环境变量 ​

步骤 6：运行 OctoberCMS 安装程序 ​

步骤 7：安装插件和主题 (可选) ​

安装后的基本配置与使用 ​

常见问题 (FAQ) ​

总结 ​