大丰网站优化【大丰开通400电话】大丰网站搭建、大丰微信公众号推文外包、大丰开通京东拼多多设计、大丰淘宝装修

大丰网站优化【大丰开通400电话】大丰网站搭建、大丰微信公众号推文外包、大丰开通京东拼多多设计、大丰淘宝装修

大丰区，江苏省盐城市市辖区，大丰地处黄海之滨，江苏省东部、盐城市南部，位于北纬32°56′～33°36′，东经120°13′～120°56′，东临黄海，西连兴化市，南与东台市接壤，北与盐城市亭湖区交界，拥有112公里长的海岸线，总面积3059平方千米。 [1] 

大丰于1942年5月始设县，1951年8月更名为大丰县。1996年8月撤销大丰县，设立县级大丰市。2015年8月，撤销县级大丰市，设立盐城市大丰区。 [2] 

大丰是长三角城市群中一颗耀眼明珠，是麋鹿故乡、黄海港城、上海“飞地”、革命老区、长寿之乡，历史悠久，人文荟萃，开放包容。总人口72万人。辖2个街道、11个镇、两个省级开发区，境内有江苏省属农场3家和沪属农场1个，入选全国综合实力百强区。 [1] 

大丰先后荣获“全国首批生态建设示范市”、“国家首批可持续发展先进示范区”、“国家社会发展综合实验区”、“国家级卫生城市”、“中国优秀旅游城市”、“江苏省文明城市”、“江苏省卫生城市”、“江苏省园林城市”、“江苏省社会治安安市”、“全国城市环境综合整治优秀城市”、“中国最佳休闲小城”和“中国生态保护最佳湿地”。 [1]  是第二批国家农产品质量安全县。

2.1.2 参数规则

接口参数，对于接口服务本身来说，是非常重要的。对于外部调用的客户端来说，同等重要。对于接口参数，我们希望能够既减轻后台开发对接口参数获取、判断、验证、文档编写的痛苦；又能方便客户端快速调用，明确参数的意义。由此，我们引入了参数规则这一概念，即：通过配置参数的规则，自动实现对参数的获取和验证，同时自动生成在线接口文档。

参数规则是针对各个接口服务而配置的多维规则数组，由PhalApi_Api::getRules()方法返回。其中，参数规则数组的一维下标是接口类的方法名，对应接口服务的Action；二维下标是类属性名称，对应在服务端获取通过验证和转换化的最终客户端参数；三维下标name是接口参数名称，对应外部客户端请求时需要提供的参数名称。即：

    public function getRules() {
        return array(
            '接口类方法名' => array(
                '接口类属性' => array('name' => '接口参数名称', ... ... ),
            ),
        );
    }复制代码

通常情况下，接口类属性和接口参数名称一样，但也可以不一样。一种情况是客户端的接口参数名称惯用下划线分割，即蛇形(下划线)命名法，而服务端中则惯用驼峰命名法。例如对于“是否记住我”，客户端参数用is_remember_me，服务端用isRememberMe。另一种情况是如果参数名称较长，为了节省移动网络下的流量，也可以针对客户端参数使用有意义的缩写。如前面的“是否记住我”客户端缩写成is_rem_me。

在参数规则里，可以配置多个接口类方法名，每个方法名的规则，又可以配置多个接口类属性，即有多个接口参数。

配置好参数规则后，当接口参数通过验证后，就可以在接口类方法内，通过类成员属性获取相应的接口参数。

一个简单的示例

假设我们现在需要提供一个用户登录的接口，接口参数有用户名和密码，那么新增的接口类和规则如下：

// $ vim ./Shop/Api/User.php<?phpclass Api_User extends PhalApi_Api {

    public function getRules() {
        return array(
            'login' => array(
                'username' => array('name' => 'username'),
                'password' => array('name' => 'password'),
            ),
        );
    }

    public function login() {
        return array('username' => $this->username, 'password' => $this->password);
    }                               }复制代码

当我们请求此接口服务，并类似这样带上username和password参数时：

http://api.phalapi.net/shop/?service=User.Login&username=dogstar&password=123456复制代码

就可以得到这样的返回结果。

{"ret":0,"data":{"username":"dogstar","password":"123456"},"msg":""}复制代码

这是因为，在接口实现类里面getRules()成员方法配置参数规则后，便可以通过类属性的方式，根据配置指定的名称获取对应的接口参数，如这里的：$this->username和$this->password。

更完善的示例

在实际项目开发中，我们需要对接口参数有更细致的规定，如是否必须、长度范围、最值和默认值等。

继续上面的业务场景，用户登录接口服务的用户名参数和密码参数皆为必须，且密码长度至少为6个字符，则可以参数规则调整为：

// $ vim ./Shop/Api/User.php
    public function getRules() {
        return array(
            'login' => array(
                'username' => array('name' => 'username', 'require' => true),
                'password' => array('name' => 'password', 'require' => true, 'min' => 6),
            ),
           ... ...

大丰网站优化【大丰开通400电话】大丰网站搭建、大丰微信公众号推文外包、大丰开通京东拼多多设计、大丰淘宝装修