系統需求

WHMCS 兼容大多數使用 PHP 同 MySQL® 嘅網頁伺服器環境。不過，喺安裝或更新 WHMCS 之前，您必須確保您嘅設定符合所選版本嘅系統要求。例如，要從 WHMCS 8.11 升級到 WHMCS 8.13，您必須確保您嘅系統符合 WHMCS 8.12 嘅所有系統要求。

如果想使用自動更新工具，請確保符合我哋嘅自動更新工具要求。

仔細閱讀每個版本嘅發佈說明。錯誤嘅依賴項升級順序可能會導致嚴重問題。

請務必檢查您嘅自訂模組喺 Marketplace 嘅列表，佢哋可能會有額外要求。

有關更新 WHMCS 版本嘅更多資訊，請參閱更新 WHMCS 同透過 EOL 版本更新。

有關我哋開發同分發每個 WHMCS 版本嘅方式，請參閱 WHMCS 開發 同 WHMCS 分發。

支援版本

我哋目前支援以下 WHMCS 版本：

WHMCS 版本 當前級別 發佈說明 預計終止支援日期

WHMCS 8.13 正式發佈 8.13 發佈說明 2026-05-31

WHMCS 8.12 長期支援 8.12 發佈說明 2026-01-31

WHMCS 8.11 長期支援 8.11 發佈說明 2025-09-30

這些版本處於我哋開發週期嘅活躍開發階段。所有之前嘅版本已達終止支援 (EOL)，無論任何原因，我哋都唔再維護或為其發佈更新。如果您目前使用 EOL 版本嘅 WHMCS，建議盡快更新到支援版本。

有關從舊嘅終止支援 (EOL) 版本更新嘅系統要求，請參閱透過 EOL 版本更新。

系統要求

要成功運行當前支援嘅 WHMCS 版本，您嘅系統必須符合以下要求：

必需	推薦

操作系統 Linux® N/A

Apache® 網頁伺服器 Apache 2.x N/A

Apache 擴展 N/A mod_rewrite

Apache 處理器

(了解更多) 任何虛擬主機或伺服器範圍處理器。 N/A

PHP 版本

(了解更多) PHP 7.2、7.3、7.4、8.1、8.2 或 8.3

最低 ionCube Loader® 版本 10.2.0 或更高 (PHP 7.2)

10.3.1 或更高 (PHP 7.3)

10.4.3 或更高 (PHP 7.4)

12.0.1 或更高 (PHP 8.1)

13.0.2 或更高 (PHP 8.2)

14.4.0 或更高 (PHP 8.3) N/A

PHP 擴展

(了解更多)

所有預設編譯嘅擴展。

cURL 7.36 或更高，帶 SSL

GD2 圖像庫

IMAP

ionCube Loader

更多資訊，請參閱安裝 ionCube Loader。

JSON

PDO

PDO_MySQL

您必須使用 mysqlnd 編譯 PDO_MySQL。唔好使用 libmysqlclient 編譯。

Reflection

XML

BC Math

Fileinfo

GMP

iconv

Intl

mbstring

OpenSSL 1.0.1c 或更高 (帶 TLS 1.2 或更高)

SOAP

PHP 記憶體限制 64 MB 128 MB

MySQL 版本

(了解更多) 5.2 8.x

強烈建議使用上述所有軟件同擴展嘅最新穩定版本。

記憶體同磁碟空間要求會根據安裝規模同活動水平而有所不同。

以上資訊僅包含當前支援版本嘅要求。有關從舊嘅終止支援 (EOL) 版本更新嘅系統要求，請參閱透過 EOL 版本更新。

系統環境

WHMCS 專為傳統嘅 LAMP (Linux、Apache、MySQL、PHP) 環境設計，使用標準 Linux 文件系統同 cron 子系統。我哋驗證 WHMCS 喺基於 Linux 嘅環境中運行 Apache 網頁伺服器。其他環境（例如基於 Windows® 嘅配置）會遇到 WHMCS 技術支援唔支援嘅兼容性問題。

部分 WHMCS 安裝成功使用 NGINX® 代替 Apache，但我哋只能為這些系統提供有限協助。

如果必須使用非支援嘅 LAMP 環境，請諮詢您嘅主機供應商或系統管理員，評估您嘅系統可行性同長期需求。

Apache 處理器

您可以選擇使用虛擬主機處理器或伺服器範圍處理器。

虛擬主機處理器（例如 suPHP 或 mod_ruid2）根據域名以特定用戶身份執行 PHP 進程。

伺服器範圍處理器（例如 CGI 或 mod_php）以相同用戶身份執行所有 PHP 代碼。

選擇 PHP 處理器時，請確保伺服器上冇其他應用程式會以同 WHMCS 相同嘅用戶身份執行。

Apache 指令

WHMCS 使用 .htaccess 文件控制對 WHMCS 文件嘅訪問並增強用戶體驗。

許多流行嘅控制面板（例如 cPanel & WHM 同 Plesk）會自動配置 WHMCS 運行所需嘅 Apache 指令。如果使用自訂 Apache 配置，請確保 AllowOverride、AuthConfig 同 Limit 配置指令處於活動狀態。

此外，WHMCS 喺您嘅 WHMCS 安裝中使用以下 .htaccess 文件中嘅配置指令：

.htaccess 文件包含 mod_rewrite 指令，將可路由路徑發送到 index.php 文件。這使內部路由系統能夠運行並創建友好 URL。

