东海微信公众号开发【东海网络推广】东海建站、东海网站维护、东海网页制作、东海微信小程序代运营公司

东海微信公众号开发【东海网络推广】东海建站、东海网站维护、东海网页制作、东海微信小程序代运营公司

东海县，隶属于江苏省连云港市，素有世界水晶之都、中国温泉之乡之称，是全国首批沿海开放县、新亚欧大陆桥西行第一县，淮海经济圈、长三角经济圈、新亚欧大陆桥经济走廊交叉辐射区。 [1] 

东海县位于江苏省东北部，地处江苏、山东两省交界处，东濒黄海，西接彭城，南依江淮，北界齐鲁；北至西北与山东省临沭县、郯城县相连，东与连云港海州区、赣榆区接壤，南与沭阳县交界，西与新沂市相依；全县总面积2037平方公里，人口124万，辖19个乡镇（场）、2个街道、1个省级经济开发区、1个省级高新区和1个省级旅游度假区。 [2] 

东海县资源丰富、特色鲜明，拥有“石、泉、湖、井、画”等五张特色名片，先后被评为全国粮食生产先进县、全国科技进步考核先进县、国家卫生县城、国家级生态县、全国文化先进县、中国观赏石（水晶）之乡、江苏省级园林城市、百湖之县、中国民间艺术之乡等美誉，先后培养出南朝诗人鲍照、现代散文家朱自清、当代版画家彦涵等历史文化名人。 [3] 

2016年11月，东海被国家旅游局评为第二批国家全域旅游示范区。2018年10月，东海县入选“综合实力百强县”、 [4]  全国投资潜力百强县市、 [5]  全国绿色发展百强县市、全国新型城镇化质量百强县市。2019年3月，被列为第一批革命文物保护利用片区分县名单。2019年7月，被列为国家知识产权强县工程示范县（区）。 [6]  2019年10月8日，被评为2019年度全国综合实力百强县市。2020中国夏季休闲百佳县市。 [7]  2020年5月，被国家发展改革委列为县城新型城镇化建设示范名单。

根据@testcase -5 -10,5注释生成的测试用例是：

    public function testAddCase1()
    {
        $rs = $this->calculator->add(-10,5);

        $this->assertEquals(-5, $rs);
    }复制代码

关于单元测试的维护，以及如何针对不同的场景编写单元测试，如何采用测试驱动进行开发，将会在后面深入讲解。

3.5.3 phalapi-buildsqls命令

当需要创建数据库表时，可以使用phalapi-buildsqls脚本命令，再结合数据库配置文件./Config/dbs.php即可生成建表SQL语句。此命令在创建分表时尤其有用，其使用如下：

图3-10 phalapi-buildsqls命令的使用说明

其中，

• 第一个参数dbs_config 是指向数据库配置文件的路径，如./Config/dbs.php，可以使用相对路径。

• 第二个参数table 是需要创建sql的表名，每次生成只支持一个。

• 第三个参数engine 可选参数，是指数据库表的引擎，MySQL可以是：Innodb或者MyISAM。

温馨提示：需要提前先将建表的SQL语句，排除除主键id和ext_data字段，放置到./Data/目录下，文件名为：{表名}.sql。

例如，我们需要生成10张user_session用户会话分表的建表语句，那么需要先添加数据文件./Data/user_session.sql，并将除主键id和ext_data字段外的其他建表语句保存到该文件。

      `user_id` bigint(20) DEFAULT '0' COMMENT '用户id',
      `token` varchar(64) DEFAULT '' COMMENT '登录token',
      `client` varchar(32) DEFAULT '' COMMENT '客户端来源',
      `times` int(6) DEFAULT '0' COMMENT '登录次数',
      `login_time` int(11) DEFAULT '0' COMMENT '登录时间',
      `expires_time` int(11) DEFAULT '0' COMMENT '过期时间',复制代码

然后，进入到项目根目录，执行命令：

$ php ./PhalApi/phalapi-buildsqls ./Config/dbs.php user_session复制代码

正常情况下，会看到生成好的SQL语句，类似下面这样的输出。

