程序员应下载PHP官方NTS版二进制包(如php-8.3.12-nts-Win32-vs16-x64.zip),解压至纯英文无空格路径(如C:\php),重命名php.ini-development为php.ini并启用mbstring、mysqli等核心扩展及Asia/Shanghai时区,配置系统Path环境变量后执行php -v验证;再通过官方安装器或手工方式安装Composer,最后下载匹配版本的Xdebug DLL并配置zend_extension及调试参数,执行php -m | findstr xdebug确认加载成功。

程序员需要在本地快速搭建一个稳定、可调试、免 license 限制的 PHP 环境,用于日常开发、代码测试和 CI 脚本验证,而不是依赖云 IDE 或远程服务器;PHP 官方二进制包本身永久免费,且不绑定商业授权,只要避开第三方打包器的附加条款,就能获得完全自主控制的运行时。
下载并解压官方 PHP(NTS 版)
访问 https://www.php.cn/link/a9a2c061a1c2743d489c6863eae6725a → 找到最新稳定版(如 php-8.3.12-nts-Win32-vs16-x64.zip)→ 下载 Non-Thread-Safe (NTS) 版本。
解压 ZIP 到纯英文无空格路径,例如 C:\php;解压后确认目录中存在 php.exe 和 php.ini-development 两个关键文件。
⚠️ 不要解压到含中文、空格或特殊符号的路径(如“我的文档”“Program Files”),否则 php -v 可能报错“无法启动此程序”。
立即学习“PHP免费学习笔记(深入)”;
启用核心扩展与基础配置
将 php.ini-development 复制一份并重命名为 php.ini。
用记事本或 VS Code 打开 php.ini,一次性修改以下三处:
① 找到 extension_dir 行,取消注释并设为相对路径:extension_dir = "ext"
② 启用必需扩展:去掉以下六行开头的分号(;):extension=mbstringextension=mysqliextension=pdo_mysqlextension=opensslextension=curlextension=gd
③ 设置时区:date.timezone = Asia/Shanghai
保存文件;这一步漏掉 mbstring 或 openssl,后续 Composer 安装包会直接失败。
配置系统环境变量
右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在“系统变量”中找到 Path → 编辑 → 新建 → 输入 C:\php → 确定保存。
关闭所有已打开的命令提示符窗口,重新打开一个 cmd,执行:php -v
若返回类似 PHP 8.3.12 (cli) (built: Jul 10 2026 14:22:03) 的信息,说明 CLI 环境已就绪。
安装 Composer 并验证自动加载
方法一:官网安装器
下载 Composer-Setup.exe → 双击运行 → 当提示选择 php.exe 路径时,手动定位到 C:\php\php.exe → 勾选 “Add Composer to your PATH” → 完成安装。
方法二:手工安装(跳过 GUI,更可控)
在 cmd 中执行:php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"php composer-setup.php --install-dir=C:\php --filename=composerdel composer-setup.php
安装后执行 composer --version,看到版本号即表示成功;此时 composer 命令可在任意目录调用。
启用 Xdebug 调试支持
访问 https://www.php.cn/link/5f07196d710d5a71d68dfeb7b49db47f → 根据你当前 PHP 版本(用 php -v 查看)、架构(x64)、VC 版本(vs16 对应 Visual Studio 2019)下载对应 DLL 文件,例如:php_xdebug-3.3.1-8.3-vc15-x86_64.dll
将下载的 DLL 文件放入 C:\php\ext 目录下。
在 php.ini 文件末尾新增以下配置块:
[Xdebug]<br>zend_extension=C:\php\ext\php_xdebug-3.3.1-8.3-vc15-x86_64.dll<br>xdebug.mode=debug,develop<br>xdebug.start_with_request=yes<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003
保存 php.ini,重启 cmd,执行:php -m | findstr xdebug
若输出包含 xdebug,说明扩展已加载;执行 php -i | findstr "xdebug.mode" 可验证模式是否生效。



















