把AI模型接进自己的网页应用,未必需要一套沉重的工程栈。更轻的做法是:前端只留HTML/CSS/JS,后端用一个简单的PHP脚本充当安全的API代理。这套架构的重点不在复杂,而在把该藏的东西藏住。

问题出在前端直连。如果在JavaScript里用fetch直接调用外部AI接口,比如Groq或Gemini,API密钥会完整暴露在浏览器的网络面板里。任何人打开开发者工具都能看到它。把请求改道到服务端的api.php处理,能同时解决两件事:密钥留在服务器一侧;用户输入可以在到达外部接口之前被清洗、系统提示词可以被格式化、请求频率也能被控制。

一次请求的完整路径是这样的:

  • 前端app.js捕获用户消息,先乐观地更新界面,再把JSON数据以异步POST方式发给api.php。
  • 后端api.php读取传入的JSON负载(file_get_contents('php://input')),附上授权头,通过PHP cURL把提示词转发出去。
  • 拿到AI服务商返回的JSON后解析,把干净的文本送回前端。

在Windows本地用XAMPP/Apache测试这套结构时,有两个坑经常绊住开发者。其一是cURL的SSL证书错误:本地环境往往缺少更新的CA证书包,请求会静默失败或抛出网关错误。本地测试阶段把CURLOPT_SSL_VERIFYPEER设为false,或者在php.ini里正确配置cacert.pem,都能解决握手问题。其二是502 Bad Gateway或超时错误:应当设置合适的CURLOPT_TIMEOUT,并检查curl_error($ch),让后端返回一条清晰的JSON错误信息,而不是无声崩溃。

栈保持简单,注意力才能落在真正重要的地方:用户体验、提示词工程,以及把能用的工具尽快做出来。