跨语言接口-它们存在吗？

Question

我想知道，这些天我修复了旧的web应用程序，我经常会遇到同样的问题，我无法找到解决方案。

Javascript应用程序通常从其他来源获取数据。在我的例子中，它是php。这些Javascript应用程序期望以某种方式提供给它们的数据，如果它们不以特定的方式获取数据，就会发生错误，应用程序就会中断。

这可能很难调试，因为如果有人决定编辑php函数(例如，提供数据的php函数)，他们通常不会从他们的现代IDE中得到任何提示，即数据可能以不正确的方式返回。

例如，您是否可以在php和javascript之间创建一个接口，以便它们都需要遵守它呢？就像php接口一样。

我还知道，例如，当您使用类型记录时，您可以为javascript应用程序创建一个接口。然后您可以为php创建相同的接口。

Answer 1

正如其他人所暗示的那样，您在这里寻找的是一个模式，它指定输入和输出的格式；和一个更广泛的契约，它以URL、方法名称等的形式指定操作。

对于XML，模式很可能是使用XML或RelaxNG指定的；对于JSON，则可能有JSON和其他模式。

更广泛的契约将因API的风格而有很大的不同。WSDL文件通常用于定义SOAP (这只是XML的一个特定约定)，Swagger和OpenAPI等工具可以指定REST风格的API，通常使用JSON。

然后，所有这些都可以输入到工具中，这些工具可以自动生成实现符合其约定的测试，以及文档等。这些测试和文档实际上是您的目标:对于一个具有大量AJAX调用但没有形成一致API的遗留网站，最好的起点可能是一系列单元测试，这些测试可以确认相同的输入在您进行更改后提供相同的输出。

Answer 2

脑海中唯一想到的是SOAP，其中WSDL文档给出了有关SOAP函数的信息(包括。参数和数据类型)及其响应。它是众所周知的，因为它是用XML的，所以它是独立于语言的.

我不知道IDE是如何支持的，但是这个标准已经存在了一段时间(至少从2001年开始)，所以我认为应该有一些插件可以让您的生活更轻松。

如果您控制服务器，也许可以在节点上运行PHP，这样您的Javascript/ type Typescript应用程序就可以直接与Node服务器通信，并使用类型记录类型定义。但我猜这不是一个选择:)