必须先验证php版本≥8.2、intl等5个扩展齐全、composer依赖完整、.env中app_env=dev且app_debug=1、var/cache与var/log可写，缺一即导致欢迎页或profiler不可用。
确认 PHP Symfony 项目能否正常启动、调试和部署，第一步必须验证运行环境是否达标——PHP 版本、扩展、Composer 状态、环境变量、缓存目录权限缺一不可，漏检一项就可能卡在欢迎页或 Profiler 工具栏不显示。
检查 PHP 基础环境与扩展
打开终端，逐行执行以下命令：
php -v → 必须输出 ≥ 8.2 的版本号（Symfony 7.x 强制要求），注意是命令行输出，不是浏览器 phpinfo() 页面；
php -m | grep -E "(intl|mbstring|xml|curl|fileinfo)" → 五个扩展必须全部出现在列表中，【intl 扩展最常被漏装，Windows 用户尤其要手动启用 php_intl.dll】；
php --ini → 确认加载的是 CLI 模式下的 php.ini（路径通常为 /etc/php/*/cli/php.ini 或 C:\php\php.ini），不是 Apache 或 Nginx 对应的配置文件。
验证 Composer 与依赖状态
方法一：直接检查依赖完整性
进入项目根目录后运行 composer install --dry-run → 若报错“Package manifest not found”或提示 missing packages，说明 vendor/ 目录损坏或未安装；
方法二：确认 Flex 是否激活
运行 php bin/console about → 输出中必须包含 Flex: enabled 和 Environment: dev，否则 Symfony 的自动配置机制未生效，后续 bundle 注册会失败。
确认 Web Profiler 工具栏可用性
第一步：检查 .env 配置
打开 .env 文件，确认存在且未被注释的两行：
APP_ENV=dev
APP_DEBUG=1
第二步：验证 Kernel 调试模式是否真正加载
在任意控制器中临时加入 dump($this->getParameter('kernel.debug')); → 浏览器访问该路由，输出必须为 true；
第三步：检查响应是否注入了 WDT 脚本
打开欢迎页源代码，搜索<script id="sfwdt">→ 若不存在，大概率是 base 模板里漏写了 {{ render_profiler() }} 或中间件提前终止了输出（如调用了 exit 或 ob_end_clean()）。</script>
测试缓存与日志目录权限
第一步：检查 var/ 目录结构
运行 ls -la var/ → 必须存在 cache/ 和 log/ 子目录，且当前用户对其有读写权限；
第二步：强制清空并重建缓存
执行 php bin/console cache:clear → 成功时输出 “Successfully cleared the cache for the dev environment.”；
若报错 “Permission denied”，立即执行 chmod -R 0777 var/cache var/log → 【仅限开发环境，生产环境严禁 777 权限】；
第三步：触发一次日志写入
访问任意不存在的路由（如 /test-404），然后运行 tail -n 5 var/log/dev.log → 应看到包含 “request.ERROR” 的记录行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
