先确认PHP环境是否正确安装并配置，检查php -v能否输出版本号；若无法运行，需将PHP路径加入系统环境变量；避免双击打开.php文件，应通过命令行执行php index.php或使用Web服务器访问；检查php.ini中必要扩展如mbstring、curl、pdo_mysql等是否启用；用php -l检测语法错误，确保文件权限正确，Web服务器有读取权限；90%问题源于环境配置不当而非代码错误。
PHP源码打不开或运行不了，通常不是代码本身有问题，而是环境没配好、依赖缺失，或者执行方式不对。别急着改代码，先确认基础是否到位。
检查是否安装了PHP并正确配置环境变量
很多新手直接双击 .php 文件，结果用浏览器打开了源码——这是最常见误区。PHP 是服务端脚本，不能像 HTML 那样直接双击运行。
- 打开终端（Windows 用 CMD/PowerShell，macOS/Linux 用 Terminal），输入 php -v，看是否显示版本号
- 如果提示“命令未找到”或“不是内部命令”，说明 PHP 没装，或没加到系统 PATH
- Windows 用户装完 PHP 后，需手动把 php.exe 所在目录（如 C:\php）添加进系统环境变量 Path
- macOS 用户推荐用 Homebrew 安装：brew install php；Linux（Ubuntu）可用：sudo apt install php-cli
确认用对了运行方式：命令行 vs Web 服务器
PHP 脚本有两种主流运行场景，混淆就会失败：
- 命令行运行：适合调试、脚本任务。进入文件所在目录，执行 php index.php，输出直接在终端显示
- Web 方式运行：需搭配 Web 服务器（如 Apache/Nginx）+ PHP 解释器。把文件放到 webroot（如 /var/www/html 或 XAMPP/htdocs），再用浏览器访问 http://localhost/index.php
- 注意：浏览器直接打开本地 file:// 协议的 .php 文件，永远只会看到源码——因为没有 PHP 解释器介入
排查常见依赖与扩展缺失
很多开源 PHP 项目（如 Laravel、WordPress 插件、CMS 等）依赖特定扩展，缺一个就报错或白屏。
立即学习“PHP免费学习笔记（深入）”；
- 运行 php -m 查看已启用的扩展，重点确认：mbstring、curl、openssl、pdo_mysql（如需数据库）、json 等是否在列表中
- 若缺失，Windows 可编辑 php.ini，取消对应扩展前的分号（如 ;extension=mbstring → 改为 extension=mbstring），然后重启 Web 服务
- Linux/macOS 下可能需要额外安装包，例如 Ubuntu：sudo apt install php-mbstring php-curl php-xml
- 用 php --ini 确认当前生效的是哪个 php.ini 文件，避免改错配置
检查语法错误与权限问题
哪怕只少了个分号，PHP 也会直接报错退出；而 Linux/macOS 下还常因权限导致无法读取或执行。
- 用 php -l index.php（小写 L）做语法检测，它会明确告诉你哪一行出错
- Linux/macOS 下，确保文件有读取权限：chmod 644 index.php；如果是 CLI 脚本且带 shebang，还需可执行权限：chmod +x script.php
- Web 运行时，确认 Web 服务器用户（如 www-data、_www）对项目目录有读取权限，必要时用 chown -R www-data:www-data ./project
- Windows 下极少权限问题，但注意杀毒软件或编辑器可能锁住文件，导致无法写入或加载
基本上就这些。PHP 源码跑不起来，90% 是环境和启动方式的问题，而不是代码写错了。先验证 php -v 和 php -l，再选对运行路径，顺藤摸瓜查扩展和权限，基本都能解决。
