发表日期： 2021-03-27 12:46:56 浏览次数：100
资兴网站推广【资兴办理400电话】资兴SEO优化、资兴微信公众号APP客户端小程序开发、资兴网站托管、资兴APP开发
资兴市，湖南省辖县级市，由郴州市代管，位于湖南省东南部。因唐代旧县治位于资兴江畔（今东江湖）而得名，是郴商的发源地之一。资兴市地处湘江流域耒水的上游，在罗霄山脉西麓、茶永盆地南端，为湘、粤、赣三省交汇处。东邻桂东县、株洲市炎陵县，南接汝城县、宜章县，西连苏仙区，北抵永兴、安仁县。总面积2746.79平方公里。 [1]
2017年，资兴市实现地区生产总值362.51亿元，按可比价格计算，增长8.3%。其中，第一产业增加值26.95亿元，增长4.2%；第二产业增加值223.59亿元，增长6.9%；第三产业增加值111.97亿元，增长12.5%。三次产业结构为7.4:61.7:30.9。 [2] 资兴市名优特产主要有杨梅、东江鱼、狗脑贡茶等；风景名胜主要有东江湖、寿佛寺、回龙山等。资兴市下辖2乡9镇2街道；户籍总人口37.85万人，常住人口34.97万人（2017年）。2017年10月，被住建部命名为国家园林城市。2018年11月，被科技部确定为首批创新型县（市）， [3] 入选中国县级市全面小康指数前100名。第三批“绿水青山就是金山银山”实践创新基地。 [4]
2019年3月6日，中央宣传部、财政部、文化和旅游部、国家文物局《中央宣传部 财政部 文化和旅游部 国家文物局关于公布《革命文物保护利用片区分县名单（第一批）》的通知》资兴市名列其中。 [5]
2020年6月，经中央依法治国委入选为第一批全国法治政府建设示范地区和项目名单。 [6] 2020年度真抓实干成效明显，被湖南省人民政府公布为推动高质量发展成效明显的县市区，给予100万元标准奖励。
安装好后，可以使用在线可视化安装向导来创建一个新的项目。
安装向导在目录./Public/install/下，在浏览器输入http://api.phalapi.net/install/便可访问此安装向导。安装界面如下：
图1-1 安装向导
随后按照提示，一步步操作即可。创建新项目过程，会要求输入项目名称。假设我们需要为商城创建一个项目，并命名为：shop，那么安装完成后访问效果如下。
图1-2 新建shop项目的运行效果
这时，可以看到新建了以下目录和文件。
$ tree ./Shop/ ./Public/shop/./Shop/├── Api│ └── Default.php├── Common├── Domain├── Model└── Tests ...../Public/shop/├── checkApiParams.php├── index.php└── listAllApis.php复制代码
对于各个目录，简单说明如下：
./Shop：放置项目源代码，每个项目对应一个目录
./Shop/Api：接口服务类目录
./Shop/Domain：领域业务类目录
./Shop/Model：数据模型类目录
./Shop/Common：公共目录
./Shop/Tests：单元测试目录
以上都是外界不可直接访问的目录，下面则是对外可访问的目录和文件。
./Public/shop：外部可访问的目录
./Public/shop/index.php：入口文件
./Public/shop/listAllApis.php：在线接口列表文档
./Public/shop/checkApiParams.php：在线接口详情文档
关于各个目录和各个文件的作用，后续会作进一步说明。
至此，我们已经取到了阶段性的成果。我们完成了框架的安装与部署，还创建了一个新的项目。接下来，让我们继续探索一下，如何在PhalApi下进行具体的接口编码开发。
遵循国际惯例，这里编写的第一个接口也是Hello World。这是一个非常简单的接口，主要功能是返回“Hello World”这串字符。
继续使用上面已创建的shop项目。首先，创建一个接口类文件./Shop/Api/Welcome.php，并在这里实现主要的功能。
// ./Shop/Api/Welcome.php<?phpclass Api_Welcome extends PhalApi_Api {
public function say() {
return 'Hello World';
}}复制代码然后，便可以对接口进行访问了。如最简单的方式，还是使用浏览器来访问。接口访问的格式为：接口域名 + 入口路径 + ?service=XXX.XXX，所以此接口服务对应的链接为：
http://api.phalapi.net/shop/?service=Welcome.Say复制代码
结果默认以JSON格式返回，即正常情况下会看到：
{"ret":200,"data":"Hello World","msg":""}复制代码以上代码和运行结果截图如下。
图1-3 Hello World代码与运行结果
是不是发现接口开发很简单？
当然，这里只是一个很简单的Hello World示例。实际项目开发中，所遇到的业务场景会更为复杂，所面临的技术挑战也会更为深奥。虽然是一个简单示例，但也很好地帮助了我们对PhalApi的开发和使用有了感性的认识，同时察觉到在进行接口开发时需要时刻保持前瞻性和注重细节。例如细心的读者会发现，这里返回的是一个字符串，若日后需要在这个接口添加其他字段的返回则难以保持向前兼容性。所以，离细致的接口开发，我们还有一段路要走。希望这本书，可以陪你更好、更顺畅、更愉悦地度过这段美妙的旅途！
资兴网站推广【资兴办理400电话】资兴SEO优化、资兴微信公众号APP客户端小程序开发、资兴网站托管、资兴APP开发
