ServBay

简体中文

English
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

简体中文

English
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

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

概述 ​

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

什么是 OctoberCMS？ ​

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

前提条件 ​

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

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

安装 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 工具来创建数据库和相应的用户。

  1. 访问 ServBay 自带的 phpMyAdmin 数据库管理工具

    打开浏览器，访问 ServBay 的本地开发面板 https://servbay.host/。点击或导航至 ServBay 提供的 phpMyAdmin 链接，通常是 https://servbay.host/phpmyadmin/，进入 phpMyAdmin 数据库管理工具。

  2. 创建数据库用户

    为了安全和隔离，建议为每个应用创建独立的数据库用户和数据库。

    1. 进入用户账户页面

      在 phpMyAdmin 的主页面，点击顶部菜单中的「用户账户」。

    2. 添加新用户

      点击「添加用户账户」。填写以下信息：

      • 用户名：输入一个用于 OctoberCMS 连接数据库的用户名，例如 october_user。
      • 主机名：选择 localhost 或 127.0.0.1，这表示该用户只能从本地连接数据库，增强安全性。
      • 密码：输入一个安全、独特的密码。请勿在生产环境中使用示例密码 password123。
      • 重新输入：再次输入您设置的密码。
      • 在「数据库为用户创建」部分，选择「创建与用户名同名的数据库并授予所有权限」。这会自动创建一个名为 october_user 的数据库，并将所有权限授予给 october_user 用户。
      • 确保勾选了「全局权限」下的「授予所有权限」（如果上一步已勾选创建同名数据库并授权，这一步通常会自动完成或不需要额外操作）。
      • 点击页面底部的「执行」按钮完成用户和数据库的创建。

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

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

  1. 添加新网站

    打开 ServBay 控制面板，点击左侧导航栏的「网站」（注意：旧版本可能显示为「主机」）标签。点击「添加网站」按钮。

    填写以下信息：

    • 名字：给这个网站一个易于识别的名称，例如 My OctoberCMS Site。
    • 域名：输入您希望在本地访问的域名，例如 servbay-octobercms.local。请使用 .local 后缀以避免与真实域名冲突。
    • 网站类型：选择 PHP。
    • PHP 版本：选择您希望 OctoberCMS 使用的 PHP 版本，确保与您在 ServBay 中启用的版本一致且满足 OctoberCMS 的版本要求。
    • 网站根目录：点击浏览按钮，选择您在步骤 1 中创建的项目目录 /Applications/ServBay/www/servbay-octobercms-app。

  2. 保存配置并重启 ServBay

    填写完毕后，点击保存按钮。ServBay 会提示您应用更改，通常需要重启相关的软件包（如 Caddy 或 Nginx）以及 ServBay 本身。请按照提示操作，确保更改生效。ServBay 会自动将 servbay-octobercms.local 这个域名解析到本地 (127.0.0.1)。

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

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

  1. 复制环境配置文件示例

    在您的 OctoberCMS 项目根目录 (/Applications/ServBay/www/servbay-octobercms-app) 中，复制 .env.example 文件并重命名为 .env：

    bash
    cd /Applications/ServBay/www/servbay-octobercms-app
cp .env.example .env

  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 的安装向导来完成最后的设置，包括数据库迁移和创建管理员账户。

  1. 访问安装页面

    打开浏览器，访问您在步骤 4 中配置的本地域名，并加上 /install.php 路径。例如：

    https://servbay-octobercms.local/install.php

    您应该会看到 OctoberCMS 的安装向导页面。

  2. 填写数据库信息

    安装向导会要求您填写数据库连接信息。请填写您在 .env 文件中配置的相同信息：

    • 数据库类型：MySQL
    • 数据库主机：localhost 或 127.0.0.1
    • 数据库名：october_user
    • 数据库用户名：october_user
    • 数据库密码：password123

    （再次强调，请使用您实际设置的密码）

  3. 填写管理员信息

    继续按照页面提示，填写您希望用于登录 OctoberCMS 后台的管理员账户信息，包括用户名、密码、邮箱等。

  4. 完成安装

    点击安装向导页面上的「安装」或相应的按钮。安装程序将执行数据库迁移、生成应用密钥等操作。等待安装过程完成。

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

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

  1. 安装插件

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

  2. 安装主题

    导航到「系统」 -> 「更新」 -> 「主题」选项。您可以浏览并安装适合您项目需求的主题。

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

成功安装 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 的丰富功能，构建令人惊叹的网站了！