symfony 6.4.48可快速搭建干净可扩展的api后端：用skeleton创建最小项目，require api和maker-bundle，加@apiresource注解自动生成rest端点，配nelmio/cors和lexik/jwt实现跨域与无状态认证，sqlite起步，支持php 8.1+及openapi文档。
直接用 Symfony 6.4.48 搭建前后端分离后端应用，关键不是“从零写所有”，而是快速建立一个干净、可扩展、符合现代 API 实践的结构。这个版本（2026 年仍在 LTS 支持周期内）已原生支持 PHP 8.1+、API Platform 集成友好、CORS 和 JWT 配置成熟，不用手动拼凑一堆包。
初始化项目并确认运行环境
用 Composer 创建标准 Symfony 后端项目：
- 执行
composer create-project symfony/skeleton my-api，它会拉取最小骨架，不含 Webpack 或 Twig —— 这正适合纯 API 场景 - 进入目录后运行
composer require webapp（可选）或更推荐：只加真正需要的组件，比如composer require api symfony/maker-bundle --dev - 确保 PHP 版本 ≥ 8.1（Symfony 6.4 不支持 PHP 8.0），终端执行
php -v核对；若报错Failed loading /path/to/xdebug.so，说明 Xdebug 版本与 PHP 不兼容，临时禁用或升级
启用 API 功能与基础路由
Symfony 6.4 默认不开启 API 模块，需显式启用：
- 运行
composer require api安装 ApiPlatform，它会自动注册ApiPlatform\Core\Bridge\Symfony\Bundle\ApiPlatformBundle - 创建一个简单实体，例如
php bin/console make:entity Product，添加字段如name:string(255)、price:float - 在实体类顶部加注解：
@ApiResource（来自ApiPlatform\Metadata\ApiResource），它会让框架自动生成 GET/POST/PUT/DELETE 端点 - 访问
http://localhost:8000/api（运行symfony server:start后），能看到 OpenAPI 文档界面 —— 这就是你的第一个可用 API 入口
配置跨域与无状态认证
前后端分离意味着前端域名和后端不同，必须处理 CORS；同时登录态不再依赖 Session，改用 Token：
- 安装 CORS 包：
composer require nelmio/cors-bundle，然后在config/packages/nelmio_cors.yaml中设置允许的前端地址，例如origin_regex: '^https?://(localhost|127\.0\.0\.1):[0-9]+$' - 认证推荐使用
lexik/jwt-authentication-bundle（兼容 Symfony 6.4）：composer require lexik/jwt-authentication-bundle - 生成密钥对：
mkdir -p config/jwt && openssl genpkey -out config/jwt/private.pem -aes256 -algorithm rsa -pkeyopt rsa_keygen_bits:4096，再导出公钥 - 用户登录接口返回 JWT 后，前端后续请求在
Authorization: Bearer <token></token>头中携带，后端自动解析并注入$user到控制器参数
数据库与数据层精简接入
不建议一上来就配 MySQL + Doctrine ORM 大而全，先验证流程，再逐步加固：
- 若只需快速验证，用内置的 SQLite：
composer require doctrine/doctrine-bundle，然后在.env中设DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db" - 运行
php bin/console doctrine:database:create和php bin/console doctrine:migrations:migrate初始化表 - 如需 MySQL，确保已安装服务，修改
DATABASE_URL为mysql://user:pass@127.0.0.1:3306/myapi?serverVersion=8.0，注意末尾指定 serverVersion，否则 Doctrine 可能因版本识别失败而报错 - 实体中避免过度使用
@ORM\JoinColumn等复杂映射，初期用单表 + 简单关联即可，API Platform 会自动处理嵌套序列化
不复杂但容易忽略。
