Windows本地搭建PHP集成环境详细操作步骤-php教程-PHP中文网

xampp启动apache失败提示“port 80 in use”是因为系统进程（如iis、skype、docker等）占用了80端口，需先用netstat查pid再tasklist确认进程名，避免误杀关键服务；推荐改端口：同步修改httpd.conf中listen 80→8080、servername localhost:80→localhost:8080，及httpd-ssl.conf中443相关配置，并更新控制面板端口设置。

windows本地搭建php集成环境详细操作步骤

直接用 XAMPP 是最省事、出错率最低的选择，尤其对没接触过 Apache 或 PHP 模块加载机制的新手。手动配 Apache + PHP 容易卡在 php8apache2_4.dll 版本不匹配、VC 运行库缺失、PHPIniDir 路径带空格或反斜杠错误等细节上，而 XAMPP 已预编译适配好全部组件。

为什么 XAMPP 启动 Apache 失败，提示 “Port 80 in use”

这是 Windows 下最常见报错，现象是 XAMPP 控制面板中 Apache 行显示红色，日志里出现类似：

Port 80 in use by "Unable to open process" with PID 4!

根本原因是系统级进程占用了 80 端口，典型包括：

IIS（Windows 自带的 Web 服务）
Skype（旧版本默认监听 80/443）
VMware Workstation（vmware-hostd.exe 占用 443）
Docker Desktop（启用 Kubernetes 后可能抢端口）

解决方式不是硬关系统服务，而是改 Apache 监听端口：

编辑 XAMPP\apache\conf\httpd.conf，搜索 Listen 80，改成 Listen 8080
再搜 ServerName localhost:80，改成 ServerName localhost:8080
如果还要用 HTTPS，顺带改 XAMPP\apache\conf\extra\httpd-ssl.conf 里的 Listen 443 为 Listen 4431
保存后重启 Apache，访问 http://localhost:8080 即可

test.php 中 `phpinfo()` 不执行，浏览器直接下载或显示源码

说明 Apache 没把 .php 文件交给 PHP 解析器处理，本质是模块未加载或 Handler 配置失效。检查点有三个：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

确认 XAMPP\apache\conf\httpd.conf 中已取消注释这三行（XAMPP 默认已开，但手动改过可能误删）：
LoadModule php_module modules/libphp.dll
AddHandler application/x-httpd-php .php
PHPIniDir "C:/xampp/php"
确认 XAMPP\php\php.ini 存在且不是 php.ini-development 或 php.ini-production 的副本——XAMPP 安装时会自动重命名，但重装或覆盖后可能出错
确认 test.php 真正放在 XAMPP\htdocs\ 下，而不是桌面、文档或子文件夹里；路径错一个层级就会绕过 Apache 的 DocumentRoot

如何让命令行也能运行 `php -v` 或 `composer`

仅靠 XAMPP 启动 Apache 并不能让系统识别 php 命令，必须手动加环境变量：

打开“系统属性 → 高级 → 环境变量”
在“系统变量”中找到 Path，点击“编辑”→“新建”
填入 XAMPP 中 PHP 的实际路径，例如：C:\xampp\php
注意：不要加末尾反斜杠，也不要包含 php.exe 文件名本身
新开一个命令提示符窗口，执行 php -v 验证；若提示“不是内部或外部命令”，说明路径错或没刷新终端

这个步骤常被跳过，导致后续用 Composer、Laravel Installer 或 PHPUnit 时直接报错。

phpMyAdmin 登录失败：空密码不生效，或提示 “#2002 Cannot log in to the MySQL server”

不是密码错了，而是 MySQL 服务根本没起来，或者 socket 连接异常。先看 XAMPP 控制面板里 MySQL 行是否是绿色 “Running”。如果不是：

点 MySQL 行右侧的 “Logs” 查看错误日志，高频原因是 my.ini 中 basedir 或 datadir 路径写死或含中文
常见静默失败点：杀毒软件（尤其是 360、火绒）拦截 mysqld.exe 初始化，临时禁用再试
若之前设过 root 密码但忘了，可跳过密码验证重置：停止 MySQL → 用管理员身份运行命令提示符 → 进入 XAMPP\mysql\bin\ → 执行：mysqld --skip-grant-tables → 新开窗口执行 mysql -u root → 在 MySQL 提示符下运行：FLUSH PRIVILEGES; ALTER USER 'root'@'localhost' IDENTIFIED BY '';