_编程于我们,犹如著书而存世。表达,从简单开始;代码,亦然。 -- 暗夜在火星_
##接口,从简单开始!
###一个隐喻
假设我们有这样的表达式:
```
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. 架构师:专注框架的设计、思想和开源
- 欢迎使用PhalApi!
- 接口,从简单开始!
- [1.1]-下载与安装
- [1.2]-创建一个自己的项目
- [1.3]-在线体验
- [1.4]-文档、帮助和官网
- [1.10]-对PhalApi框架的抉择
- [1.11]-快速入门(backup)
- [1.12]-参数规则:接口参数规则配置
- [1.13]-统一的接口请求方式:_sevice=XXX.XXX
- [1.14]-统一的返回格式和结构:ret-data-msg
- [1.15]-数据库操作:基于NotORM的使用及优化
- [1.16]-配置读取:内外网环境配置的完美切换
- [1.17]-日记纪录:简化版的日记接口
- [1.18]-快速函数:人性化的关怀
- [1.19]-DI服务速查:各资源服务一览表
- [1.20]-DB操作:数据库基本操作速查
- [1.21]-类的自动加载:遵循PEAR包的命名规范
- [1.22]-签名验证:自定义签名规则
- [1.23]-请求和响应:GET和POST两者皆可得及超越JSON格式返回
- [1.24]-缓存策略:更灵活地可配置化的多级缓存
- [1.25]-国际化翻译:为走向国际化提前做好翻译准备
- [1.26]-数据安全:数据对称加密方案
- [1.27]-精益开发:更富表现力的Model层和重量级数据获取的应对方案
- [1.28]-COOKIE:对COOKIE原生态的支持及记忆加密升级版
- [1.29]-开放与封闭:多入口和统一初始化
- [1.30]-保持的力量:接口开发最佳实践
- [1.31]-新型计划任务:以接口形式实现的计划任务
- [2.11]-核心思想:DI依赖注入-让资源更可控
- [2.12]-海量数据:可配置的分库分表
- [2.13]-接口调试:在线SQL语句查看与性能优化
- [2.14]-测试驱动开发:意图导向编程下的接口开发
- [2.15]-演进:新型计划任务续篇
- [2.16]-领域驱动设计:应对复杂领域业务的Domain层
- [2.17]-微服务:Api接口服务层
- [2.18]-定制化:资源服务的再实现
- [2.19]-扩展库:可重用的扩展类库
- [2.20]-约定编程:架构明显的编程风格
- [2.21]-服务器统一部署方案简明版:CentOs---Nginx---php-fpm---MySql-[--Memcached]
- [2.22]-更多工具:精益项目和团队建设
- [3.1]-扩展类库:微信开发
- [3.2]-扩展类库:代理模式下phprpc协议的轻松支持
- [3.3]-扩展类库:基于PHPMailer的邮件发送
- [3.4]-扩展类库:优酷开放平台接口调用
- [3.5]-扩展类库:七牛云存储接口调用
- [3.6]-扩展类库:新型计划任务
- [3.8]-扩展类库:用户、会话和第三方登录集成
- [3.9]-扩展类库:swoole支持下的长链接和异步任务实现
- [3.11]-扩展类库:基于FastRoute的快速路由
- [4.2]-开发实战2:模拟优酷开放平台接口项目开发
- [4.3]-开发实战3:一个简单的小型项目开发(奔跑吧兄弟投票活动)
- [5.1]-架构与思想:PhalApi核心设计和思想解读
- [5.2]-杂谈:扯一些PhalApi的前世和今生
- [5.3]-框架总结:术语表和PHP开发建议
- [5.4]-许可
- [5.5]-联系和加入我们
- [5.6]-更新日记
- [5.8]-致框架贡献者:加入PhalApi开源指南
- [6.1]-基于接口查询语言的SDK包
- [6.2]-SDK包(JAVA版)
- [6.3]-SDK包(PHP版)
- [6.4]-SDK包(Objective-C版)
- [6.5]-SDK包(javascript版)
- [6.6]-SDK包(Ruby版)
- [8.1]-PhalApi视频教程
- 附录1:接口文档参考模板