vendor/.htaccess 文件防止直接從 vendor 目錄提供文件，同時允許 WHMCS 訪問其庫。

如需配置非支援嘅 NGINX 系統嘅幫助，請參閱限制 NGINX 目錄訪問。

MySQL 數據庫

WHMCS 需要 MySQL 以成功運行數據庫操作。不過，二進制兼容嘅替代方案（例如 MariaDB®）也可能適用於某些安裝。

WHMCS 唔支援 MySQL® 嚴格模式。喺 MySQL 配置中啟用 STRICT_TRANS_TABLES 或 ERROR_FOR_DIVISION_BY_ZERO 可能會導致 WHMCS 出現嚴重問題。建議喺安裝時禁用這些模式以避免後期數據庫錯誤。相關步驟，請參閱禁用 MySQL 嚴格模式。

WHMCS 內部使用 PDO 數據庫 API。建議第三方開發人員使用 WHMCS API 與數據庫交互。更多資訊，請參閱與數據庫交互。

數據庫權限

安裝過程中，WHMCS 需要以下數據庫權限：

ALTER DROP LOCK TABLES

CREATE INDEX SELECT

DELETE INSERT UPDATE

日常操作中，您可以通過移除 ALTER、CREATE、DROP 同 INDEX 權限來限制 WHMCS 嘅數據庫。WHMCS 僅喺安裝、更新同激活或停用模組時需要這些權限。

加密數據庫連接

支援加密 MySQL 連接使用 configuration.php 文件中嘅以下配置變量。您可以使用以下變量：

db_tls_ca — CA .pem 文件嘅路徑（例如 /var/www/html/whmcs/ca.pem）。

db_tls_ca_path — 包含 CA 證書文件嘅目錄路徑。

db_tls_cert — 客戶端證書嘅路徑。

db_tls_cipher — 用於 SSL 加密嘅一個或多個加密算法列表，採用 OpenSSL 兼容格式。

db_tls_key — 客戶端密鑰嘅路徑。

db_tls_verify_cert — 禁用 (0) 或啟用 (1) 伺服器證書驗證。

如果將 db_tls_verify_cert 設為 1（啟用），configuration.php 文件中嘅 db_host 值必須匹配您為 db_tls_cert 指定嘅證書嘅通用名稱 (CN) 或主題替代名稱 (SAN)。如果唔匹配，您會見到錯誤。更多資訊，請參閱無法連接錯誤。

如果主機名唔匹配且 db_tls_verify_cert 啟用，您會見到「無法連接數據庫」錯誤。

要解決此問題，將 db_tls_verify_cert 設為 0 或提供一個新證書，其 CN 或 SAN 匹配 db_host 值。

您可以在安裝前、安裝期間或安裝後使用命令行安裝方法配置這些變量，或安裝後使用基於瀏覽器嘅安裝方法。

啟用此功能嘅步驟，請參閱啟用加密 MySQL 同 configuration.php 文件。

有關配置 MySQL 嘅更多資訊，請參閱使用加密連接 同 伺服器狀態變量。

喺 cPanel & WHM 伺服器上配置加密 MySQL 連接嘅步驟，請參閱 cPanel 嘅如何配置 MySQL SSL 連接文檔。

PHP

盡可能建議使用處於活躍開發或接收上游 PHP 維護者安全修復嘅 PHP 版本。

PHP 配置中嘅問題可能會導致嚴重問題或阻止您使用某些功能。例如，如果系統 cron 使用嘅 PHP 版本與網頁伺服器嘅版本唔匹配，您可能會見到警告。

某些功能可能有額外要求。例如，自動更新工具需要特定嘅 PHP 設置。

PHP 擴展

除上述擴展外，WHMCS 需要預設編譯嘅擴展（例如 PDO、mysqlnd、JSON、libxml、DOM 或 Fileinfo）。

如果某個擴展唔喺列表中但喺您嘅 PHP 版本中預設編譯，請勿禁用它。

PCI 合規性可能需要 TLS 1.2。

請勿使用 libmysqlclient 編譯 PDO_MySQL。您必須使用 mysqlnd 編譯。更多資訊，請參閱 PHP.watch 嘅移除通知。

文件權限

WHMCS 所需嘅權限設置取決於您嘅確切系統配置。例如，對於標準嘅 cPanel & WHM 伺服器，建議以下權限：

configuration.php — 400

/crons/pipe.php — 755

所有其他 PHP 文件 — 644

所有目錄 — 755

文件擁有者同組應與用戶目錄名相同。例如，喺 cPanel & WHM 伺服器上，網頁根目錄位於 /home/username/public_html/，username 將擁有文件，組也將使用名稱 username。

PHP 進程嘅擁有者同組必須與用戶目錄名相同。例如，喺 cPanel & WHM 伺服器上，網頁根目錄位於 /home/username/public_html/，PHP 進程擁有者同組都將係 username。

對於大多數 WHMCS 安裝，建議以下權限：

文件或目錄 chmod 權限

configuration.php 400（可讀）

/attachments 777（可寫）

/downloads 777（可寫）

/templates_c 777（可寫）

所有其他文件 644（擁有者可寫，其他可讀）

所有其他目錄 755（擁有者可寫，其他可讀可執行）

這唔適用於使用 suPHP 或 phpSuExec 嘅安裝。

如果使用 DSO 作為 PHP 處理器，您必須使用 644 權限。