如何在FreeBSD 11 FAMP VPS上安装ProcessWire CMS 3.0

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

ProcessWire CMS 3.0是一个简单，灵活，功能强大，免费和开源的内容管理系统（CMS）。ProcessWire CMS 3.0具有易于使用的jQuery风格的API，完全模块化的插件架构以及灵活而强大的模板系统，可为设计人员，开发人员和最终用户提供同样令人满意的用户体验。

在本教程中，我们将使用Apache Web服务器，PHP 7.1和M​​ariaDB数据库在FreeBSD 11 FAMP VPS上安装ProcessWire CMS 3.0。

先决条件

• 具有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 Web服务器

安装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

现在，我们需要Directory在同一配置文件中编辑Apache指令，以便可以mod_rewrite与ProcessWire CMS一起正常使用。

找到配置文件中以开头的部分，<Directory "/usr/local/www/apache24/data">然后更改AllowOverride none为AllowOverride All。最终结果（除去所有注释）将如下所示：

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

现在保存并退出Apache配置文件。

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

sudo service apache24 restart

步骤4：安装PHP 7.1

现在，我们可以安装PHP 7.1以及ProcessWire 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 php71-openssl php71-zip

FreeBSD 11使我们可以选择使用开发php.ini或产品php.ini。由于我们将在公共Web服务器上安装Siverstripe，因此将使用生产版本。首先，备份php.ini-production：

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

然后软链接php.ini-production到php.ini。

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

我们需要将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用户时，选择“是”（代表“是”），然后输入安全root密码。只需对其他所有是/否问题回答“是”，因为默认建议是最安全的选择。

步骤6：为ProcessWire CMS创建数据库

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

sudo mysql -u root -p

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

运行以下查询为ProcessWire CMS创建MariaDB数据库和数据库用户：

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

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

步骤7：安装ProcessWire CMS文件

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

cd /usr/local/www/apache24/data

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

pwd

现在用于wget下载ProcessWire CMS安装软件包：

sudo wget https://github.com/processwire/processwire/archive/master.zip

请注意： 您一定应该通过访问ProcessWire CMS下载页面来检查最新版本。

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

ls -la

移除index.html：

sudo rm index.html

现在解压缩zip存档：

sudo unzip master.zip

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

sudo mv processwire-master/* /usr/local/www/apache24/data

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

sudo chown -R www:www * ./

再次重新启动Apache：

sudo service apache24 restart

步骤8：完成ProcessWire CMS安装

现在是时候在浏览器中访问服务器实例的IP地址了，或者如果您已经配置了Vultr DNS设置（并且有足够的时间来传播），则可以直接访问您的域。

要访问ProcessWire CMS安装页面，请在浏览器地址栏中输入您的Vultr实例IP地址，然后输入index.php：

http://YOUR_VULTR_IP_ADDRESS/install.php

ProcessWire CMS安装程序包含许多选项，因此这里有一些指针可以帮助您：

1. 在ProcessWire CMS安装欢迎页面上，单击Get Started按钮以开始安装过程。

2. 现在，选择您的首选安装配置文件（或演示站点），然后单击Continue。

3. 您将看到一个Compatibility Check页面。如果看到任何错误，则可能意味着您缺少某些PHP模块或权限问题，否则，只需单击即可Continue。

4. 在MySQL Database Settings页面中输入以下值：

   DB Name:            pw_db
   DB User:            pw_user
   DB Pass:            UltraSecurePassword
   DB Host:            localhost
   DB Port:            3306
   

5. 您可以将File Permission设置保留为默认值，也可以在理解含义后进行调整。

6. 您可以在适当的部分中输入站点的将来主机名，也可以site/config.php稍后根据需要编辑文件。

7. 单击Continue以配置数据库并安装ProcessWire CMS文件。

8. 接下来，选择您的首选Admin Theme。

9. 您可以根据需要更改Admin URL，也可以将其保留为默认值。

10. 输入您的信息Admin Login Details，如下所示：

    User (a-z 0-9):     <admin username>
    Password:           <admin password>
    Password (again):   <same admin password>
    Email Address:      <admin email address>
    

11. 输入所有适当的详细信息后，您可以单击Continue以完成ProcessWire安装。

12. 安装完成后，只需单击Login to Admin按钮以登录“管理”部分。

您可能会看到一条警告，内容如下：

Warning: your server locale is undefined and may cause issues. Please add this to /site/config.php file (adjust en_US.UTF-8†as needed): setlocale(LC_ALL,'en_US.UTF-8');

您可以通过编辑site/config.php文件来解决此错误：

sudo vi site/config.php

将适当的值附加到文件末尾：

setlocale(LC_ALL,'en_GB.utf8');

如果您不知道要使用什么值，可以通过运行以下locale命令为特定服务器实例找到适当值的列表：

locale -a

site/config.php完成编辑后，不要忘记保存并退出文件。

为了安全起见，请确保更改site/config.php文件的权限：

sudo chmod 400 site/config.php

重新启动Apache。

sudo service apache24 restart

您准备开始添加内容并配置网站的外观。确保您查看了出色的ProcessWire CMS文档，以获取有关如何构建和配置站点的更多信息。