需安装集成环境（如XAMPP）、将项目放入htdocs目录、配置虚拟主机（可选）、启用必要PHP扩展并修改php.ini、最后通过phpinfo()和错误日志验证运行状态。
如果您已拥有 PHP 项目源码，但尚未在本地运行，可能是由于缺少可执行的 PHP 运行环境。以下是将 PHP 代码部署到本地并成功运行的具体步骤：
一、安装本地 PHP 环境
PHP 项目需依赖 Web 服务器与 PHP 解释器协同工作，单独安装 PHP 无法直接访问网页，因此推荐使用集成环境套件，避免手动配置 Apache/Nginx 和 PHP 版本兼容问题。
1、下载 XAMPP（Windows/macOS/Linux 均支持）或 WAMP（仅 Windows）、MAMP（macOS/Windows）等集成环境软件。
2、运行安装程序，接受默认路径，勾选 Apache 和 PHP 组件（XAMPP 安装时默认包含）。
立即学习“PHP免费学习笔记（深入）”；
3、安装完成后启动控制面板，点击 Start 按钮启动 Apache 服务。
4、在浏览器中访问 http://localhost，若显示欢迎页面，说明环境已就绪。
二、放置项目文件到 Web 根目录
集成环境将预设一个 Web 服务可读取的默认根目录，只有放入该目录的 PHP 文件才能被浏览器通过 HTTP 请求解析执行。
1、定位根目录：XAMPP 默认为 htdocs（Windows 路径示例：C:\xampp\htdocs；macOS 示例：/Applications/XAMPP/htdocs）。
2、将您的 PHP 项目文件夹（如 myproject）整体复制到 htdocs 目录下。
3、确保项目入口文件（如 index.php）位于该文件夹根层级，而非嵌套过深子目录中。
4、在浏览器中访问 http://localhost/myproject/index.php，尝试加载页面。
三、配置虚拟主机（可选，便于多项目管理）
当本地运行多个 PHP 项目时，为避免每次修改 URL 路径，可通过虚拟主机为每个项目分配独立域名（如 myproject.test），提升开发效率与路径一致性。
1、以管理员权限打开 XAMPP 中 httpd-vhosts.conf 文件（路径：C:\xampp\apache\conf\extra\httpd-vhosts.conf）。
2、在文件末尾添加如下配置块：
<VirtualHost *:80>
DocumentRoot "C:/xampp/htdocs/myproject"
ServerName myproject.test
</VirtualHost>
3、用记事本以管理员身份打开系统 hosts 文件（Windows 路径：C:\Windows\System32\drivers\etc\hosts），在末尾新增一行：127.0.0.1 myproject.test。
4、重启 Apache 服务，浏览器访问 http://myproject.test 即可直达项目。
四、启用 PHP 扩展与调整 php.ini 设置
部分 PHP 项目依赖特定扩展（如 pdo_mysql、gd、mbstring）或自定义配置（如 upload_max_filesize、date.timezone），需手动开启或修改参数以保障功能完整。
1、打开 XAMPP 控制面板，点击 Apache 行右侧的 Config → PHP (php.ini)。
2、查找 ;extension=php_pdo_mysql.dll（Windows）或 ;extension=pdo_mysql（macOS/Linux），删除行首分号取消注释。
3、查找 date.timezone，将其值改为 date.timezone = "Asia/Shanghai"。
4、保存 php.ini 文件，重启 Apache 使配置生效。
五、验证 PHP 项目运行状态
即使页面能打开，也可能存在运行时错误（如白屏、500 错误、数据库连接失败），需主动检查 PHP 错误日志与基础运行条件是否满足。
1、在项目根目录新建 test.php，内容为 <?php phpinfo(); ?>，访问 http://localhost/test.php 确认 PHP 版本与已启用模块。
2、查看 Apache 错误日志（XAMPP 控制面板 → Apache → Logs → error.log），搜索关键词 PHP Fatal error 或 Warning。
3、若项目含数据库操作，确认 MySQL 服务已启动，并检查 config.php 或 .env 文件中数据库主机设为 localhost、端口为 3306。
