在 ServBay 本地环境中安装和配置 ExpressionEngine CMS
概述
ExpressionEngine 是一款功能强大且灵活的内容管理系统(CMS),被广泛用于构建各种复杂类型的网站和 Web 应用。它提供了丰富的核心功能和高度模块化的架构,允许开发者和设计师灵活地创建和定制网站。
ServBay 则是一个专为 macOS 设计的本地 Web 开发环境,提供了一站式的解决方案,集成了多种流行的 Web 服务器(如 Nginx, Caddy, Apache)、编程语言运行时(PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET)、数据库(MySQL, PostgreSQL, MongoDB, Redis)以及开发者工具(Composer, npm/yarn, phpMyAdmin/Adminer)。利用 ServBay,开发者可以轻松搭建和管理本地开发环境。
本文将详细介绍如何在 ServBay 环境中安装和配置 ExpressionEngine,帮助您快速启动 ExpressionEngine 项目。
为什么选择 ServBay 安装 ExpressionEngine?
使用 ServBay 在本地安装 ExpressionEngine 有以下优势:
- 环境集成: ServBay 集成了 ExpressionEngine 所需的 PHP 运行时、MySQL 数据库以及 Web 服务器,无需单独安装和配置。
- 多版本支持: 您可以根据 ExpressionEngine 的版本要求,在 ServBay 中轻松切换或选择不同的 PHP 版本。
- 便捷的数据库管理: ServBay 内置 phpMyAdmin 或 Adminer,方便您创建和管理 ExpressionEngine 所需的数据库。
- 简单的网站配置: 通过 ServBay 的图形界面,可以快速创建和配置指向 ExpressionEngine 项目目录的本地网站。
- 隔离与管理: ServBay 允许您为每个项目创建独立的网站配置,避免不同项目之间的环境冲突。
前提条件
在开始安装之前,请确保满足以下条件:
- 您的 macOS 系统上已安装并运行 ServBay。如果您尚未安装 ServBay,请访问 ServBay 官方网站 获取安装指南。
- 对终端命令行操作有基本了解。
- 对数据库概念(如数据库、用户)有基本了解。
- ServBay 的默认网站根目录
/Applications/ServBay/www
具有写入权限。
安装步骤
我们将按照以下步骤在 ServBay 环境中安装和配置 ExpressionEngine。
步骤 1:准备项目目录并下载 ExpressionEngine
首先,打开您的终端应用程序。导航到 ServBay 的默认网站根目录 /Applications/ServBay/www
,并创建一个新的项目目录(例如 servbay-ee-app
),然后进入该目录。
bash
cd /Applications/ServBay/www
mkdir servbay-ee-app
cd servbay-ee-app
1
2
3
2
3
接下来,使用 curl
命令下载最新版本的 ExpressionEngine 到当前目录。-L
参数用于跟随重定向,-o
参数用于指定输出文件名。
bash
curl -L https://expressionengine.com/latest -o expressionengine.zip
1
步骤 2:解压 ExpressionEngine 文件
下载完成后,使用 unzip
命令将下载的 expressionengine.zip
文件解压到当前的 servbay-ee-app
目录中。解压完成后,您可以删除下载的压缩包。
bash
unzip expressionengine.zip
rm expressionengine.zip
1
2
2
解压后,ExpressionEngine 的文件结构将出现在 servbay-ee-app
目录内。
步骤 3:创建 ExpressionEngine 数据库及用户
ExpressionEngine 需要一个数据库来存储其内容和配置信息。ServBay 内置了 MySQL 和 phpMyAdmin,方便您进行数据库管理。
访问 ServBay 自带的数据库管理工具 phpMyAdmin
打开您的 Web 浏览器,访问 ServBay 的本地工具入口地址:
https://servbay.host/
。在页面中找到并点击「phpMyAdmin」链接,这将打开 phpMyAdmin 登录页面。使用 ServBay 默认的数据库用户名和密码(通常在 ServBay 的数据库配置中有说明,默认安装通常无需密码即可访问localhost
)。创建数据库用户和数据库
登录 phpMyAdmin 后,我们将创建一个专门用于 ExpressionEngine 的数据库用户和一个同名数据库。
- 进入用户账户页面: 在 phpMyAdmin 的主页面,点击顶部导航菜单中的「用户账户」。
- 添加新用户: 点击「添加用户账户」。
- 填写用户和数据库信息:
- 用户名: 输入一个用于 ExpressionEngine 数据库连接的用户名,例如
ee_user
。 - 主机名: 选择
localhost
。这表示该用户只能从本地连接到数据库,增强安全性。 - 密码: 输入一个安全的密码,用于 ExpressionEngine 连接数据库。请记住这个密码。例如,可以使用
password123
作为演示,但在生产环境请务必使用强密码。 - 重新输入: 再次输入密码以确认。
- 数据库为用户创建: 勾选「创建与用户名同名的数据库并授予所有权限」。这将自动创建一个名为
ee_user
的数据库,并将所有权限授予刚刚创建的ee_user
用户。
- 用户名: 输入一个用于 ExpressionEngine 数据库连接的用户名,例如
- 确认权限: 确保「全局权限」部分没有勾选不必要的权限(因为我们已经通过“创建与用户名同名的数据库并授予所有权限”赋予了足够的数据库级别权限)。
- 执行: 点击页面底部的「执行」按钮完成用户和数据库的创建。
您现在已经创建了一个名为
ee_user
的数据库,以及一个同名的数据库用户ee_user
,该用户拥有对ee_user
数据库的全部权限。
步骤 4:在 ServBay 中配置网站
现在,我们需要告诉 ServBay 如何处理对特定域名(例如 servbay-ee.local
)的请求,并将它们指向 ExpressionEngine 项目目录。
打开 ServBay 并添加新网站
打开 ServBay 应用程序的图形界面。在左侧导航栏中,点击「网站」。然后点击界面上方的「+」按钮或「添加」按钮来添加一个新的网站配置。
- 名字 (Name): 给您的网站配置起一个易于识别的名字,例如
My ExpressionEngine Site
。 - 域名 (Domain): 输入您希望在本地访问 ExpressionEngine 网站的域名,例如
servbay-ee.local
。ServBay 会自动将这个域名添加到您的 hosts 文件,使其指向本地(127.0.0.1)。 - 网站类型 (Type): 选择
PHP
,因为 ExpressionEngine 是基于 PHP 开发的。 - PHP 版本 (PHP Version): 根据您下载的 ExpressionEngine 版本要求,选择一个兼容的 PHP 版本。ServBay 支持多种 PHP 版本,您可以根据需要选择。
- 网站根目录 (Document Root): 点击浏览按钮,选择您在步骤 1 中创建的 ExpressionEngine 项目目录,即
/Applications/ServBay/www/servbay-ee-app
。 - Web 服务器 (Web Server): 您可以选择 ServBay 支持的任何 Web 服务器,如 Nginx, Caddy, 或 Apache。ServBay 会自动为您生成相应的服务器配置文件。对于大多数本地开发场景,默认选项即可。
- 名字 (Name): 给您的网站配置起一个易于识别的名字,例如
保存并应用配置
填写完所有信息后,点击「保存」或「应用」按钮。ServBay 可能需要重启其 Web 服务器来加载新的配置。按照提示操作,等待 ServBay 重启完成。
现在,当您在浏览器中访问
https://servbay-ee.local/
时,ServBay 会将请求路由到您的 ExpressionEngine 项目目录。
步骤 5:运行 ExpressionEngine Web 安装程序
ExpressionEngine 提供了一个基于 Web 的安装程序,引导您完成最终的配置。
访问安装页面
打开您的 Web 浏览器,访问您在 ServBay 中配置的域名,并加上 ExpressionEngine 的安装程序入口文件
admin.php
。默认情况下,安装程序位于/admin.php
。访问地址:
https://servbay-ee.local/admin.php
您应该会看到 ExpressionEngine 的欢迎页面或安装向导。
按照向导进行配置
ExpressionEngine 安装向导会要求您填写以下关键信息:
- 数据库连接信息:
- 数据库主机 (Database Host):
localhost
- 数据库名 (Database Name):
ee_user
(与您在步骤 3 中创建的数据库名相同) - 数据库用户名 (Database Username):
ee_user
(与您在步骤 3 中创建的数据库用户名相同) - 数据库密码 (Database Password): 输入您在步骤 3 中为
ee_user
用户设置的密码。
- 数据库主机 (Database Host):
- 管理员账户信息: 创建 ExpressionEngine 后台的超级管理员账户,包括用户名、密码和电子邮件地址。请务必使用一个安全的密码。
- 站点配置: 填写站点名称、URL 等基本信息。
- 数据库连接信息:
完成安装
仔细检查您填写的信息,然后点击安装向导中的「安装」或相应的完成按钮。ExpressionEngine 会创建所需的数据库表并完成初始化设置。
安装完成后,您通常会被重定向到登录页面或后台仪表盘。
步骤 6:完成安装后的基础配置
安装 ExpressionEngine 核心完成后,您可以根据需要安装插件、模板或进行其他基础配置。
登录 ExpressionEngine 后台
使用您在安装过程中创建的管理员账户登录到 ExpressionEngine 的管理后台。通常可以通过访问
https://servbay-ee.local/admin.php
并输入用户名和密码来登录。安装插件
在 ExpressionEngine 管理后台中,导航到「开发者 (Developer)」->「插件 (Add-Ons)」->「插件 (Plugins)」。您可以浏览可用的插件,并根据您的项目需求进行安装。
安装和配置模板
导航到「设计 (Design)」->「模板 (Templates)」。您可以在这里创建模板组、模板,并编写用于呈现网站内容的 HTML/CSS/EE 代码。
使用 ExpressionEngine 构建您的网站
现在您已经成功在 ServBay 环境中安装和配置了 ExpressionEngine。您可以开始使用它来构建和管理您的网站内容。以下是一些常见的起始操作:
创建频道和条目
ExpressionEngine 的核心是“频道”和“条目”。频道定义了内容的类型和结构,而条目则是具体的内容实例。
- 创建频道: 在 ExpressionEngine 管理后台,导航到「内容结构 (Content Structure)」->「频道管理 (Channels)」。点击「创建新频道 (Create New Channel)」,填写频道名称、字段组(Fields Group)等设置,然后点击「保存频道 (Save Channel)」。
- 创建条目: 导航到「内容 (Content)」->「发布 (Publish)」。选择您刚才创建的频道,填写条目标题、内容(根据频道定义的字段)和其他信息,然后点击「保存 (Save)」。
配置导航菜单
导航菜单通常是通过模板来实现的。
- 创建或编辑模板: 在「设计 (Design)」->「模板 (Templates)」中,找到或创建一个用于网站导航的模板(例如在一个名为
site
的模板组中创建一个nav
模板)。 - 编写导航代码: 在模板中使用 ExpressionEngine 的模板标签来查询频道条目或页面,并生成 HTML 导航结构。
- 将导航包含到布局中: 在您的主要页面布局模板中,使用
{% include 'site:nav' %}
(如果使用 Blade 模板引擎) 或其他相应的标签来包含导航模板。
自定义小工具(Widgets/Sidebars)
类似于导航,侧边栏或其他“小工具”区域通常也是通过创建特定的模板来实现的。
- 创建小工具模板: 在「设计 (Design)」->「模板 (Templates)」中,创建用于显示小工具内容的模板(例如
site:sidebar
)。 - 编写小工具代码: 在模板中编写代码以显示最新条目、分类列表、广告等内容。
- 将小工具包含到布局中: 在您的页面布局模板中,将小工具模板包含到需要显示的位置。
常见问题 (FAQ)
- 问:访问
https://servbay-ee.local/
提示权限错误怎么办?- 答:请检查您的 ExpressionEngine 项目目录 (
/Applications/ServBay/www/servbay-ee-app
) 及其子目录和文件的权限。确保 ServBay 运行的用户(通常是您的当前用户)对这些文件有读写权限。您可能需要使用chmod
或chown
命令调整权限,例如sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app
。
- 答:请检查您的 ExpressionEngine 项目目录 (
- 问:ExpressionEngine 安装向导提示无法连接数据库?
- 答:请仔细检查您在安装向导中填写的数据库连接信息(数据库主机
localhost
、数据库名、用户名、密码)是否与您在 phpMyAdmin 中创建的信息完全一致。同时,确保 ServBay 中的 MySQL/MariaDB 服务正在运行。
- 答:请仔细检查您在安装向导中填写的数据库连接信息(数据库主机
- 问:我可以使用 ServBay 的其他数据库(如 PostgreSQL)吗?
- 答:ExpressionEngine 主要支持 MySQL/MariaDB。如果 ExpressionEngine 官方支持 PostgreSQL 并且您有相应的数据库驱动和配置方法,理论上 ServBay 提供的 PostgreSQL 服务也可以使用,但这需要 ExpressionEngine 本身的兼容性支持。请查阅 ExpressionEngine 的官方文档了解其支持的数据库类型。
总结
通过遵循本指南的步骤,您应该已经成功地在 ServBay 本地开发环境中安装和配置了 ExpressionEngine CMS。ServBay 为 ExpressionEngine 的本地开发提供了一个便捷高效的环境,集成了所有必需的组件。现在您可以开始利用 ExpressionEngine 强大的功能来构建您的网站或 Web 应用程序了。祝您开发顺利!