新增事件處理程式

例如,為“客戶帳戶建立”事件建立事件處理程式。此處理程式將從環境變量處接收客戶名以及該客戶的登入名。簡單而言,我們將使用一個名為 test-handler.sh 的外殼指令檔,如下所示:

#!/bin/bash

echo "--------------" >> /tmp/event_handler.log

/bin/date >> /tmp/event_handler.log # 事件日期和事時間相關資訊

/usr/bin/id >> /tmp/event_handler.log # 為確保控制而執行指令檔的使用者相關資訊

echo "client created" >> /tmp/event_handler.log # 已建立的客戶帳戶相關資訊

echo "name:${NEW_CONTACT_NAME}" >> /tmp/event_handler.log # 客戶名稱

echo "login:${NEW_LOGIN_NAME}" >> /tmp/event_handler.log # 客戶登入名

echo "--------------" >> /tmp/event_handler.log

此指令檔將某些資訊列印到一個檔案上,因此我們可以控制其執行(此指令檔以後台模式執行,所以我們不能把資訊輸出到 stdout/stderr)。

假設我們的指令檔位於目錄 /plesk_installation_directory/bin (例如)。那麼我們可以使用控制面板透過建立一個事件處理程式來註冊該指令檔:

  1. 選擇導航窗格中的“伺服器”捷徑。
  2. 按一下“控制面板”組中的“事件管理員”圖示。
  3. 按一下“新增時間管理員”圖示。“事件處理程式設定”頁面即會開啟:
  4. “事件”下拉式方塊中,選擇您想要為其分配處理程式的事件。
  5. 為處理程式執行選擇優先權,或指定一個自訂值。要執行該操作,請在“優先順序”下拉清單中選擇自訂,然後輸入所需值。

    當為單個事件分配多個處理程式時,您可以指定處理程式執行的順序,並設定不同的優先順序(數值越高,優先順序越高)。

  6. 選擇系統使用者(如:"root"使用者),代表將要被執行的事件處理程式。
  7. “指令”輸入欄位中,指定將要在所選事件上執行的指令。 在我們所舉範例中它是 /usr/local/psa/bin/test-handler.sh
  8. 按一下“確定”

注意:在此指令檔中,我們已指定變量 $NEW_CONTACT_NAME 和 $NEW_LOGIN_NAME。在執行處理程式之前,將分別用已建立的用戶端的名字和登入名取代它們。可用變量的完整清單將在後面的部分中提供。請記住,透過移除操作,未設定 $NEW_xxx 類型的變量。透過建立操作,未設定 $OLD_xxx 類型的參數。

現在,如果您登入到 Plesk 控制面板並建立了一個新客戶(在“聯絡人姓名”欄位中輸入“Some Client”,在“登入欄位”中輸入“some_client”),那麼該事件處理程式將被呼叫,並且以下記錄將被新增至 /tmp/event_handler.log 中:

Fri Mar 16 15:57:25 NOVT 2007

uid=0(root) gid=0(root) groups=0(root)

client created

name:Some clientSome client

login: some_clientsome_client

如果您想指定一或多個事件處理程式,請為其他處理程式重複上述操作即可。

設定事件處理程式時可用的參數模板顯示在以下表格中:

表。可用的事件處理程式參數模板

模組名稱和說明

環境變量名稱

 註釋

 註釋

之前所用的值

新值

“客戶帳戶建立”事件,“客戶帳戶更新”事件,“客戶帳戶移除”事件

 

登入名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

公司名稱

OLD_COMPANY_NAME

NEW_COMPANY_NAME

 

 

電話

OLD_PHONE

NEW_PHONE

 

 

傳真

OLD_FAX

NEW_FAX

 

 

電子郵件

OLD_EMAIL

NEW_EMAIL

 

 

位址

OLD_ADDRESS

NEW_ADDRESS

 

 

城市

OLD_CITY

NEW_CITY

 

 

省份

OLD_STATE_PROVINCE

NEW_STATE_PROVINCE

 

 

郵編

OLD_POSTAL_ZIP_CODE

NEW_POSTAL_ZIP_CODE

 

 

國家/地區

OLD_COUNTRY

NEW_COUNTRY

 

 

“網站建立”事件,“網站更新”事件,“網站移除”事件

“網站建立”事件,“網站更新”事件,“網站移除”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

“子網站建立”事件,“子網站更新”事件,“子網站移除”事件

