Typecho表單驗證進階：為插件和主題添加自定義addRule驗證規則

?? 我的個人網站：樂樂主題創作室

引言

在Typecho插件和主題開發過程中，表單驗證是保證數據安全和完整性的重要環節。Typecho提供了內置的表單驗證機制，但開發者經常需要擴展這些驗證規則以滿足特定需求。本文將深入探討如何為Typecho的表單系統添加自定義的addRule驗證規則，從基礎實現到高級應用場景。

一、Typecho表單驗證基礎

1.1 Typecho表單系統概述

Typecho的表單系統基于Typecho_Widget_Helper_Form類構建，它提供了一套完整的表單生成和驗證機制。默認情況下，Typecho已經內置了一些常用的驗證規則：

// 內置驗證類型示例
$input = new Typecho_Widget_Helper_Form_Element_Text('username',NULL,NULL,_t('用戶名'),_t('用戶名將作為您的唯一標識')
);
$input->addRule('required', _t('必須填寫用戶名'));
$input->addRule('maxLength', _t('用戶名最多包含32個字符'), 32);

1.2 addRule方法解析

addRule方法的簽名如下：

/*** 添加驗證規則** @param string $name 規則名稱* @param string $message 錯誤提示信息* @param mixed $parameter 驗證參數* @param string $type 驗證類型(break|continue)* @param integer $priority 驗證優先級* @return Typecho_Widget_Helper_Form_Element*/
public function addRule($name, $message, $parameter = NULL, $type = 'break', $priority = 1)

二、自定義驗證規則實現

2.1 創建自定義驗證類

要擴展驗證規則，我們需要創建一個繼承自Typecho_Validate的類：

class Custom_Validate extends Typecho_Validate
{/*** 驗證手機號碼格式* * @param string $value 待驗證的值* @param string $parameter 驗證參數(可空)* @return boolean*/public static function isMobile($value, $parameter){return preg_match("/^1[3-9]\d{9}$/", $value);}/*** 驗證字符串是否為純中文* * @param string $value 待驗證的值* @param string $parameter 驗證參數(可空)* @return boolean*/public static function isChinese($value, $parameter){return preg_match("/^[\x{4e00}-\x{9fa5}]+$/u", $value);}
}

2.2 注冊自定義驗證規則

在插件或主題的初始化階段，需要將自定義驗證類注冊到Typecho的驗證系統中：

Typecho_Validate::addRule('isMobile', array('Custom_Validate', 'isMobile'));
Typecho_Validate::addRule('isChinese', array('Custom_Validate', 'isChinese'));

2.3 使用自定義驗證規則

注冊后，就可以像內置規則一樣使用這些自定義規則了：

$mobile = new Typecho_Widget_Helper_Form_Element_Text('mobile',NULL,NULL,_t('手機號碼'),_t('請輸入有效的手機號碼')
);
$mobile->addRule('isMobile', _t('請輸入有效的手機號碼'));$realname = new Typecho_Widget_Helper_Form_Eleme