先执行phpenv version查看当前激活版本，若非7.3.33或报“command not found”，说明环境变量未生效；再运行php -v验证PHP可执行文件响应，遇DLL缺失需装VC++2019；检查php.ini语法及gd、pdo_mysql等关键扩展是否启用，改后须重启Web服务；端口冲突时用netstat查杀占用进程，并修改Apache/MySQL配置端口；数据库连接失败应填127.0.0.1:3307而非localhost，同时启用mod_rewrite和AllowOverride All。
确认当前PHP版本与运行状态
先执行 phpenv version 查看当前激活版本，若显示非7.3.33或报错“command not found”，说明环境变量未生效。Windows用户需检查系统PATH是否包含phpenv的bin目录（如E:\phpenv\bin），并确认已重启终端；Linux/macOS用户检查~/.bashrc或~/.zshrc中是否执行了source $(phpenv root)/bin/phpenv.sh。再运行php -v验证PHP可执行文件是否响应——若弹窗提示“VCRUNTIME140.dll缺失”或直接闪退，需安装Visual C++ 2019 Redistributable (x64)。
检查php.ini语法与关键扩展
进入phpenv管理的PHP 7.3.33安装目录（如C:\phpenv\versions\7.3.33\），执行php -l php.ini。若提示某行语法错误，常见问题包括：extension=php_curl.dll误写为extension=curl、路径含中文未加引号、漏掉分号。微擎等典型项目依赖gd、pdo_mysql、curl、openssl四个扩展，打开php.ini搜索对应项，去掉前面的分号（如;extension=gd → extension=gd）。改完必须重启Apache或PHP-FPM服务，否则不生效。
解决Web服务绑定与端口冲突
phpenv本身不启动Apache或MySQL，它只切换CLI用的PHP版本。若你用的是phpEnv（图形化工具），点击「重启」失败，大概率是端口被占。先用netstat -ano | findstr :80查80端口占用进程PID，任务管理器中结束对应程序；MySQL同理查3306端口。若需长期避开冲突，进phpEnv「配置」→「Apache」修改httpd.conf中Listen 80为Listen 8081；MySQL端口在my.ini中改为port=3307。改完务必点「Stop」再「Start」，避免残留进程卡住。
修复数据库连接与伪静态支持
微擎安装时提示“数据库连接失败”，即使密码正确，也别填localhost——PHP 7.3+下该值可能走Unix socket而非TCP，应明确填127.0.0.1:3307（若改过端口）。同时确认Apache已启用mod_rewrite：打开httpd.conf，取消#LoadModule rewrite_module modules/mod_rewrite.so前的#号，并确保AllowOverride All在站点目录配置段中启用。最后放一个info.php（内容<?php phpinfo(); ?>）访问验证扩展和配置是否生效。
立即学习“PHP免费学习笔记（深入）”；
