上往建站提供服务器空间服务商，百度快照排名，网站托管，百度推广运营,致力于设计外包服务与源代码定制开发，360推广，搜狗推广,增加网站的能见度及访问量提升网络营销的效果,主营：网站公司,百度推广公司电话,官网搭建服务,网站服务企业排名,服务器空间,英文域名等业务，专业团队服务，效果好。

海门小程序制作【海门企业邮箱】海门网站外包、海门微信商城开发、海门网店美工、海门淘宝设计

海门区，隶属江苏省南通市，位于江苏省东南部，长江北岸，东北濒临黄海，南靠长江，全境总面积1148.71平方千米， [1]  截至2020年，海门区户籍人口98.87万人。 [14]  截至2020年6月，海门区下辖3个街道9个镇。 [2]  海门区人民政府驻海门街道北京中路600号。 [3] 

后周显德五年（958年），置海门县，属通州辖领。 [4]  2020年，撤销海门市，设立海门区。 [3]  海门文化属吴越文化，海门人主要使用吴语，属江浙民系。 [5-7]  海门区境内地势平坦，沟河纵横。 [1]  属北亚热带季风气候区，四季分明。 [8] 

海门区是全国双拥模范县 [9]  、国家生态文明建设示范区 [10]  、国家卫生城市 [11]  、中国特色农产品优势区 [12]  、革命文物保护利用片区分县 [13]  、国家知识产权示范城市。

2020年，海门区地区生产总值1442.57亿元，比上年增长5.5%。其中，第一产业增加值68.73亿元，第二产业增加值710.13亿元，第三产业增加值663.71亿元，增长6.8%，三次产业结构为4.8：49.2：46.0。

如果需要显示其他扩展类库下的接口服务，则需要将对应的项目目录参考上面的写法添加进来。添加好后，记得要在checkApiParams.php文件中同步添加。

顺便提一下，框架的一致性，在这里也得到了体现。那就是任何类的使用，都应先挂靠再使用。在添加了扩展类库的目录后，在线接口列表文档才能显示对应扩展类库下的接口服务。

3.3.2 在线接口详情文档

如何访问在线接口详情文档？

在进入上面的在线接口列表文档后，点击对应的接口服务即可跳转到对应的接口详情文档。或者，也可以手动拼接访问。它的访问路径与listAllApis.php类似，但需要访问的是checkApiParams.php文件，并且需要使用service参数指定需要查看的接口服务。例如查看我们之前定义的获取商品快照信息的接口服务。

在浏览器访问打开：

http://api.phalapi.net/shop/checkApiParams.php?service=Goods.Snapshot复制代码

打开后，访问效果类似如下：

图3-5 商品快照信息的在线接口详情文档

在线接口详情文档的注释规范

接口文档的注释较多，开发人员可在进行项目开发时按需注释。但各部分的规范也是简单明了的。结合上面的访问效果和商品快照信息接口类这一示例，从上到下，依次讲解各部分的使用规范。

• 接口 当前接口服务的service名称，即：Class.Action。

• 接口名称 接口中文名称，不带任何注解的注释，通常为接口类成员函数的第一行注释。如：

  /**
   * 获取商品快照信息
   */public function snapshot() {复制代码

• 接口说明 对应接口类成员函数的@desc注释。如：

  /**
   * @desc 获取商品基本和常用的信息
   */public function snapshot() {复制代码

• 接口参数 根据接口类配置的参数规则自动生成，即对应当前接口类getRules()方法中的返回。其中最后的“说明” 字段对应参数规则中的desc选项。可以配置多个参数规则。此外，配置文件./Config/app.php中的公共参数规则也会显示在此接口参数里。这里的参数规则是：

  public function getRules() {
      return array(
          'snapshot' => array(
              'id' => array('name' => 'id', 'require' => true, 'type' => 'int', 'min' => 1, 'desc' => '商品ID'),
          ),
      );}

海门小程序制作【海门企业邮箱】海门网站外包、海门微信商城开发、海门网店美工、海门淘宝设计

上往建站提供搭建网站，域名注册，官网备案服务，网店详情页设计，企业网店，专业网络店铺管理运营全托管公司咨询电话，服务器空间，微信公众号托管，网页美工排版,致力于域名申请，竞价托管，软文推广，全网营销,提供标准级专业技术保障，了却后顾之忧,主营：虚拟主机，网站推广，百度竞价托管，网站建设，上网建站推广服务，网络公司有哪些等业务，专业团队服务，效果好。

服务热线：400-111-6878 手机微信同号:18118153152（各城市商务人员可上门服务）