在mac设备上使用xampp for mac集成环境部署php程序，是本地开发测试php项目的常用方式，整个流程只需要几步就能完成，不需要复杂的配置操作。
前期准备确认
首先确保你已经正确安装了xampp for mac，并且环境处于运行状态。打开xampp控制面板，点击Start按钮启动Apache和MySQL服务，如果看到两个服务的状态都显示为Running，说明环境已经就绪。
需要记住xampp for mac的默认安装路径，通常mac系统下的安装路径为/Applications/XAMPP/，后续部署php程序会用到这个路径下的htdocs目录。
php程序部署步骤
1. 准备php程序文件
将你写好的php程序文件整理好，如果是完整的项目，建议保留原有的目录结构，方便后续维护。比如你的项目包含入口文件index.php、配置文件config.php以及多个功能目录，不需要修改结构直接准备存放即可。
2. 存放程序到指定目录
xampp for mac默认的网站根目录是/Applications/XAMPP/xamppfiles/htdocs/，所有需要运行的php程序都要放在这个目录下。你可以直接在访达中打开这个路径，然后把你的php程序文件夹粘贴进去。
如果是单个php测试文件，比如test.php，也可以直接放到htdocs根目录下，不需要额外建文件夹。
3. 访问运行php程序
打开mac自带的Safari或者其他浏览器，在地址栏输入访问地址。如果是放在htdocs根目录下的test.php，访问地址为http://localhost/test.php；如果是放在新建的myproject文件夹下的index.php，访问地址为http://localhost/myproject/index.php。
如果页面正常显示php程序的输出内容，说明部署成功。如果出现错误，可以参考下面的常见问题排查部分。
简单示例验证
我们可以写一个简单的php测试文件，验证部署流程是否正确。在htdocs目录下新建test.php，内容如下：
<?php // 输出php环境信息 phpinfo(); ?>
保存后在浏览器访问http://localhost/test.php，如果能看到php的详细配置信息页面，说明xampp for mac环境和php程序部署都没有问题。
常见问题排查
- 访问页面显示404错误：检查文件是否真的放到了htdocs目录下，访问地址的路径是否和文件实际存放路径一致，注意mac系统下路径区分大小写。
- 页面显示php代码而不是执行结果：说明Apache没有正确解析php文件，检查xampp控制面板中Apache服务是否正常启动，重启Apache服务后再尝试访问。
- 程序连接数据库失败：确认xampp控制面板中MySQL服务已经启动，检查php程序中的数据库配置，主机地址填写localhost，端口默认是3306，用户名默认是root，初始密码为空。
进阶配置说明
如果需要修改默认的网站根目录，或者配置虚拟主机，可以打开/Applications/XAMPP/xamppfiles/etc/httpd.conf文件，找到DocumentRoot对应的配置项，修改为你想要的路径，同时修改对应的Directory配置，保存后重启Apache服务即可生效。
如果php程序需要特定的扩展支持，可以打开xampp控制面板中的php.ini配置文件，去掉对应扩展前面的分号注释，重启Apache服务后扩展就会生效。
phpxampp_for_macphp部署集成环境修改时间：2026-06-04 06:32:20