如何在FreeBSD 11 FAMP VPS上安装MODX Revolution

• 先决条件
• 步骤1：添加Sudo用户
• 步骤2：更新FreeBSD 11系统
• 步骤3：安装Apache
• 步骤4：安装PHP 7.1
• 步骤5：安装MariaDB（MySQL）
• 步骤6：创建用于MODX Revolution的数据库
• 步骤7：安装MODX Revolution文件
• 步骤8：完成MODX Revolution安装

MODX Revolution是一个用PHP编写的快速，灵活，可扩展的开源企业级内容管理系统（CMS）。它具有高级的多语言功能，并且使用安全的设计原则从头开始构建，因此特别适合于构建高端站点。

先决条件

• 具有SSH访问权限的干净Vultr FreeBSD 11服务器实例。

步骤1：添加Sudo用户

我们将从添加新sudo用户开始。

首先，以身份登录服务器root。

ssh root@YOUR_VULTR_IP_ADDRESS

sudo默认情况下，该命令未安装在Vultr FreeBSD 11服务器实例中，因此我们将首先安装sudo。

pkg install sudo

现在，添加一个新用户user1（或您的首选用户名）。

adduser user1

该adduser命令将提示您输入有关该用户帐户的许多详细信息，因此只需在有意义的情况下为大多数用户选择默认值即可。当询问是否选择时Invite user1 into any other groups?，应输入wheel添加user1到wheel组。

现在检查/etc/sudoers文件以确保sudoers已启用该组。

visudo

寻找这样的部分。

# %wheel        ALL=(ALL)       ALL

此行告诉我们，作为wheel组成员的用户可以使用该sudo命令来获取root特权。默认情况下，它将被注释掉，因此您需要取消注释，然后保存并退出文件。

我们可以user1使用以下groups命令验证组成员身份。

groups user1

如果user1不是该wheel组的成员，则可以使用此命令来更新user1组成员身份。

pw group mod wheel -m user1

现在，使用su命令切换到新的sudo用户user1帐户。

su - user1

命令提示符将更新以指示您现在已经登录到该user1帐户。您可以使用whoami命令进行验证。

whoami

现在重新启动sshd服务，以便您可以ssh使用刚刚创建的新的非root用户sudo用户帐户登录。

sudo /etc/rc.d/sshd restart

退出user1帐户。

exit

退出root帐户（这将断开您的ssh会话）。

exit

现在，您可以ssh使用新的非root用户sudo用户user1帐户从本地主机进入服务器实例。

ssh user1@YOUR_VULTR_IP_ADDRESS

如果要执行sudo而不必每次都输入密码/etc/sudoers，请使用再次打开文件visudo。

sudo visudo

编辑wheel组的部分，使其看起来像这样。

%wheel        ALL=(ALL)       NOPASSWD: ALL

请注意： 不建议对sudo用户禁用密码要求，但此操作已包括在此处，因为它可以使服务器配置更加方便且避免烦恼，尤其是在较长的系统管理会话期间。如果您担心安全隐患，则可以在完成管理任务后始终将配置更改还原为原始更改。

每当您root要从用户帐户中登录该sudo用户帐户时，都可以使用以下命令之一。

sudo -i
sudo su -

您可以随时退出root帐户并返回您的sudo用户帐户。

exit

步骤2：更新FreeBSD 11系统

在FreeBSD服务器实例上安装任何软件包之前，我们将首先更新系统。

确保您使用非root用户sudo登录到服务器并运行以下命令。

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

步骤3：安装Apache

安装Apache 2.4 Web服务器。

sudo pkg install apache24

y出现提示时输入“ ”。

现在，使用sysrc命令启用Apache服务，使其在引导时自动执行。

sudo sysrc apache24_enable=yes

该sysrc命令更新/etc/rc.conf配置文件；因此，如果您想手动验证配置更新，只需/etc/rc.conf使用您喜欢的终端编辑器打开文件即可。

vi /etc/rc.conf

现在启动Apache服务。

sudo service apache24 start

您可以通过在浏览器中访问服务器实例的IP地址或域来快速检查apache是​​否正在运行。

http://YOUR_VULTR_IP_ADDRESS/

您应该看到默认的FreeBSD Apache页面显示文本。

It works!

检查您的Apache默认配置文件，以确保该DocumentRoot指令指向正确的目录。

sudo vi /usr/local/etc/apache24/httpd.conf 

在DocumentRoot配置选项应该是这样的。

DocumentRoot "/usr/local/www/apache24/data"

现在，我们需要启用mod_rewriteApache模块。为此，我们可以在默认的Apache配置文件中搜索术语mod_rewrite。

默认情况下，mod_rewriteApache模块将被注释掉（这意味着它被禁用了）。干净的Vultr FreeBSD 11实例上的配置行将如下所示。

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

只需删除哈希符号即可取消注释该行并加载模块。当然，这也适用于任何其他必需的Apache模块。

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

我们将在本教程结束时重新启动Apache，但是在安装和配置过程中定期重新启动Apache当然是一个好习惯，所以现在就开始吧。

sudo service apache24 restart

