add : add php @throws demo

Author: yinggaozhen

php/deprecated/index.php

@@ -12,7 +12,7 @@ class TagDeprecated
      *
      * @deprecated
      */
-    static public function willBeDeprecated()
+    public static function willBeDeprecated()
     {
     }
 
@@ -21,7 +21,7 @@ static public function willBeDeprecated()
      *
      * @deprecated 1.0.0
      */
-    static public function willBeDeprecatedNextVersion()
+    public static function willBeDeprecatedNextVersion()
     {
     }
 
@@ -31,14 +31,14 @@ static public function willBeDeprecatedNextVersion()
      * @see TagDeprecated::apiV2()
      * @deprecated 3.0.0 此方法以被废弃，请使用最新方法v2
      */
-    static public function apiV1()
+    public static function apiV1()
     {
     }
 
     /**
      * V1已经过时了，我就是最靓的V2方法
      */
-    static public function apiV2()
+    public static function apiV2()
     {
     }
 }

php/example/index.php

@@ -13,7 +13,7 @@ class TagParam
      * @param string $piece 碎片
      * @return string[]
      */
-    static public function join($collection, $piece)
+    public static function join($collection, $piece)
     {
         $collection[] = $piece;
 

php/param/index.php

@@ -0,0 +1,17 @@
+@throws
+=======
+
+`@throws` : 抛出一个异常，告诉调用方需要做好处理异常相关工作.
+
+**此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用**
+
+语法
+=======
+
+> `@throws [Type] [<description>]`
+
+
+标签效果
+=======
+
+![demo.jpg](./docs/demo.png)

php/throws/README.md

@@ -1,32 +1,28 @@
 <?php
 
-class BeiException extends Exception {}
-class HuException extends Exception {}
-
-class ClassForThrows
+/**
+ * <p>"@throws" : 抛出一个异常，告诉调用方需要做好处理异常相关工作</p>
+ *
+ * <b>此标签建议在PHPStorm中打开此演示文档，可以看到具体的标签效果</b>
+ */
+class TagThrows
 {
     /**
-     * @throws BeiException
+     * 整数相除
+     *
+     * @param integer $a
+     * @param integer $b
+     * @return float|int
+     * @throws \Exception 被除数不能为0
      */
-    public static function throwBeiException()
+    public static function div($a, $b)
     {
-        throw new BeiException();
-    }
-
-    /**
-     * @param boolean $type
-     * @throws BeiException|HuException
-     */
-    public static function throwMixedException($type)
-    {
-        if ($type) {
-            throw new BeiException();
+        if (empty($b)) {
+            throw new Exception('Division by zero');
         }
 
-        throw new HuException();
+        return $a / $b;
     }
 }
 
-ClassForThrows::throwBeiException();
-
-ClassForThrows::throwMixedException(true);
+echo TagThrows::div(1, 2);

php/throws/docs/demo.png

@@ -11,9 +11,9 @@ class TagVar
     /**
      * <1>.第一种使用方法，只定义类型，通常用于类成员变量中
      *
-     * @var array 标签数组
+     * @var array|null 标签数组
      */
-    public $tags;
+    public $tags = null;
 }
 
 $tag = new TagVar();