零基础装 symfony 并跑出第一个 api 接口，核心就三步：环境确认（php≥8.2+五大扩展）、项目创建（symfony new myapi --webapp）、控制器写法（make:controller + json()返回），10分钟内可完成，无需改php.ini或服务器配置。
零基础装 Symfony 并跑出第一个 API 接口，核心就三步：环境确认、项目创建、控制器写法。不用改 php.ini，不碰服务器配置，10 分钟内可完成。
确认 PHP 和 Composer 已就绪
打开终端，逐条执行以下命令，全部通过才算环境合格：
- php -v → 必须显示 ≥ 8.2（2026 年主流要求），注意是命令行输出，不是网页 phpinfo
- php -m | grep -E "(intl|mbstring|xml|curl|fileinfo)" → 五个扩展必须全在列表中，intl 最常被漏装，务必检查
-
composer -v → 有版本号即 OK；国内用户建议提前设镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若提示 “plugins are disabled”，立刻运行：
composer config -g allow-plugins true
用 Symfony CLI 创建项目（新手首选）
比纯 Composer 更省心，自动带完整开发栈：
-
macOS：运行
brew install symfony-cli/tap/symfony-cli -
Linux：运行
wget https://get.symfony.com/cli/installer -O - | bash - Windows：去 symfony.com/download 下载安装程序
- 验证安装：
symfony -v有输出即成功 - 建项目：
symfony new myapi --webapp（注意：--full 已弃用，新版统一用 --webapp）
编写并测试第一个 JSON 接口
进项目目录后，两步到位：
- 生成控制器：
php bin/console make:controller ApiController（如提示 command not found，先运行composer require --dev symfony/maker-bundle） - 编辑
src/Controller/ApiController.php，替换内容为：
namespace App\Controller;<br>use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;<br>use Symfony\Component\HttpFoundation\JsonResponse;<br>use Symfony\Component\Routing\Annotation\Route;<br><br>class ApiController extends AbstractController<br>{<br> #[Route('/api', name: 'api_index')]<br> public function index(): JsonResponse<br> {<br> return $this->json([<br> 'msg' => 'Hello from Symfony API!',<br> 'timestamp' => date('c')<br> ]);<br> }<br>}
- 启动服务：
symfony server:start - 浏览器或 curl 访问 https://www.php.cn/link/d72fc7120e28e5a50fbe5c27f5f9c80b，看到 JSON 响应即成功
常见问题快速排查
如果接口打不开或报错，优先查这三项：
- 500 错误或白屏 → 先清缓存：
php bin/console cache:clear，再确认var/cache和var/log目录可写 - 返回 404 → 运行
php bin/console debug:router看api_index是否在列表里 - 内容不更新 → 检查
.env文件中是否已启用开发模式：APP_ENV=dev和APP_DEBUG=1
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
