我不知道如何实际提出我的问题,但它来了:
我的老板希望我用 PHP 为我们的在线购物网站创建一个简单的 MVC,我做到了(观看 youtube 等),它非常简单且易于制作。
现在他一直要求我:
首先创建一个 RESTful API(使用curl)。
其次创建一个有据可查的 SDK!
我已经搜索了很多(真的),我知道我可以理解 API 的作用,但我不确定什么是 SDK 以及如何开始编写代码
有人可以给我一行如何开始编写的示例代码吗?
他所说的**有据可查**是什么意思?
我在谷歌中搜索过,我知道 SDK 和 API 的字面意思是什么,但我的问题是我无法在我的 MVC 和 API 和 SDK 之间建立关系。
我如何开始编写 API?
我应该从哪里开始?
重点是什么 ?
有人能给我举个例子吗?
我的 SDK 应该做什么?
我看过很多关于 API 的视频,它们都谈到使用 REST,REST 非常好,我们应该使用 GET/POST/DELETE/PUT 等等,等等。
但我应该从哪里开始呢?
编辑
就我而言,在线购物只需搜索我们的 MongoDB 数据库并返回新产品和其他一些简单任务,我应该如何使用 RESTful API?还是SKD?
谢谢,如果解释不明白请告诉我。
看来您有一项任务在等着您。
Restful 路由是一种通过标准与服务器通信的方式HTTP protocols。这些是诸如GET,,,,等等之类POST的东西......PUTDELETE
当以静态方式路由时,您不需要调用不明确的方法来检索、更新或删除服务器上的数据。
例如,当尝试从服务器检索用户时,您可能调用了http://domain.tld/getAllUsers.php. 这并不平静。
但是,如果您通过调用 来检索所有用户,http://domain.tld/users/并指定您希望通过GET内置于 中的 来访问此调用HTTP protocol,则这将是restful。
网上有很多资源可以帮助您了解更多信息restful routing。
APIs是Application Programming Interafaces。例如,当您使用restful routing构建应用程序时,您也在实现API,因为您为其他人提供了访问您服务器上的数据的方法。
然而,一切APIs都不是restful。事实上,很多都不是,而且这些更难application programmers学,因为它们不遵循standard.
关于这一点的书籍有很多APIs,我在这篇回答中无法涵盖。我推荐的一本书是Build APIs You Won't Hate菲尔·斯特金(Phil Sturgeon)写的。
SDKs虽然Software Development Kits大多数时候它们非常广泛,但restful API您将开发的内容将构成SDK.
但这可能不是你老板想要的,这是你必须问他的。
记录良好的代码易于阅读和理解。这需要很好地掌握目标受众使用的语言。
编写优秀文档的第一步是编写注释良好的代码。 拥有经过良好注释的代码是您可以拥有的最好的文档,在编写代码后,您可以使用诸如为PHPDoc您生成文档之类的工具。这一代人可能没有你想要的那么广泛,这只意味着你需要更多的评论。
通读其他开发人员的代码,这些开发人员已经实现了您正在寻找的东西。在这种情况下我有偏见,因为它是我当前选择的框架,但Laravel它在PHP MVC framework这一切方面都做得很好。该代码也有很好的文档记录并且易于理解。
此外,还有很多写得很好的软件包可能对您有帮助,如果您还没有的话,Packagist您应该检查它们并研究一下。Composer
如果有人阅读本文发现错误,请纠正我。