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

靖江网站制作【靖江网站优化】靖江建网站、靖江微信公众号运营、靖江网页设计、靖江微信小程序商城

靖江市，简称靖，江苏省辖县级市，由泰州市代管，位于泰州市东南部，介于北纬31°56′－32°08′，东经120°01′－120°33′之间，属亚热带季风气候，是江苏省新兴的港口工业城市，总面积665平方公里。截至2019年，靖江市常住人口达68.46万人。 [1-3] 

明成化七年（1471年），始置靖江县，属常州府。1996年7月19日，地级泰州市设立，靖江市改由泰州市代管。 [4]  截至2019年，靖江市辖1个街道、8个镇；另辖5个乡级单位。 [5] 

2019年，靖江市实现地区生产总值979.57亿元，同比增长7.2%。按常住人口计算全年人均GDP为143066元。分产业看，第一产业实现增加值25.70亿元，增长2.1%；第二产业实现增加值540.91亿元，增长6.5%；第三产业实现增加值412.96亿元，增长8.5%，第三产业增加值占GDP比重比上年提高1.4个百分点。 [1]  2020年12月，社科院发布《全国县域经济综合竞争力100强》，靖江排名第30 [6]  。

这一章将以PhalApi为立足点，却又超越PhalApi这一具体成例，讲述如何设计接口框架。

9.1 正统

任何一个开源框架，或者说任何一个负责任、正式的开源框架，它都不是一时兴起，或者是随意而为的。如果真的打算设计一个接口框架，至少要把它摆上台面，并按照一定的流程规范、遵循既有的约定和惯例。这意味着不仅需要投入大量时间长期维护，还需要花费心思和精力、秉持着严谨的态度，以及团队或社区的参与和支持。只有这样，一个接口框架才能称得上正统。而一个正统的框架，更是值得我们为之努力，为之投入。

正统是美好的，但美好的事情，在实现过程中难免会困难重重，正如毛主席所说的“人间正道是沧桑”。所以，要做好思想准备，因为很可能你将会开始“新的长征”……

9.1.1 定位

研发一个框架和研发一个产品，有点类似但又有所区别。相同的是它们都有特定的目标人群，定位和价值观。其中就定位而言，在准备着手研发接口框架之前，事先确定好接口框架的应用领域是非常重要的。最好是能用一句话来高度概括，如PhalApi最初以及到现在的定位都是：致力于快速开发接口服务。

如果再细分一下，可以加上前置约束条件，如使用在哪些范畴。例如：

“PhalApi是一个PHP轻量级开源接口框架，致力于快速开发接口服务。”

9.1.2 正名

孔子曾有云：“名不正，则言不顺；言不顺，则事不成”。由此可见，在我国很早之前就已经知道命名的重用性。立身必先正其名，对如今研发一个接口框架同样是不可轻视的。通过一个名字，可以向外界传递的信息，包括有意识的、无意识的以及潜意识的，都是非常丰富且影响微妙。

所起的名字应该能起到自我解释的作用，即能清晰地说明，或者让人明白此框架是属于PHP实现的接口框架，这样既可以方便记忆，容易理解，又能提高搜索命中率。

PhalApi的名字，后半部分为“Api”，即表示此框架是专注于接口服务领域的。以字母P开头，让熟悉PHP的技术开发人员能都容易记得住。而前缀“Phal”则是参考了著名优秀的开源框架Phalcon的名称，这里使用了相同的前缀并不是因为想像Java那样想借Phalcon的名气，而是抱着一种向Phalcon学习、以它为师的态度。

PhalApi这一书面语，虽然显得正式、容易让人理解，但是不好发音。看似优雅，实际在口头沟通上不好表达，因为它本身就是一个视觉型的名字。由此就需要更为简单的发音、能够传递PhalApi框架的精神和文化的中文名——π框架。

取中文名为“π框架”，其含义有：

• π取自派发音（pai），容易记忆，与框架名字谐音

• π是无理数，无限循环，符合PhalApi不断更新、保持生气的初衷

• π是圆周率，代表着我们中国的历史文化

• π是一个数学符号，而数据与计算机编程又有着不可分割的微妙联系

• π也是一个可以继续精化的数字，体现着PhalApi希望能够敢为人先，专注接口，汇众之长，自成一派！

框架的发音，以一个发音为优，其次为两个发音，最后是三个发音。尽量避免使用更多发音的名字。如我们熟悉的主流框架，它们的名字，如果细细品读，都是在三个发音以内，例如：Yii、Slim、Laravel、Symfony。

9.2 在开始之前

人类一思考，上帝就发笑。

想好了框架的名字，明确好框架的定位好，先不要着急敲打键盘编写第一行代码。正如在开始写作之前，先不要着急动笔写第一句话。应该安静下来，作为框架的设计者和创始人，认真、全面、深入地思考几个问题：最终用户会（或者说期望）如何使用这个框架？开发人员将会基于此框架进行怎样的开发？还有没有什么方面暂时没想到的……

随着你思考得越多，你就会发现得越多，自然而然就会收获得更多。

9.2.1 揣测它的使用

内在物质

揣测框架最终是如何被使用的，是非常有趣的。不同的使用方式，带来的效果不同，给技术人员的开发体验也不尽相同。不管怎样，框架的使用应该保持简单，并尽可能适用于任何场景。那怎么做到简单却又能应用于任何场景呢？让我们结合PhalApi的示例代码细细解读一下。

抛开初始化和其他操作不算，PhalApi的使用只需要三行代码即可，如下所示：

$api = new PhalApi();$rs = $api->response();$rs->output();复制代码

但这三行代码，背后所隐藏的信息量非常大。如果不细细品读，很可能会不轻易错过很多重要的信息。这三行代码如此重要，甚至值得我们逐行分析。

第一行代码，创建了一个PhalApi实例，这是很多框架常见的手法。即通过与框架名字相同的类来启动或者创建实例。并且最好的情况是，此时不需要任何参数，或者至少不需要任何必须的参数。这有利于减少初始化的成本，降低初学者的心理压力。通常对于不需要参数的案例，新手都会在潜意识地告诉自己：啊哈！这个框架使用很简单！

$api = new PhalApi();复制代码

创建好框架实例后，下一步自然就是使用它，重点在于如何使用。按理说，使用应该也是一行代码就能完成是最好的。因为我（相信很多开发人员都）很喜欢创建好一个实例后，简单启动一下它就能帮我完成剩下全部其他的事情。试问，到现在，如果不看任何帮助资料，还有多少人记得如何创建一个TCP的链接？

如何不能简单地一步做到，那就需要有充分的理由。显然，PhalApi这里的使用分为了两步。为什么？理由很简单，也很充分，因为需要应用于更广阔的领域。这两步将接口的响应执行与结果的输出进行分离，首先是响应执行：

$rs = $api->response();复制代码

其次是结果的输出：

$rs->output();复制代码

虽然是三行代码，但它们之前的联系是非常紧密，并且依赖顺序明显。因为前面一行代码的结果，是下一行代码的操作对象。除了执行顺序明显外，更重要的是通过将执行响应与结果输出分离，可以适用于更多的场景，除HTTP外更多其他的协议。例如，当需要进行单元测试时，获得结果后并不需要输出，而是直接对返回的结果对象数据进行验证即可，也更为方便。

靖江网站制作【靖江网站优化】靖江建网站、靖江微信公众号运营、靖江网页设计、靖江微信小程序商城

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

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