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

接口,从简单开始!

一个隐喻

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

  1. 1 + 1 = 2

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

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

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

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

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

  1. 1 + (0) + 1 = 2

PhalApi框架所做的

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

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

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

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

本框架和文档适用于

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

    还有疑问?欢迎到社区提问! 切换到PhalApi 2.x 开发文档。

原文: https://www.phalapi.net/wikis/%E6%8E%A5%E5%8F%A3%EF%BC%8C%E4%BB%8E%E7%AE%80%E5%8D%95%E5%BC%80%E5%A7%8B%EF%BC%81.html