“子網站建立”事件,“子網站更新”事件,“子網站移除”事件

子網站名稱

OLD_SUBDOMAIN_NAME

NEW_SUBDOMAIN_NAME

要求

要求

父網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

FTP 帳戶

OLD_SYSTEM_USER_TYPE

NEW_SYSTEM_USER_TYPE

 

 

子網站管理員的登入名

OLD_SYSTEM_USER

NEW_SYSTEM_USER

 

 

磁碟空間配額

OLD_HARD_DISK_QUOTA

NEW_HARD_DISK_QUOTA

 

 

SSI 支援

OLD_SSI_SUPPORT

NEW_SSI_SUPPORT

 

 

PHP 支援

OLD_PHP_SUPPORT

NEW_PHP_SUPPORT

 

 

CGI 支援

OLD_CGI_SUPPORT

NEW_CGI_SUPPORT

 

 

Perl 支援

OLD_MOD_PERL_SUPPORT

NEW_MOD_PERL_SUPPORT

 

 

Python 支援

OLD_MOD_PYTHON_SUPPORT

NEW_MOD_PYTHON_SUPPORT

 

 

ColdFusion 支援

OLD_COLDFUSION_SUPPORT

NEW_COLDFUSION_SUPPORT

 

 

Apache::ASP 支援

OLD_APACHE_ASP_SUPPORT

NEW_APACHE_ASP_SUPPORT

 

 

SSL 支援

OLD_SSL_SUPPORT

NEW_SSL_SUPPORT

 

 

對於事件“網站別名建立、更新、移除、DNS網站修改”

對於事件“網站別名建立、更新、移除、DNS網站修改”

網站別名

OLD_DOMAIN_ALIAS_NAME

NEW_DOMAIN_ALIAS_NAME

要求

要求

網站別名開啟或關閉

OLD_STATUS

NEW_STATUS

 

 

網站別名的 Web 服務開啟或關閉

OLD_DOMAIN_ALIAS_WEB

NEW_DOMAIN_ALIAS_WEB

 

 

網站別名的郵件服務開啟或關閉

OLD_DOMAIN_ALIAS_MAIL

NEW_DOMAIN_ALIAS_MAIL

 

 

支援網站別名存取者存取用 Java 寫的 web 應用程式(開啟或關閉)

OLD_DOMAIN_ALIAS_TOMCAT

NEW_DOMAIN_ALIAS_TOMCAT

 

 

對於“本機網站建立”事件,“本機網站更新”事件

對於“本機網站建立”事件,“本機網站更新”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

IP 位址

OLD_IP_ADDRESS

NEW_IP_ADDRESS

 

 

IP 類型

OLD_IP_TYPE

NEW_IP_TYPE

 

 

系統使用者

OLD_SYSTEM_USER

NEW_SYSTEM_USER

 

 

系統使用者密碼

OLD_SYSTEM_USER_PASSWORD

NEW_SYSTEM_USER_PASSWORD

 

 

Shell 存取

OLD_SYSTEM_SHELL

NEW_SYSTEM_SHELL

 

 

FP 支援

OLD_FP_SUPPORT

NEW_FP_SUPPORT

 

 

FP-SSL 支援

OLD_FPSSL_SUPPORT

NEW_FPSSL_SUPPORT

 

 

FP 創作

OLD_FP_AUTHORING

NEW_FP_AUTHORING

 

 

FP 管理員登入名

OLD_FP_ADMIN_LOGIN

NEW_FP_ADMIN_LOGIN

 

 

FP 管理員密碼

OLD_FP_ADMIN_PASSWORD

NEW_FP_ADMIN_PASSWORD

 

 

SSI 支援

OLD_SSI_SUPPORT

NEW_SSI_SUPPORT

 

 

PHP 支援

OLD_PHP_SUPPORT

NEW_PHP_SUPPORT

 

 

CGI 支援

OLD_CGI_SUPPORT

NEW_CGI_SUPPORT

 

 

Perl 支援

OLD_MOD_PERL_SUPPORT

NEW_MOD_PERL_SUPPORT

 

 

Apache ASP 支援

OLD_APACHE_ASP_SUPPORT

NEW_APACHE_ASP_SUPPORT

 

 

SSL 支援

OLD_SSL_SUPPORT

NEW_SSL_SUPPORT

 

 