步骤4：安装PHP 7.1

现在，我们可以安装最新版本的PHP以及MODX Revolution CMS所需的所有必需的PHP模块。

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib

我们需要将Apache配置为实际使用PHP，因此让我们php.conf在Apache Includes目录目录中创建一个新文件。

sudo vi /usr/local/etc/apache24/Includes/php.conf

在新创建的文件中输入以下文本。

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

保存文件。

现在，让我们再次重新启动Apache。

sudo service apache24 restart

步骤5：安装MariaDB（MySQL）

FreeBSD 11默认使用MariaDB，它是MySQL服务器的增强的，完全开源的，社区开发的直接替代产品。

安装最新版本的MariaDB。

sudo pkg install mariadb102-server mariadb102-client

启动并启用MariaDB，使其在引导时自动执行。

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

保护您的MariaDB服务器安装。

sudo mysql_secure_installation

当提示您创建MariaDB / MySQL root用户时，选择“ Y”（代表“是”），然后输入安全root密码。只需回答Y其他所有“是/否”问题即可，因为默认建议是最安全的选择。

步骤6：创建用于MODX Revolution的数据库

root通过运行以下命令，以MariaDB 用户身份登录MariaDB Shell 。

sudo mysql -u root -p

要访问MariaDB命令提示符，只需root在出现提示时输入MySQL 密码即可。

运行以下查询为MODX Revolution创建MySQL数据库和数据库用户。

CREATE DATABASE modx_data CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'modx_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON modx_data.* TO 'modx_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

如果愿意，您可以根据自己的喜好替换数据库名称modx_data和用户名modx_user。另外，请确保将“ UltraSecurePassword” 替换为实际安全的密码。

步骤7：安装MODX Revolution文件

将当前工作目录更改为默认的Web目录。

cd /usr/local/www/apache24/data

您当前的工作目录现在应该是：/usr/local/www/apache24/data。您可以使用pwd（打印工作目录）命令进行检查。

pwd

现在用于wget下载MODX Revolution安装zip软件包。

sudo wget https://modx.com/download/direct?id=modx-2.6.0-pl.zip

请注意： 您绝对应该通过访问MODX Revolution下载页面检查最新版本。

列出当前目录以检查是否已成功下载文件。

ls -la

让我们给包起一个简单的名字。

sudo mv direct\?id\=modx-2.6.0-pl.zip modx.zip

现在解压缩zip包。

sudo unzip modx.zip

将所有安装文件移至Web根目录。

sudo mv modx-2.6.0-pl/* /usr/local/www/apache24/data

更改Web文件的所有权，以避免任何权限问题。

sudo chown -R www:www *

再次重新启动Apache。

sudo service apache24 restart

现在，我们可以继续进行最后一步了。

步骤8：完成MODX Revolution安装

现在该在浏览器中访问FreeBSD 11服务器实例的IP地址了。或者，如果您已经配置了Vultr DNS设置（并为其提供了足够的传播时间），则只需访问您的域即可。

要访问MODX Revolution安装页面，请输入您的Vultr实例IP地址，然后/setup在浏览器地址栏中输入。

http://YOUR_VULTR_IP_ADDRESS/setup

大多数安装选项都是自解释性的，但是这里有一些指示可以帮助您。

选择你的语言。

单击Next按钮继续安装。

选择New Installation文件夹权限并将其保留为默认值。Next当您准备好进行下一步时，单击。

设置以下数据库选项。

Database type:          mysql
Database host:          localhost
Database login name:    modx_user (or your previously selected name)
Database password:      UltraSecurePassword (or your previously chosen password)
Database name:          modx_data (or your previously selected name)
Table prefix:           modx_

输入上面的数据库选项后，单击下面的链接Test database server connection and view collations。您会看到一条消息，内容为：Connecting to database server: Success!。如果遇到任何错误，请返回并确保所有数据库选项均正确。

您可以将字符集和排序规则选项保留为默认值。他们应该看起来像这样。

Connection character set:   utf8
Collation:                  utf8_general_ci

当您对所选的安装选项感到满意时，可以单击以下链接到Create or test selection of your database。

系统将提示您输入管理员详细信息，该详细信息将用于登录CMS。如下所示填写它们，然后单击确定Next。

Administrator name:         <your_prefered_admin_name>
Administrator email:        <your_admin_email>
Administrator password:     <a_secure_password
Confirm password:           <the_same_secure_password>

您将看到一个安装摘要。只要一切正常，您只需单击Install即可将MODX Revolution安装到您的服务器实例。

您会看到一个确认页面，显示Core installation was successful。只需单击Next以继续。

现在，您可以使用之前在安装过程中输入的登录详细信息登录到MODX Revolution管理面板。

请注意： 在安装和登录期间，您可能会看到一些有关目录和文件的警告消息。只需按照警告页面上显示的说明进行操作，警告消息就会消失。

如果您尚未设置Vultr DNS，那么下一步可能应该是。

现在，您可以开始添加内容并开始配置网站的外观。请务必查看出色的MODX Revolution文档，以获取有关如何构建和配置网站的更多指南。