[server] scope & error annotations support

Author: sergeyfast

generator/SmdToSwaggerConverter.php

@@ -19,7 +19,7 @@
     //        }
     //      }
     //
-    // Also we supporting @scope <name> & @error <code> <message> tags from PHP annotation.
+    // Also we supporting @scope <name> & @code <code> <message> tags from PHP annotation.
     // Scope adds 401 Unauthorized error.
 
 

src/BaseJsonRpcServerSmd.php

@@ -182,6 +182,11 @@ public function GetServiceMap() {
                         }
                     };
 
+                    // check auth scope
+                    if ( preg_match_all( '/@scope\s+([^\s]*)/', $docComment, $matches ) ) {
+                        $result['services'][$methodName]['scope'] = current( $matches[1] );
+                    }
+
                     // process params
                     foreach ( $method->getParameters() as $parameter ) {
                         $name  = $parameter->getName();
@@ -202,6 +207,13 @@ public function GetServiceMap() {
                     if ( $t ) {
                         $result['services'][$methodName]['returns'] = self::getServiceMapReturnType( $t, $c );
                     }
+
+                    // set simple error codes
+                    if ( preg_match_all( '/@code\s+(\d+)\s+(.*)/', $docComment, $matches ) ) {
+                        foreach ( $matches[1] as $i => $code ) {
+                            $result['services'][$methodName]['errors'][$code] = $matches[2][$i];
+                        }
+                    }
                 }
             }