部署 WHMCS 8.5 系统

环境：Ubuntu 20.04

准备工作

安装依赖

apt update -y && apt install unzip apache2 mariadb-server sendmail php php-curl php-xml php-gd php-mysql -y

上传资料

首先到官网下载资料包，并上传到需要部署的服务器。

unzip whmcs_v851_full.zip
mv whmcs/configuration.php.new whmcs/configuration.php
mkdir -p /data/www/default/
mv whmcs /data/www/default/
mv /var/www/html /data/www/default/

权限设置

chown -R www-data:www-data /data/www/default
chmod 755 /data/www/default/whmcs
chmod 444 /data/www/default/whmcs/configuration.php

访问设置

编辑/etc/apache2/apache2.conf配置文件

授权 Web 目录

<Directory /data/www/default>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
</Directory>

启用.htaccess

<Directory />
        Options FollowSymLinks
        AllowOverride All
        Require all denied
</Directory>
AccessFileName .htaccess

禁用/vendor访问

<Directory /data/www/default/whmcs/vendor>
        AllowOverride All
        Require all denied
</Directory>

配置 MariaDB

空密码进入数据库后

mysql> create database whmcs;
mysql> grant all privileges on whmcs.* to "whmcs"@"localhost" identified by "123456" with grant option;
mysql> flush privileges;

安装 ionCube

若没有安装，访问安装页面时会出现如下错误提示：

wget http://downloads3.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
tar xzf ioncube_loaders_lin_x86-64.tar.gz -C /usr/local

PHP 配置 ionCube Loader

find / -name "php.ini"

/etc/php/7.4/apache2/php.ini
/etc/php/7.4/cli/php.ini

在上述找到的配置文件中，均添加如下配置

zend_extension = /usr/local/ioncube/ioncube_loader_lin_7.4.so
date.timezone = Asia/Hong_Kong

/usr/local/ioncube/ioncube_loader_lin_xxx.so，xxx 的内容需要根据你当前安装的 PHP 版本进行填写。

开始安装

浏览器访问http://your_external_ip/whmcs/install/install.php

经过上述准备工作之后，这里的依赖检测基本都能通过。

填入授权码和数据库信息。

设置后台管理员账户。

安装成功后需要删除whmcs目录下的install目录，否则访问主页会提示：

添加定时任务

编辑/etc/cron.d/php文件，添加一条定时任务。

*/5   *     * * *     root   /usr/bin/php -q /data/www/default/whmcs/crons/cron.php

绑定域名访问

如果在注册WHMCS账号并购买授权码的时候，绑定的是域名，则访问后台管理页面时，必须通过该域名才能访问。若授权码绑定的是 IP ，也需要将其绑定到ServerName上才能通过该 IP 进行访问。

后台管理页面入口：http://your_domain/admin

编辑/etc/apache2/sites-available/default.conf配置文件

<VirtualHost *:80>
        ServerName your_domain
        ServerAdmin admin@livejq.top

        DocumentRoot /data/www/default/whmcs
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
<VirtualHost *:80>
        ServerName your_external_ip
        ServerAdmin guest@livejq.top

        DocumentRoot /data/www/default/html
</VirtualHost>

检查配置

apache2ctl configtest

使上述配置生效

a2ensite default.conf

使用a2ensite或a2dissite命令，使站点配置生效或失效。

至此，安装配置已全部完成。现在，你可以在域名解析上添加一条 A 记录，即可通过域名来访问WHMCS站点了。