10分钟跑通 Symfony 7.2 第一个 JSON 接口【极简教程】-php教程-PHP中文网

能，10分钟内跑通可访问的json接口：需确保php≥8.2且intl/mbstring/xml/curl/fileinfo五大扩展齐全、symfony cli正确安装；用symfony new --webapp创建项目，symfony server:start启动，编写带@route注解的控制器并返回jsonresponse，通过curl验证响应头与内容。

10分钟跑通 symfony 7.2 第一个 json 接口【极简教程】

能，10 分钟内跑通一个可访问的 JSON 接口，前提是环境已达标（PHP ≥ 8.2、五大扩展齐全）、没跳过 symfony CLI 工具安装——这两点卡住的人占八成，不是代码问题。

确认 PHP 环境和 Symfony CLI 是否真就绪

别信 phpinfo 页面或 IDE 显示的版本，终端里逐条敲：

php -v → 必须输出 8.2.x 或更高；低于则换版本（如 via brew install php@8.2）
php -m | grep -E "^(intl|mbstring|xml|curl|fileinfo)$" → 必须一次性打出这五个模块名；intl 在 macOS 上最常缺失，补装命令：brew install icu4c && pecl install intl
symfony -v → 要有输出（如 v5.12.3），没有就重装 CLI（Linux/macOS 用 wget https://get.symfony.com/cli/installer -O - | bash）

用 --webapp 创建项目并启动服务

--webapp 是当前唯一推荐的起点，它自带 Twig、MakerBundle、Doctrine 和 WebProfiler，省掉手动配一堆包的麻烦。别用 --full（已弃用）或 skeleton（缺调试工具，JSON 接口出错时连堆栈都看不到）。

Revealjs Presentations

创建、编辑并部署 reveal.js 演示文稿为单个 HTML 文件，可选自定义 CSS。适用于需要制作演示文稿、幻灯片或宣传材料时使用。

下载

执行：symfony new myapi --webapp（等待绿色 “Project successfully created”）
进目录：cd myapi
启动：symfony server:start（不是 php -S，CLI 自带 HTTPS 和热重载）
浏览器打开 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913，看到欢迎页 + 右下角紫色调试栏（WDT）才算环境通

写控制器返回 JSON，绕开三个典型坑

直接用 JsonResponse，别手拼 json_encode() + Response，否则 Content-Type 错、中文乱码、null 报错全齐了。

生成控制器：php bin/console make:controller Api/HelloController
编辑 src/Controller/Api/HelloController.php，把 index() 方法改成：

use Symfony\Component\HttpFoundation\JsonResponse;
<p>public function index(): JsonResponse
{
return new JsonResponse(['message' => 'Hello from Symfony 7.2!', 'timestamp' => time()]);
}</p>

别忘了加路由注解：@Route("/api/hello", name="api_hello")（放在 index() 上方）
关键避坑点：
– 不要 return Response::create(json_encode(...))，header 不自动设
– 不要在 return 前 echo 或 var_dump，会触发 headers already sent
– 别传 Doctrine 实体对象进 JsonResponse，循环引用直接 500；先调 $user->toArray() 或用 DTO

验证接口是否真返回 JSON

浏览器直接访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913/api/hello 时，如果看到纯 JSON 文本（无 HTML 包裹），且响应头里有 Content-Type: application/json，就算成功。但更稳的验证方式是用 curl：

curl -I https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913/api/hello → 看 HTTP/2 200 和 content-type: application/json
curl https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913/api/hello → 输出应为 {"message":"Hello from Symfony 7.2!","timestamp":1722942...}
如果返回 HTML 页面或白屏，90% 是控制器没加 @Route 注解，或没重启服务器（symfony server:stop && symfony server:start）

真正容易被忽略的是：调试栏（WDT）必须亮着——它不只用来查 SQL，更是证明 kernel.debug = true 的唯一现场证据；没它，APP_DEBUG=1 可能在 .env 里写了，却因缓存或环境变量加载顺序失效。