最好装上-php-annotations,这样注解也可以提示了, 链接 http://plugins.jetbrains.com/plugin/7320-php-annotations

生成效果如下:

swagger-php(3.0)生成api文档示例源码