### 添加事件处理程序

例如，为"客户帐户创建"事件创建事件处理程序。该处理程序将把客户名作为首参数，然后将客户登录名作为第二个参数。简单而言，我们将使用一个名为 `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 |