Web 統計資訊

OLD_WEB_STATISTICS

NEW_WEB_STATISTICS

 

 

自訂錯誤文檔

OLD_APACHE_ERROR_DOCUMENTS

NEW_APACHE_ERROR_DOCUMENTS

 

 

磁碟空間配額

OLD_HARD_DISK_QUOTA

NEW_HARD_DISK_QUOTA

 

 

對於“本機網站移除”事件

對於“本機網站移除”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

對於“郵件帳戶已建立”、“郵件帳戶已移除”事件

對於“郵件帳戶已建立”、“郵件帳戶已移除”事件

電子郵件位址

OLD_MAILNAME

NEW_MAILNAME

要求(按以下格式 mailname@domain)

要求(按以下格式 mailname@domain)

對於“郵件帳戶更新”事件

對於“郵件帳戶更新”事件

電子郵件位址

OLD_MAILNAME

NEW_MAILNAME

要求(按以下格式 mailname@domain)

要求(按以下格式 mailname@domain)

信箱

OLD_MAILBOX

NEW_MAILBOX

 

 

密碼

OLD_PASSWORD

NEW_PASSWORD

 

 

信箱配額

OLD_MAILBOX_QUOTA

NEW_MAILBOX_QUOTA

 

 

轉發

OLD_REDIRECT

NEW_REDIRECT

 

 

轉發位址

OLD_REDIRECT_ADDRESS

NEW_REDIRECT_ADDRESS

 

 

郵件組

OLD_MAIL_GROUP

NEW_MAIL_GROUP

 

 

自動回覆

OLD_AUTORESPONDERS

NEW_AUTORESPONDERS

 

 

郵件使用者控制面板存取

OLD_MAIL_CONTROLPANEL_ACCESS

NEW_MAIL_CONTROLPANEL_ACCESS

 

 

“Web 使用者移除”事件

“Web 使用者移除”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

Web 使用者名稱

OLD_WEBUSER_NAME

NEW_WEBUSER_NAME

要求

要求

對於“Web 使用者建立”事件,“Web 使用者更新”事件

對於“Web 使用者建立”事件,“Web 使用者更新”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

Web 使用者名稱

OLD_WEBUSER_NAME

NEW_WEBUSER_NAME

要求

要求

Web 使用者密碼

OLD_WEBUSER_PASSWORD

NEW_WEBUSER_PASSWORD

 

 

SSI 支援

OLD_SSI_SUPPORT

NEW_SSI_SUPPORT

 

 

PHP 支援

OLD_PHP_SUPPORT

NEW_PHP_SUPPORT

 

 

CGI 支援

OLD_CGI_SUPPORT

NEW_CGI_SUPPORT

 

 

Perl 支援

OLD_MOD_PERL_SUPPORT

NEW_MOD_PERL_SUPPORT

 

 

Python 支援

OLD_MOD_PYTHON_SUPPORT

NEW_MOD_PYTHON_SUPPORT

 

 

Apache ASP 支援

OLD_APACHE_ASP_SUPPORT

NEW_APACHE_ASP_SUPPORT

 

 

磁碟空間配額

OLD_HARD_DISK_QUOTA

NEW_HARD_DISK_QUOTA

 

 

“用戶端限制更新”事件

“用戶端限制更新”事件

聯絡人姓名

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

最大網站數量

OLD_MAXIMUM_DOMAINS

NEW_MAXIMUM_DOMAINS

 

 

最大磁碟空間量

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

 

 

最大流量

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

Web 使用者的最大數量

OLD_MAXIMUM_WEBUSERS

NEW_MAXIMUM_WEBUSERS

 

 

資料庫的最大數量

OLD_MAXIMUM_DATABASES

NEW_MAXIMUM_DATABASES

 

 

信箱的最大數量

OLD_MAXIMUM_MAILBOXES

NEW_MAXIMUM_MAILBOXES

 

 

信箱配額

OLD_MAXIMUM_MAILBOX_QUOTA

NEW_MAXIMUM_MAILBOX_QUOTA

 

 

郵件轉發的最大數量

OLD_MAXIMUM_MAIL_REDIRECTS

NEW_MAXIMUM_MAIL_REDIRECTS

 

 

郵件組的最大數量

OLD_MAXIMUM_MAIL_GROUPS

NEW_MAXIMUM_MAIL_GROUPS

 

 

郵件自動回覆的最大數量

