首先确认本地服务器是否启动并正确配置，使用PHP内置服务器命令php -S localhost:8000进入项目目录启动服务，或通过MAMP/XAMPP运行Apache；若仍无法访问，检查端口占用情况与防火墙设置，确保80或8000端口未被占用且服务未被阻止；进一步可通过配置Apache虚拟主机绑定自定义域名test.local，并修改hosts文件实现多项目管理；最后验证PHP是否正常解析，创建info.php文件查看phpinfo()输出，若显示配置信息则说明环境正常。
如果您在开发PHP应用时需要在本地环境中运行和测试代码，但无法通过localhost访问服务，则可能是由于本地服务器未正确配置或服务未启动。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sonoma
一、使用内置PHP服务器启动本地服务
PHP从5.4版本开始自带一个轻量级的内置Web服务器，适合用于本地开发和测试。该方法无需安装额外的服务器软件，只需在命令行中执行启动命令即可。
1、打开终端，进入您的PHP项目根目录，例如：cd /Users/username/Sites/myproject。
立即学习“PHP免费学习笔记（深入）”；
2、运行以下命令启动内置服务器：php -S localhost:8000。
3、打开浏览器并访问 http://localhost:8000 查看您的PHP文件是否正常显示。
二、通过MAMP/XAMPP搭建本地环境
MAMP（Mac）或XAMPP（跨平台）是集成的本地服务器环境，包含Apache、MySQL和PHP，能够模拟完整的生产环境，适合进行复杂功能测试。
1、下载并安装MAMP（macOS）或XAMPP（Windows/macOS/Linux），安装完成后启动应用程序。
2、在MAMP或XAMPP控制面板中点击“Start Servers”按钮，确保Apache服务已运行。
3、将您的PHP项目文件放入指定的根目录，如MAMP默认为 /Applications/MAMP/htdocs/。
4、在浏览器中访问 http://localhost:8888/your-project-folder（MAMP默认端口为8888）或XAMPP对应的端口（通常为80）。
三、配置Apache虚拟主机实现自定义本地域名
通过配置Apache的虚拟主机，可以将本地项目绑定到自定义域名（如test.local），便于管理多个项目并避免端口冲突。
1、编辑Apache的配置文件 httpd.conf，确保加载了虚拟主机模块：Include /private/etc/apache2/extra/httpd-vhosts.conf。
2、打开 httpd-vhosts.conf 文件，在末尾添加如下虚拟主机配置：
DocumentRoot "/Users/username/Sites/myproject"
ServerName test.local
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
3、修改系统hosts文件，添加一行映射：127.0.0.1 test.local。
4、重启Apache服务：sudo apachectl restart。
5、在浏览器中访问 http://test.local 测试是否生效。
四、检查防火墙与端口占用情况
当本地服务器无法访问时，可能是因为端口被其他程序占用或系统防火墙阻止了连接。排查此类问题有助于恢复服务访问。
1、检查80或8000等常用端口是否被占用，运行命令：lsof -i :8000。
2、若发现占用进程，可选择终止该进程：kill -9 PID（PID为进程编号）。
3、确认macOS防火墙未阻止Apache或PHP服务，可在“系统设置 > 隐私与安全性 > 防火墙”中检查。
五、验证PHP文件是否正确解析
即使服务器运行正常，如果PHP文件被当作纯文本显示而非执行，说明MIME类型或处理器未正确配置。
1、创建一个测试文件 info.php，内容为：。
2、通过浏览器访问该文件，如显示PHP配置信息页面则表示解析正常。
3、若源码被直接输出，请检查Apache是否加载了PHP模块，确认配置中存在类似：LoadModule php_module libexec/apache2/libphp.so。