CREATE TABLE `phalapi_user_session_0` (
      `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
      `user_id` bigint(20) DEFAULT '0' COMMENT '用户id',
      `token` varchar(64) DEFAULT '' COMMENT '登录token',
      `client` varchar(32) DEFAULT '' COMMENT '客户端来源',
      `times` int(6) DEFAULT '0' COMMENT '登录次数',
      `login_time` int(11) DEFAULT '0' COMMENT '登录时间',
      `expires_time` int(11) DEFAULT '0' COMMENT '过期时间',
      `ext_data` text COMMENT 'json data here',
      PRIMARY KEY (`id`)) ENGINE=InnoDB DEFAULT CHARSET=utf8;CREATE TABLE `phalapi_user_session_1` (
      `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
      ... ...
      `ext_data` text COMMENT 'json data here',
      PRIMARY KEY (`id`)) ENGINE=InnoDB DEFAULT CHARSET=utf8;CREATE TABLE `phalapi_user_session_2` ... ...CREATE TABLE `phalapi_user_session_3` ... ...CREATE TABLE `phalapi_user_session_4` ... ...CREATE TABLE `phalapi_user_session_5` ... ...CREATE TABLE `phalapi_user_session_6` ... ...CREATE TABLE `phalapi_user_session_7` ... ...CREATE TABLE `phalapi_user_session_8` ... ...CREATE TABLE `phalapi_user_session_9` ... ...复制代码

最后，便可把生成好的SQL语句，导入到数据库，完成建表的操作。

值得注意的是，生成的SQL建表语句默认会带有自增ID主键id和扩展字段ext_data这两个字段。所以保存在./Data目录下的建表语句可省略主键字段，以免重复。

      `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
      ... ...
      `ext_data` text COMMENT 'json data here',复制代码

3.5.4 phalapi-buildcode命令

当需要编写开发一个新的接口服务时，可以使用phalapi-buildcode命令生成基本的Api类、Domain类和Model类的基本代码。此脚本虽然功能不是很强悍，开发人员可以根据项目的情况以及个人喜好使用，或者修改定制自己的模板。其使用，如同上面的命令一样，执行一下便可看到其使用说明如下：

图3-11 phalapi-buildcode命令的使用说明

其中，

• 第一个参数app_path 是指根目录到你项目的相对路径。

• 第二个参数api_path 是指待创建接口相对于项目的相对路径，支持多级目录，可不带.php后缀。

• 第三个参数author 可选参数，你的名字，默认为空。

• 第四个参数overwrite 可选参数，是否覆盖已有的代码文件，默认为否。

例如，我们现在要新增一个针对库存维度的接口服务类Stock，则可以使用这个命令创建配套的一系列代码模板，包括接口类Api_Stock、领域业务类Domain_Stock、数据模型类Model_Stock。在根目录，执行以下命令，其输出如下：

$ ./PhalApi/phalapi-buildcode Shop StockStart to create file /path/to/PhalApi/PhalApi/../Shop/Api/Stock.php ...Start to create file /path/to/PhalApi/PhalApi/../Shop/Domain/Stock.php ...Start to create file /path/to/PhalApi/PhalApi/../Shop/Model/Stock.php ...OK! Stock has been created successfully!复制代码

创建好代码模板后，可以看到多了几个代码文件。生成的代码文件有：

$ find ./Shop/ -name "Stock*"./Shop/Api/Stock.php./Shop/Domain/Stock.php./Shop/Model/Stock.php复制代码

查看各个文件，可以看到类似下面这样的代码内容。

生成的接口类文件，默认带有go()成员函数，并简单调用领域业务类。

// $ vim ./Shop/Api/Stock.php <?php/**
 * Api_Stock
 * @author  2017-05-10 01:39:33
 */class Api_Stock extends PhalApi_Api {

    public function getRules() {
        return array(
            'go' => array(
            ),
        );
    }

    /**
     * go接口
     * @desc go接口描述
     * @return int code 状态码，0表示成功，非0表示失败
     * @return string msg 状态提示
     */
    public function go() {
        $rs = array('code' => 0, 'msg' => '');

        // TODO
        $domain = new Domain_Stock();
        $domain->go();

        return $rs;
    }}

东海微信公众号开发【东海网络推广】东海建站、东海网站维护、东海网页制作、东海微信小程序代运营公司