OLD_MAXIMUM_MAIL_AUTORESPONDERS

NEW_MAXIMUM_MAIL_AUTORESPONDERS

 

 

郵件清單的最大數量

OLD_MAXIMUM_MAIL_LISTS

NEW_MAXIMUM_MAIL_LISTS

 

 

最大 Java 應用程式數量

OLD_MAXIMUM_TOMCAT_WEB_APPLICATIONS

NEW_MAXIMUM_TOMCAT_WEB_APPLICATIONS

 

 

過期日期

OLD_EXPIRATION_DATE

NEW_EXPIRATION_DATE

 

 

“網站限制更新”事件

“網站限制更新”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

最大磁碟空間

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

 

 

最大流量

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

最大 web 使用者數量

OLD_MAXIMUM_WEBUSERS

NEW_MAXIMUM_WEBUSERS

 

 

最大資料庫數量

OLD_MAXIMUM_DATABASES

NEW_MAXIMUM_DATABASES

 

 

最大信箱數量

OLD_MAXIMUM_MAILBOXES

NEW_MAXIMUM_MAILBOXES

 

 

信箱配額

OLD_MAXIMUM_MAILBOX_QUOTA

NEW_MAXIMUM_MAILBOX_QUOTA

 

 

最大郵件轉發數量

OLD_MAXIMUM_MAIL_REDIRECTS

NEW_MAXIMUM_MAIL_REDIRECTS

 

 

最大郵件組數量

OLD_MAXIMUM_MAIL_GROUPS

NEW_MAXIMUM_MAIL_GROUPS

 

 

最大郵件自動回覆數量

OLD_MAXIMUM_MAIL_AUTORESPONDERS

NEW_MAXIMUM_MAIL_AUTORESPONDERS

 

 

最大郵件清單數量

OLD_MAXIMUM_MAIL_LISTS

NEW_MAXIMUM_MAIL_LISTS

 

 

最大 java 應用程式數量

OLD_MAXIMUM_TOMCAT_WEB_APPLICATIONS

NEW_MAXIMUM_TOMCAT_WEB_APPLICATIONS

 

 

過期時間

OLD_EXPIRATION_DATE

NEW_EXPIRATION_DATE

 

 

“郵件清單建立”事件,“郵件清單更新”事件,“郵件清單移除”事件

“郵件清單建立”事件,“郵件清單更新”事件,“郵件清單移除”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

郵件清單名

OLD_MAIL_LIST_NAME

NEW_MAIL_LIST_NAME

要求

要求

郵件清單已啟用。

OLD_MAIL_LIST_ENABLED

NEW_MAIL_LIST_ENABLED

 

 

“控制面板使用者登入”事件,“控制面板使用者登出”事件

“控制面板使用者登入”事件,“控制面板使用者登出”事件

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

 

 

對於“網站管理員帳戶更新”事件

對於“網站管理員帳戶更新”事件

允許網站管理員存取

OLD_ALLOW_DOMAIN_USER_ACCESS

NEW_ALLOW_DOMAIN_USER_ACCESS

 

 

登入名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

聯絡人姓名

OLD_CONTACT_NAME

NEW_CONTACT_NAME

 

 

公司名稱

OLD_COMPANY_NAME

NEW_COMPANY_NAME

 

 

電話

OLD_PHONE

NEW_PHONE

 

 

傳真

OLD_FAX

NEW_FAX

 

 

電子郵件

OLD_EMAIL

NEW_EMAIL

 

 

位址

OLD_ADDRESS

NEW_ADDRESS

 

 

城市

OLD_CITY

NEW_CITY

 

 

省份

OLD_STATE_PROVINCE

NEW_STATE_PROVINCE

 

 

郵編

OLD_POSTAL_ZIP_CODE

NEW_POSTAL_ZIP_CODE

 

 

國家/地區

OLD_COUNTRY

NEW_COUNTRY

 

 

對於“網站應用程式安裝”事件,“網站應用程式重新設定”事件,“網站應用程式卸載”事件

對於“網站應用程式安裝”事件,“網站應用程式重新設定”事件,“網站應用程式卸載”事件

網站套用套件名稱

OLD_PACKAGE_NAME

NEW_PACKAGE_NAME

要求

要求

網站類型(網站或子網站)

OLD_DOMAIN_TYPE

NEW_DOMAIN_TYPE

