零基础新手运行首个symfony应用的核心障碍是环境配置：需确保php≥8.2、启用intl等5个扩展、composer正常；推荐用symfony cli工具创建项目（symfony new myapi --webapp）并启动内置服务器验证。
零基础新手想在本地电脑上跑起第一个 Symfony 应用，最核心的障碍不是写代码，而是环境卡在第一步：PHP 版本不对、扩展没开、Composer 权限被拒、CLI 工具装不上——这些都会导致 symfony new 直接报错退出，连项目目录都建不起来。
确认本地 PHP 和 Composer 环境是否达标
打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），逐条执行以下三行命令，必须全部通过才算合格：
php -v→ 输出版本号必须 ≥ 8.2（2026 年主流要求），注意看命令行输出，不是浏览器里 phpinfo 页面的版本；
php -m | grep -E "(intl|mbstring|xml|curl|fileinfo)"→ 必须一次性列出 intl、mbstring、xml、curl、fileinfo 这五个扩展名，【intl 扩展最容易漏装，尤其 macOS 自带 PHP 或通过 Homebrew 安装时默认不带，务必单独验证】；
composer -v→ 有版本号（如 2.7.x）即 OK；国内用户建议提前设阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；若提示 “plugins are disabled”，立刻补一句：composer config -g allow-plugins true。
安装 Symfony CLI 工具（推荐首选）
它比纯 Composer 更省心，自带开发服务器、一键诊断、环境检查，且不依赖全局 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 能输出版本号（如 v5.12.x）即完成；
把 symfony 可执行文件路径加入系统 PATH（Linux/macOS 加到 ~/.zshrc 或 ~/.bashrc；Windows 在系统环境变量中添加），否则新开终端会找不到命令。
创建第一个 Symfony 项目
执行命令创建带完整 Web 开发栈的项目（含 Twig、Webpack Encore、Doctrine 等预配置）：
symfony new myapi --webapp→ 项目名 myapi 可任意替换，【不要用 --full 参数，该选项已在 2025 年底正式弃用，新版统一用 --webapp】；
等待终端滚动下载依赖，约 30～90 秒，出现绿色 “Project successfully created” 提示即完成；
进入项目目录：cd myapi；
启动内置开发服务器：symfony server:start；
浏览器访问 https://127.0.0.1:8000，看到 Symfony 欢迎页面（含“Welcome to Symfony”标题和 Debug Toolbar）即表示安装彻底成功。
