添加事件处理程序

例如,为"客户帐户创建"事件创建事件处理程序。该处理程序将把客户名作为首参数,然后将客户登录名作为第二个参数。简单而言,我们将使用一个名为 test-handler.sh 的外壳脚本,如下所示:

#!/bin/bash

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

/bin/date >> /tmp/event_handler.log # information on the event date and time

/usr/bin/id >> /tmp/event_handler.log # information on the user, on behalf of which the script was executed (to ensure control)

echo "client created" >> /tmp/event_handler.log # information on the created client account

echo "name:$1" >> /tmp/event_handler.log # client's name

echo "login:$2" >> /tmp/event_handler.log # client's login

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

此脚本将某些信息打印到一个文件上,因此我们可以控制其执行(此脚本以后台模式执行,所以我们不能把信息输出到 stdout/stderr)。

假设我们的脚本位于目录 /plesk_installation_directory/bin (例如)。那么我们可以使用控制面板通过创建一个事件处理程序来注册该脚本:

  1. 选择导航窗格中的"器"快捷方式。
  2. 单击"板"组中的 "事件器"图标。
  3. 单击 "事件器"图标。"事件处理程序设置"页面即会打开:
  4. "事件"下拉框中,选择您想要为其分配处理程序的事件。
  5. 为处理程序执行选择优先权,或指定一个自定义值。要执行该操作,请在"级"下拉列表中选择自定义,然后键入所需值。

    当为单个事件分配多个处理程序时,您可以指定处理程序执行的顺序,并设置不同的优先级(数值越高,优先级越高)。

  6. 选择系统用户,代表将要被执行的事件处理程序。
  7. "令"输入字段中,指定将要在所选事件上执行的命令。在我们所举示例中命令为 /usr/local/psa/bin/test-handler.sh <new_contact_name> <new_login_name>
  8. 单击"定"

注意:我们已在命令中尖括号 <new_contact_name><new_login_name> 中指定了参数。在执行处理程序之前,它们将分别被已创建的客户姓名和登录名替换。可用参数的完整列表将在后面的部分中提供。请记住,通过删除操作,new_xxx 类型的参数包括一个空字符串。通过新建操作,old_xxx c 类型的参数中也包括一个空字符串。

现在,如果您登录到 Plesk 控制面板并创建了一个新客户(在"字段中输入"Some Client",在"段"中输入"some_client"),那么该事件处理程序将被调用,并且以下记录将被添加至 /tmp/event_handler.log 中:

Sat Jun 26 21:46:34 NOVT 2004

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

 

对于事件"站点别名创建、更新、删除、域名解析修改"

站点别名

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

 

Mod 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)

对于"邮件名称更新"事件

邮件名

old_mailname

new_mailname

必需(按以下格式 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 用户删除"事件

站点名称

old_domain_name

new_domain_name

必需

Web 用户名

old_webuser_name

new_webuser_name

必需

对于"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

 

Mod Perl 支持

old_mod_perl_support

new_mod_perl_support

 

Mod 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_site_application_package_name

new_site_application_package_name

必需

站点类型(站点或子站点)

old_site_application_domain_type

new_site_application_domain_type

必需

安装路径(httpdocs 或 httpsdocs)

old_site_application_directory

new_site_application_directory

必需

在目标目录中的安装路径

old_site_application_installation_prefix

new_site_application_installation_prefix

必需

对于"站点应用程序包安装"、"站点应用程序包卸载"事件

站点应用程序包名称

old_site_application_package_name

new_site_application_package_name

必需

"服务停止、开始或重启"事件

服务

old_service

new_service

必需

"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 池更改"事件

联系人

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

 

对于"站点域名解析更新"事件

站点名称

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