要求

要求

安裝路徑(httpdocs 或 httpsdocs)

OLD_DIRECTORY

NEW_DIRECTORY

要求

要求

在目的目錄中的安裝路徑

OLD_INSTALLATION_PREFIX

NEW_INSTALLATION_PREFIX

要求

要求

對於“網站套用套件安裝”事件,“網站套用套件卸載”事件

對於“網站套用套件安裝”事件,“網站套用套件卸載”事件

網站套用套件名稱

OLD_PACKAGE_NAME

NEW_PACKAGE_NAME

要求

要求

“服務停止、開始或重啟”事件

“服務停止、開始或重啟”事件

服務

OLD_SERVICE

NEW_SERVICE

要求

要求

“IP 位址建立、更改或移除”事件

“IP 位址建立、更改或移除”事件

IP 位址

OLD_IP_ADDRESS

NEW_IP_ADDRESS

要求

要求

IP 遮罩

OLD_IP_MASK

NEW_IP_MASK

 

 

介面

OLD_INTERFACE

NEW_INTERFACE

 

 

IP 類型

OLD_IP_TYPE

NEW_IP_TYPE

 

 

對於“轉發建立、更改和移除”事件

對於“轉發建立、更改和移除”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

轉發類型

OLD_FORWARDING_TYPE

NEW_FORWARDING_TYPE

 

 

URL

OLD_URL

NEW_URL

 

 

對於“管理員資訊更改”事件

對於“管理員資訊更改”事件

登入名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

 

 

公司名稱

OLD_COMPANY_NAME

NEW_COMPANY_NAME

 

 

電話號碼

OLD_PHONE

NEW_PHONE

 

 

傳真

OLD_FAX

NEW_FAX

 

 

電子郵件

OLD_EMAIL

NEW_EMAIL

 

 

位址

OLD_ADDRESS

NEW_ADDRESS

 

 

城市

OLD_CITY

NEW_CITY

 

 

省份

OLD_STATE_PROVINCE

NEW_STATE_PROVINCE

 

 

郵編

OLD_POSTAL_ZIP_CODE

NEW_POSTAL_ZIP_CODE

 

 

國家/地區

OLD_COUNTRY

NEW_COUNTRY

 

 

對於“網站應用程式安裝、重新設定、卸載”事件

對於“網站應用程式安裝、重新設定、卸載”事件

網站應用程式名稱

OLD_PACKAGE_NAME

NEW_PACKAGE_NAME

要求

要求

對於“用戶端狀態更新”事件

對於“用戶端狀態更新”事件

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

登入名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

狀態

OLD_STATUS

NEW_STATUS

 

 

對於“客戶喜好設定更新”事件

對於“客戶喜好設定更新”事件

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

登入名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

頁面大小

OLD_LINES_PER_PAGE

NEW_LINES_PER_PAGE

 

 

介面外觀

OLD_INTERFACE_SKIN

NEW_INTERFACE_SKIN

 

 

對於“客戶 IP 集區更改”事件

對於“客戶 IP 集區更改”事件

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

IP 位址

OLD_IP_ADDRESS

NEW_IP_ADDRESS

要求

要求

狀態

OLD_STATUS

NEW_STATUS

 

 

對於“已達到此客戶帳號磁碟空間的上限”事件

對於“已達到此客戶帳號磁碟空間的上限”事件

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

磁碟空間限制

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

要求

要求

對於“已達到此客戶帳戶的流量上限”事件

對於“已達到此客戶帳戶的流量上限”事件

聯絡人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

流量限制

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

對於“網站狀態更改”事件

對於“網站狀態更改”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

網站狀態

OLD_STATUS

NEW_STATUS

 

 

對於“網站DNS網站更新”事件

對於“網站DNS網站更新”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

對於“已達到網站磁碟空間上限”事件

對於“已達到網站磁碟空間上限”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

磁碟空間限制

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

 

 

“已達到此網站流量上限”事件

“已達到此網站流量上限”事件

網站名稱

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

流量限制

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

“許可證更新”事件

“許可證更新”事件

許可證號

OLD_LICENSE

NEW_LICENSE

要求

要求

許可證類型(Plesk,其他)

OLD_LICENSE_TYPE

NEW_LICENSE_TYPE

 

 

許可證名稱(對於其他許可證)

OLD_LICENSE_NAME

NEW_LICENSE_NAME