文档首页 下一章


编程于我们,犹如著书而存世。表达,从简单开始;代码,亦然。 -- 暗夜在火星

接口,从简单开始!

一个隐喻

假设我们有这样的表达式:

1 + 1 = 2

显然,这是简单明了而易于理解的。但倘若我们这样:

1 + (96 - 867 + 700 - 6 + 7 - 30/10 + 100  - 27) +  1 = 2

同样可以获得相同的结果,但表达却羞涩难懂。

你可能会偷笑:怎么可能会有人这样编写复杂又没用的代码呢?然而,如果你回顾一下曾经做过的项目或留意一下周围的代码,你会发现,这种情况是真实存在的。

当然,在不同领域的项目开发中,因各自需求不同各代码的编写也不尽相同。纵使这样,即使我们不能简化到最理想的状态,但至少我们可以通过努力以达到“编写人容易理解的代码”。一如这样:

1 + (0) +  1 = 2

PhalApi框架所做的

使用PhalApi框架进行项目开发,我们不能保证项目编写的代码一定会“短而美”,因为更多的代码编写来自于你双手的输入、来自你自己切身的思考和设计。但我们希望PhalApi可以在支持接口快速开发的基础上,为你和更多开发团队提供关于项目开发的一些技艺、参考和帮助。

所以,与其他很多关注服务器性能的框架不同, PhalApi更加关注的是人的心情、开发效率和团队合作 ,而这些正是通过测试驱动开发、自动化工具、持续集成和敏捷开发等途径来达成的 。

然而,这一切一切,都要从代码的编写开始。毕竟我们作为专业人士,代码是我们连接世界的媒介。而接口代码的编写,又应从简单开始。

泡一杯咖啡,让我们开始吧。

本框架和文档适用于

  1. 工匠:基于PHP语言的后台接口项目开发,特别是创业项目的快速迭代
  2. 探险者:进行定制和扩展,打造成公司内部产品簇的接口应用框架
  3. 架构师:专注框架的设计、思想和开源

文档首页 下一章