PHP 接口怎么实现

在日常做网站或小程序时，我们常听到“接口”这个词——比如你点外卖时，商家能实时看到订单、骑手能同步位置，背后靠的就是不同系统间的“接口”在传数据。PHP作为入门门槛不高的后端语言，很多新手想先从简单的接口练手，比如做一个返回天气或待办事项的小接口，先解决实际问题，再慢慢深入复杂功能。

先搞懂：PHP接口到底是啥？

不用把它想得太复杂，你可以把PHP接口当成“一个带规则的快递柜”：前端（比如手机上的外卖APP）把要查询的内容（比如“我要点的奶茶订单”）当成快递，按照约定好的格式放进柜子；PHP写好的接口就是快递柜的管理员，它会按约定的规则检查快递、找到对应的内容，再把结果（比如订单状态）以统一格式（比如常用的JSON）返回给前端。

举个生活化的例子：你手机上的天气APP，要获取上海的天气数据，得先给天气接口传“上海”这个城市名，接口核对后返回“25度，晴天”这类结果，这个“传参-返回”的过程，就是PHP接口在工作。

第一步：搭建最基础的PHP接口

新手做接口，从最常用的“GET请求”接口开始练手——GET就是前端直接在网址后加内容，比如http://你的网站地址/weather.php?city=上海，这样就能把“上海”传给接口。

我们先写一个最简单的demo：

先建一个名叫`weather.php`的文件；

• 打开它，先设置返回内容的格式：告诉前端，我们返回的是方便读取的JSON格式，不会乱码；
• 再拿到前端传的城市名：用PHP的$_GET变量，就能拿到网址里city=后面的内容；
• 最后返回结果：如果前端传了城市，就输出“上海今天25度”，如果没传，就提示“请输入城市名”。

这段代码只有几行，完全不用懂复杂术语，复制后放到支持PHP的服务器里，就能直接用——比如你把文件传到自己的虚拟主机，输入对应网址，就能看到返回的结果，这就是一个能用的PHP接口了。

第二步：加个常用的POST接口（应对传复杂数据）

如果要传用户名密码、提交表单这类复杂内容，就得用POST接口，它不会把数据显示在网址里，更安全。比如做一个简单的留言提交接口：

还是建一个`message.php`文件；

同样先设置JSON格式；

• 用PHP的$_POST变量拿数据：比如前端传了username和content，就取出这两个内容；
• 最后可以把数据存到本地的文本文件里，或者直接返回“留言提交成功”的结果。

这里要注意一个小细节：新手容易踩的坑——跨域。比如你在自己电脑上用浏览器打开前端页面，去调用另一台服务器上的PHP接口，浏览器会报错“跨域请求被阻止”。解决方法很简单，在PHP文件最开头加两行代码，告诉服务器允许其他网站访问就行，就像给快递柜开了个对外通道，不会拦着正常的请求。

第三步：让接口更实用的小技巧

基础接口做好后，想让它更贴合实际使用，还有两个简单的优化：

一是加参数校验：比如你做的天气接口，不能让用户随便传个“12345”当城市名，得先判断前端传的内容是不是符合规则，不符合就返回错误提示，避免接口乱干活；

二是加数据返回状态：比如用code=200表示成功，code=400表示参数错误，code=500表示接口出错，这样前端能根据状态判断该怎么显示内容，比如成功就显示天气，错误就提示“请输入正确的城市名”。

其实PHP接口的核心就是“按规则传数据、按规则返回数据”，不用一开始就追求复杂功能，从GET、POST接口练手，解决日常小需求，慢慢就能掌握——很多网站的小功能接口，都是用类似的简单逻辑实现的，只要把基础规则搞懂，再结合实际需求调整，就能做出能用的PHP接口。