异常处理优化

src/DfaFilter/Exceptions/PdsBusinessException.php

@@ -0,0 +1,18 @@
+<?php
+/**
+ * Class PdsBusinessException
+ * User: Lustre
+ * Date: 2018/9/20
+ * Time: 下午9:16
+ */
+
+namespace DfaFilter\Exceptions;
+
+use Exception;
+
+class PdsBusinessException extends Exception
+{
+ const EMPTY_CONTENT = 10001; // 空检测文本内容
+ const EMPTY_WORD_POOL = 10002; // 空词库
+ const CANNOT_FIND_FILE = 10003; // 找不到词库文件
+}

src/DfaFilter/Exceptions/PdsSystemException.php

@@ -0,0 +1,16 @@
+<?php
+/**
+ * Class PdsSystemException
+ * User: wanghui
+ * Date: 2018/9/20
+ * Time: 下午9:39
+ */
+
+namespace DfaFilter\Exceptions;
+
+use Exception;
+
+class PdsSystemException extends Exception
+{
+
+}

src/DfaFilter/HashMap.php

@@ -1,8 +1,7 @@
 <?php
-
 /**
  * php构建哈希表类.
- * User: wanghui
+ * User: Lustre
  * Date: 17/3/9
  * Time: 上午9:10
  **/
@@ -99,7 +98,7 @@ public function values()
  /**
  * 将一个HashMap的值全部put到当前HashMap中
  *
- * @param $map
+ * @param \DfaFilter\HashMap $map
  */
  public function putAll($map)
  {
@@ -132,7 +131,7 @@ public function removeAll()
  */
  public function containsValue($value)
  {
- while ($curValue = current($this->H_table)) {
+ while ($curValue = current($this->hashTable)) {
  if ($curValue == $value) {
  return true;
  }

src/DfaFilter/SensitiveHelper.php

@@ -1,13 +1,14 @@
 <?php
-
 /**
  * 敏感词类库.
- * User: wanghui
+ * User: Lustre
  * Date: 17/3/9
  * Time: 上午9:11
  */
 namespace DfaFilter;
 
+use DfaFilter\Exceptions\PdsBusinessException;
+
 class SensitiveHelper
 {
  /**
@@ -51,16 +52,19 @@ public static function init()
  return self::$_instance;
  }
 
+
  /**
  * 构建铭感词树【文件模式】
  *
- * @param string $sensitiveWord
+ * @param string $filepath
+ *
  * @return $this
+ * @throws \DfaFilter\Exceptions\PdsBusinessException
  */
  public function setTreeByFile($filepath = '')
  {
- if (! file_exists($filepath)) {
- throw new \Exception('词库文件不存在');
+ if (!file_exists($filepath)) {
+ throw new PdsBusinessException('词库文件不存在', PdsBusinessException::CANNOT_FIND_FILE);
  }
 
  // 词库树初始化
@@ -77,13 +81,15 @@ public function setTreeByFile($filepath = '')
  /**
  * 构建铭感词树【数组模式】
  *
- * @param string $sensitiveWord
+ * @param null $sensitiveWords
+ *
  * @return $this
+ * @throws \DfaFilter\Exceptions\PdsBusinessException
  */
  public function setTree($sensitiveWords = null)
  {
  if (empty($sensitiveWords)) {
- throw new \Exception('词库不能为空');
+ throw new PdsBusinessException('词库不能为空', PdsBusinessException::EMPTY_WORD_POOL);
  }
 
  $this->wordTree = new HashMap();
@@ -101,6 +107,7 @@ public function setTree($sensitiveWords = null)
  * @param int $matchType 匹配类型 [默认为最小匹配规则]
  * @param int $wordNum 需要获取的敏感词数量 [默认获取全部]
  * @return array
+ * @throws \DfaFilter\Exceptions\PdsSystemException
  */
  public function getBadWord($content, $matchType = 1, $wordNum = 0)
  {
@@ -162,29 +169,26 @@ public function getBadWord($content, $matchType = 1, $wordNum = 0)
  return $badWordList;
  }
 
-
  /**
  * 替换敏感字字符
  *
- * @param $wordMap
- * @param $content
- * @param $replaceChar
+ * @param $content
+ * @param string $replaceChar
  * @param string $sTag
  * @param string $eTag
- * @param int $matchType
+ * @param int $matchType
+ *
  * @return mixed
+ * @throws \DfaFilter\Exceptions\PdsBusinessException
+ * @throws \DfaFilter\Exceptions\PdsSystemException
  */
  public function replace($content, $replaceChar = '', $sTag = '', $eTag = '', $matchType = 1)
  {
  if (empty($content)) {
- throw new \Exception('请填写检测的内容');
+ throw new PdsBusinessException('请填写检测的内容', PdsBusinessException::EMPTY_CONTENT);
  }
 
- if (empty(self::$badWordList)) {
- $badWordList = $this->getBadWord($content, $matchType);
- } else {
- $badWordList = self::$badWordList;
- }
+ $badWordList = self::$badWordList ? self::$badWordList : $this->getBadWord($content, $matchType);
 
  // 未检测到敏感词，直接返回
  if (empty($badWordList)) {
@@ -200,7 +204,14 @@ public function replace($content, $replaceChar = '', $sTag = '', $eTag = '', $ma
  return $content;
  }
 
- // 被检测内容是否合法
+ /**
+ * 被检测内容是否合法
+ *
+ * @param $content
+ *
+ * @return bool
+ * @throws \DfaFilter\Exceptions\PdsSystemException
+ */
  public function islegal($content)
  {
  $this->contentLength = mb_strlen($content, 'utf-8');

src/DfaFilter/functions.php

@@ -0,0 +1,21 @@
+<?php
+namespace DfaFilter;
+
+use DfaFilter\Exceptions\PdsSystemException;
+
+/**
+ * @param $str
+ * @param null $encoding
+ *
+ * @return int
+ * @throws \DfaFilter\Exceptions\PdsSystemException
+ */
+function mb_strlen($str, $encoding = null)
+{
+ $length = \mb_strlen($str, $encoding);
+ if ($length === false) {
+ throw new PdsSystemException(' encoding 无效');
+ }
+
+ return $length;
+}