file_get_contents返回false表示明确失败，常见原因包括路径错误、权限不足、allow_url_fopen被禁用、远程URL不可达或大文件内存溢出；应先用error_get_last()查具体错误，路径用__DIR__拼接，远程请求优先用cURL替代。
file_get_contents 返回 false 是最常见的信号
这说明函数根本没拿到内容，不是空字符串，而是明确失败。常见原因包括路径错误、权限不足、远程 URL 不可达，或者 PHP 配置禁用了 allow_url_fopen。先别急着改代码，用 error_get_last() 看一眼真实报错：
var_dump(file_get_contents('/path/to/file.txt'));
var_dump(error_get_last());
输出里通常会带 errno 和 message，比如 "failed to open stream: No such file or directory" 就是路径错了，"Permission denied" 就得查文件权限或 SELinux 状态。
本地文件路径不工作：相对路径陷阱
PHP 的当前工作目录（getcwd()）不一定是脚本所在目录，尤其在 CLI 或 Web Server 多层调用时。直接写 file_get_contents('config.json') 很容易找不到文件。
- 用
__DIR__拼接更可靠：file_get_contents(__DIR__ . '/config.json') - 检查路径是否存在：
if (!file_exists($path)) { die("File missing: $path"); } - 确认文件可读：
if (!is_readable($path)) { die("Not readable: $path"); }
读取远程 URL 时提示 “failed to open stream”
这不是网络问题，大概率是 PHP 配置拦住了。运行 phpinfo() 查看 allow_url_fopen 是否为 On。如果关了，file_get_contents('https://api.example.com') 必然失败，且不会触发 cURL 相关错误——它压根不走 cURL。
立即学习“PHP免费学习笔记（深入）”；
- 开启配置：修改
php.ini，设allow_url_fopen = On，然后重启 Web Server 或 PHP-FPM - 替代方案（不依赖该配置）：
curl_init()+curl_exec()，但需手动处理 header、超时、重定向 - 注意：即使开了
allow_url_fopen，某些共享主机仍会禁用https://，只允许http://
大文件导致内存耗尽或超时
file_get_contents 会把整个文件一次性加载进内存。读一个 200MB 的日志文件，PHP 进程很可能被 OOM killer 干掉，或触发 memory_limit 错误。
- 小文件（file_get_contents
- 中等文件（1–50MB）：先检查
memory_limit，必要时临时调高：ini_set('memory_limit', '256M'); - 大文件或流式处理场景：换
fopen()+fread()分块读，或用stream_get_line()按行处理
真正难搞的其实是那些看似“小”、实则编码异常（比如 BOM、混合换行符）或权限策略复杂（如 NFS 挂载点 + root_squash）的文件——它们不会报错，但返回内容错乱或截断，这时候得结合 file 命令和 stat 手动验证底层状态。
