PHP框架非必需，但能提升效率；新手应先掌握原生API开发三要素（正确header、状态码、json_encode），再深入Laravel/ThinkPHP的路由、中间件、CORS及响应格式等关键配置。
PHP框架不是必须的，但用对了能省掉大量重复工作；新手直接上 Laravel 或 ThinkPHP 容易卡在路由、中间件、JSON响应格式这些细节里，不是代码写不出来，而是不知道哪一步该返回什么、header 怎么设、错误怎么处理。
怎么让一个 PHP 文件直接变成可访问的 API 接口
别急着装框架。先确认你有 Web 服务器（如 Apache 或 Nginx）且支持 index.php 入口。新建一个 api/user.php，内容如下：
0,
'data' => ['id' => 1, 'name' => '张三'],
'msg' => 'success'
]);
访问 http://localhost/api/user.php 就是合法的 API 响应。关键点只有三个：header 设对类型、http_response_code 显式设状态码、json_encode 输出。漏掉任意一个，前端可能收不到 JSON 或解析失败。
Laravel 路由返回 JSON 时常见的 404 和 CORS 错误
用 php artisan serve 启动后，如果访问 /api/users 返回 404，大概率是没加 api 前缀或没启用 API 中间件。Laravel 的 routes/api.php 默认自动加 /api/ 前缀，且绑定 api 中间件组——这个组默认包含 throttle:api 和 bindings，但不包含 cors。
立即学习“PHP免费学习笔记（深入）”；
遇到跨域报错（如 No 'Access-Control-Allow-Origin' header），不要直接改 header()，而是在 app/Http/Kernel.php 的 $middlewareGroups['api'] 里加上：\App\Http\Middleware\Cors::class（需自己写一个简单中间件），或者装 fruitcake/laravel-cors 并按文档发布配置。
- 别在控制器里用
return response()->json(...)以外的方式输出（比如 echo） - 别在
routes/web.php里定义 API 路由，它走的是 web 中间件，会触发 session 启动和 CSRF 验证 - 测试时用
curl -I http://127.0.0.1:8000/api/users看响应头，比浏览器更准
ThinkPHP6 写接口最容易忽略的两个配置项
TP6 默认开启「多应用模式」，但新手常把接口全写在 app/index/controller 下，结果请求 404——因为 index 是应用名，而 API 应该放在 app/api 目录，并在 route/app.php 里显式绑定：Route::domain('api', 'api'); 或直接用 Route::group('api', [...])。
另一个坑是 JSON 输出自动包装。TP6 的 return json(...) 默认会加一层 data 包裹，比如你写 return json(['code'=>0])，实际返回的是 {"code":0,"data":{}}。这不是 bug，是内置的「统一返回格式」逻辑，在 app/common/Response.php 或中间件里被注入了。要关掉它，得在 app/middleware.php 中移除 think\middleware\Jsonp 或自定义响应类。
-
config/app.php中的'default_return_type' => 'json'必须设为json，否则 return 数组不会自动转 JSON - 调试时打开
app/debug.php中的'show_error_msg'，不然 500 错误只显示空白页 - 别用
dump()或var_dump()，它们会破坏 JSON 结构，用trace()或日志写入
真正卡住新手的，从来不是语法，而是 HTTP 协议层的隐性约定：状态码含义、Content-Type 是否匹配、CORS 头是否存在、JSON 是否合法。框架只是帮你封装这些，但封装得太深，反而让人看不见底层发生了什么。
