喺命令行安裝

除咗其他方法之外,你亦可以喺命令行安裝同升級 WHMCS。當你需要為多個安裝配置 WHMCS 時,呢個方法會好有用。要使用呢種安裝方法,你首先需要下載所需版本嘅 WHMCS .zip 檔案並解壓縮。

  • 我哋只建議熟悉 WHMCS、數據庫管理同命令行嘅進階用戶使用呢個方法。
  • 設定同數據庫問題可能會令你無法使用呢個方法。使用呢個方法前,請務必建立檔案同數據庫備份。

喺命令行安裝 WHMCS #

1. 購買授權同下載 WHMCS。 #

要使用WHMCS,你需要購買一個授權,可以直接從WHMCS或者經銷商處購買。然後,你需要下載軟件。

如果你直接向 WHMCS 購買授權金鑰:

  1. 前往WHMCS下載頁面
  2. 點擊完整發佈版下面嘅下載按鈕,下載最新版本。

Downloading the latest Full Release version for WHMCS

如果你係透過經銷商取得授權金鑰,而且冇我哋會員區嘅登入資料,你可以向經銷商索取最新嘅 WHMCS 檔案。

想了解更多關於我哋點樣分發WHMCS嘅資訊,請參閱WHMCS分發方式

2. 確認系統要求。 #

必須確保你嘅設置符合你所選擇嘅WHMCS版本嘅系統要求

  務必要檢查:

  • 操作系統同網頁伺服器配置。
  • PHP 版本、配置同擴展。
  •   MySQL®版本。
  • ionCube Loader®版本

3. 將檔案上傳到你嘅伺服器。

你需要解壓下載嘅發佈文件,然後將佢上傳到將會託管 WHMCS 嘅伺服器。你可以手動進行呢個步驟,或者使用你嘅託管控制面板嘅文件管理工具。

  使用 cPanel #

要使用 cPanel 上傳同解壓文件:

  1. 登入將會託管你 WHMCS 安裝嘅 cPanel 帳戶。
  2. 進入檔案管理器界面(檔案 » 檔案管理器)。
  3. 雙擊public_html目錄。
  4. 點擊上傳
  5. 選擇下載嘅ZIP檔案,然後點擊選擇檔案
  6. 上傳完成後,點擊返回。你會喺public_html目錄中見到新上傳嘅.zip檔案。
  7. 右鍵點擊.zip檔案,然後選擇解壓
  8. 選擇目的地,然後點擊解壓檔案

  手動上傳 #

要用其他上傳方法做呢樣嘢:

  1. 喺你嘅本地電腦上解壓下載嘅WHMCS ZIP檔案
  2. 將整個解壓後嘅whmcs文件夾上傳到你嘅網站。如果遇到問題,嘗試以二進制模式上傳文件夾。

你可以選擇將文件夾改名(例如billing)。

由於管理區域默認使用admin文件夾,所以唔可以用admin作為安裝文件夾嘅名稱。

4. 建立設定檔。 #

你可以選擇手動建立你嘅 configuration.php 檔案,或者喺安裝過程中使用 -c 或 --config 選項嚟建立設定檔。

如果你想用 -c 或 --config 選項,就跳過呢一步,同埋提供所需嘅設定資料當你執行安裝指令嗰陣。

要手動建立設定檔,請喺 WHMCS 主目錄度建立 configuration.php 檔案,並加入所需嘅變數。

你嘅檔案應該類似下面嘅例子:

<?php
$license = "";
$db_host = "localhost";
$db_username = "";
$db_password = "";
$db_name = "";
$cc_encryption_hash = "";
$templates_compiledir = "templates_c/";
  • 要確定你需要嘅值,請聯絡你嘅主機供應商或系統管理員。
  • 想知更多關於 configuration.php 檔案內容嘅資料,請睇設定檔 configuration.php

4. 執行安裝指令。

安裝腳本使用以下語法:

php -f bin/installer.php –- [options]

個腳本預設會啟用非互動模式(-n 或 --non-interactive)並執行升級(-u 或 --upgrade)。

你可以用以下選項配合安裝腳本:

  選項   描述
-c 或 --config 以 JSON 格式提供配置數據(睇下面「提供配置數據」部分)。要同 -n 或 --non-interactive 選項一齊用。
-h 或 --help   查看幫助信息。
-i 或 --install 進行新安裝。
-n 或 --non-interactive 執行腳本時唔需要用戶輸入。
-s 或 --status 提供有關安裝檔案同數據庫嘅狀態資訊。
-u 或 --upgrade 升級現有安裝。
-v 或 --verbose 以詳細輸出模式運行腳本。

提供配置數據 #

如果你使用 -c 或 --config 選項,你必須以單行 JSON 輸入形式向 STDIN 提供配置數據。

你可以提供以下數組的數據:

  數組   描述
admin 初始管理員帳戶的帳戶信息數組。

  • 使用 username 和 password 參數設置自定義用戶名和密碼組合。
  • 如果你冇提供想要嘅用戶名同密碼,系統會自動生成並喺安裝結束時顯示出嚟。
configuration 指定想要嘅配置文件變量,創建一個新配置文件,好似下面例子咁。

  • 當你嘅輸入包含配置元素時,系統會創建一個configuration.php文件。
  • 如果你提供咗配置元素但係已經存在configuration.php文件,就會出現錯誤。
  • 如果你嘅輸入唔包含配置元素,安裝過程需要有一個有效嘅configuration.php檔案存在。
喺命令行提供敏感資料時要小心謹慎。

  例子 #

當你使用配置元素時,你嘅 JSON 數據可能會似以下例子咁樣:

#!/bin/env bash
# The following assumes the respective environment variables are
populated
CONF='{
 "admin":{
  "username":"name",
  "password":"'$ADMIN_PASS'"
 },
 "configuration":{
  "license": "'$LICENSE_KEY'",
  "db_host": "'$DB_HOST'",
  "db_username": "'$DB_USER'",
  "db_password": "'$DB_PASS'",
  "db_name": "'$DB_NAME'",
  "cc_encryption_hash": "'$ENCRYPT_HASH'",
  "mysql_charset": "utf8"
 }
}'

然後你可以用以下指令提供呢啲資料:

echo $(echo $CONF | tr -d "\n") | php -f bin/installer.php -- -i -n -c

加密哈希值必須係64個字符長,而且只可以包含azAZ同埋09嘅ASCII值。請用高熵值隨機數據源或者密碼生成工具嚟產生呢個值。例如:

# Example hash value generation with the OpenSSL utility
ENCRYPT_HASH=$(openssl rand -base64 128|tr -d "\n\/+="|cut -c 1-64)

  下一步 #

完成安裝之後,我哋建議你按照以下順序配置WHMCS:

  1. 睇吓我哋推薦嘅額外步驟,加強你安裝嘅安全性
  2. 登入WHMCS管理區域,完成入門精靈入門精靈可以讓你快速配置以下設定:
  3. 設定你安裝嘅其餘一般設定
  4. 設定你嘅支付網關
  5. 設定你嘅銷售產品
  6. 設定你嘅支援票務部門
  7. 設定電郵管道電郵導入嚟管理支援票務嘅電郵回覆。
  8. 創建同配置WHMCS 定時任務同佢嘅自動化任務設定
  9. 喺你嘅網站度下啲測試訂單