Windows下PHP项目真正可用必须同时满足四条件：PHP解释器可全局调用（php -v验证）、Web服务器正确加载PHP模块并解析.php后缀、项目路径严格匹配DocumentRoot或虚拟主机配置、数据库连接参数与php.ini启用扩展（mysqli/pdo_mysql/openssl/curl）及时区设置均就绪，缺一即导致500/404/Connection refused错误。

能跑起来不等于部署完成——Windows下PHP项目真正可用，必须同时满足四个硬性条件：PHP解释器可调用、Web服务器能解析.php、项目路径被正确识别、数据库连接就绪。缺一不可，漏掉任一环节都会在访问时爆出 500、File not found 或 Connection refused 这类看似随机实则指向明确的错误。

php.exe 必须能被全局调用

这是所有后续操作的前提。很多用户卡在第一步，却以为是Apache或Nginx配置问题。

• 把PHP解压目录（例如 C:php）和它的 ext 子目录都加进系统 Path 环境变量，中间用英文分号 ; 隔开
• 重启命令行窗口（不是重启电脑），运行 php -v ——必须输出版本号，否则后面全白搭
• 别只加 C:php 就完事：php.ini 里 extension_dir 指向的是 ext 目录，而某些扩展（如 php_mysqli.dll）加载失败时，php -v 仍能成功，但Web请求会静默失败
• 如果用的是XAMPP或phpStudy，路径通常是 C: mppphp 或 C:phpstudy_proExtensionsphpphp8.2.12nts，注意区分TS/NTS版本和实际目录名

Apache 或 Nginx 必须加载 PHP 模块并识别 .php 后缀

常见错觉是“Apache启动了，PHP就能跑”，其实 Apache 默认根本不认识 .php 文件。

• Apache 方式：确认 httpd.conf 末尾有这三行（路径严格对应你的PHP安装位置）：
  LoadModule php_module "C:/php/php8apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
• Nginx 方式：必须配 location ~ .php$ 块，并确保 fastcgi_pass 指向正在运行的 php-cgi.exe 或 php-fpm 进程（Windows下常用 127.0.0.1:9000）
• 检查 AddHandler 和 AddType 别混用——前者用于CGI模式，后者用于模块模式；XAMPP默认用模块模式，AddHandler 反而会破坏它
• 修改配置后一定要重启服务，仅刷新浏览器没用；Apache用 httpd -k restart，不要只点Control Panel里的Stop/Start

项目根目录必须匹配 Web 服务器 DocumentRoot 或虚拟主机配置

你把代码扔进 C: mpphtdocs 能跑，不代表扔进 C:myproject 就能跑——路径没对上，404 是必然结果。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

立即学习“PHP免费学习笔记（深入）”；

• XAMPP/WAMP默认根目录是 C: mpphtdocs，phpStudy是 C:phpstudy_proWWW，别凭感觉放错位置
• 如果要用自定义路径（比如 C:projectsmyapp），必须改 httpd.conf 中的 DocumentRoot 和紧随其后的 <directory></directory> 路径，两处必须完全一致
• Laravel、ThinkPHP这类框架通常要求入口是 public 子目录，此时 DocumentRoot 应设为 C:/projects/myapp/public，而不是项目根目录
• 启用虚拟主机时，ServerName（如 x.cj.cn）必须与 hosts 文件中 127.0.0.1 x.cj.cn 条目匹配，否则 DNS 解析失败，根本连不上

php.ini 必须启用关键扩展且时区/内存设置合理

很多项目报错“Class not found”或“Database connection failed”，根源常在 php.ini 里几行被注释掉的配置。

• 打开 php.ini，取消以下几行前的分号：
  extension=mysqli
extension=pdo_mysql
extension=openssl
extension=curl
• date.timezone 必须设为有效值，如 date.timezone = "Asia/Shanghai"，否则 strtotime() 等函数可能返回 false
• memory_limit 建议调到 256M 或更高，尤其 Laravel 项目在 composer install 或首次加载时容易爆内存
• 改完 php.ini 后，必须重启Web服务器（Apache/Nginx）才能生效，phpinfo() 页面里看到的才是最终生效值

最易被忽略的其实是路径拼写和权限细节：Windows路径里的反斜杠 在配置文件中要写成正斜杠 / 或双反斜杠 \；Apache服务若以 Local System 身份运行，对非系统盘路径（如 D:）可能无读取权限；phpStudy 的 MySQL 默认绑定 127.0.0.1，但有些项目配置写的是 localhost，这在Windows下不一定等价——这些都不是“玄学”，而是确定性行为。