后端API接口开发

后端与前端的关系在 网络操作与接口请求 章节中已经讲解过，这里不再过多赘述，本章我们将讲解如何在 VcnStudio 的网页程序中编写后端接口。

后端接口的主要作用

由于前端页面无法直接访问数据库，因此要想操作数据，保存数据，就必须使用后端功能，而前端要访问后端，则必须通过接口访问。

因此后端接口的主要作用相当于是一个桥梁，并且同时负责将后端数据传递给前端。

开始编写

首先在IDE的工程窗口中（这里假设IDE已经打开了一个项目），选中程序集节点，右键新建文件：输入API文件名称，建议为英文，然后选择 文件类型 为 服务端接口 ，点击确定。

IDE会自动创建接口文件并在编辑器中打开；默认的接口文件代码为：

' 只要该接口被请求，该事件就会被触发
事件 文件被请求()
    输出 "接口被请求..."
结束 事件

' 在前端通过发送GET、POST请求、或使用“请求接口”函数调用该函数
' 前端地址：http://xxx.com/本文件名.php?a=测试输出
函数 测试输出()
    输出 "你发送的请求接收成功；这是反馈信息！"
结束 函数

函数 获取时间()
    输出 "当前时间：" + 格式化时间("Y-m-d",取现行时间戳())
结束 函数

其中在每个 API 文件中，都有一个必须存在的事件：

' 只要该接口被请求，该事件就会被触发
事件 文件被请求()
    输出 "接口被请求..."
结束

该事件类似接口的入口，只要当该接口被请求时，系统都会首先回调该事件，然后再执行其它操作。

例如：

假设接口文件名称为 Api.sph

在浏览器中访问：http://xxx.com/Api.php?a=测试输出

接口文件首先将回调执行 “文件被请求” 事件，然后再执行 “测试输出” 函数。

接口函数

除了默认的事件外，要实现接口其它功能，都需要使用函数实现。

接口中函数的语法与网页中的函数语法完全一致，参考：额外语法特性

接口地址规则

在使用轻语言网页框架编写后端接口时，我们需要遵循一定规则；详细规则如下：

1.接口文件名称，编译后的文件后缀为 .php ,假设你创建的接口名称为：wodejiekou.sph 当编译后该文件将编译为 wodejiekou.php

2.接口地址中调用接口函数的参数名称 a 为固定的名称，表示执行的动作 action ，后面跟待执行的函数名称。

标准地址格式为：

http://域名或IP加端口/接口名称.php?a=待执行函数
例如：
http://demo.vcnstudio.com/MyApi.php?a=TestOut
http://123.122.0.100:1995/MyApi.php?a=TestOut