WP插件下载文件被写入#!/usr/bin/env php的原因及解决方法

为什么会出现#!/usr/bin/env php行？ #

大概率是你的插件控制器PHP文件最顶部存在这个shebang行，而且它位于<?php标签之前。

在Web环境下运行PHP时，任何出现在<?php起始标签之前的文本内容，都会被Web服务器直接输出到响应中。当你在download()方法里生成下载文件时，这行shebang已经被提前输出到了响应流里，最后就被一起写入到了下载的文本文件中，导致内容变成了#!/usr/bin/env php Hello?。

另外一种小概率情况是，你的代码在执行download()方法之前，有其他地方意外输出了这行内容，但最常见的还是控制器文件开头的shebang问题。

如何避免这个问题？ #

这里有两个关键步骤来彻底解决：

1. 清理PHP文件开头的多余内容
   打开你的插件控制器文件，确保文件的第一行就是<?php标签，前面没有任何字符（包括空格、换行或者那个#!/usr/bin/env php行）。如果这个文件需要同时支持CLI和Web环境，可以把shebang放在<?php标签内部用注释包裹，比如：

   <?php
   #!/usr/bin/env php
   defined( 'ABSPATH' ) || exit;
   // 后续代码...
   

   这样CLI环境能识别到shebang，而Web环境下它只是PHP注释，不会被输出。

2. 在输出下载文件前清空输出缓冲区
   在download()方法开始生成文件内容之前，先调用PHP的输出缓冲区清理函数，确保之前没有任何意外输出被混入下载内容。示例代码如下：

   public function download() {
       // 清空输出缓冲区，避免之前的内容被混入
       ob_clean();
       flush();
   
       // 设置下载响应头
       header('Content-Type: text/plain');
       header('Content-Disposition: attachment; filename="hello.txt"');
       header('Content-Length: ' . strlen('Hello?'));
   
       // 输出文件内容
       echo 'Hello?';
       exit; // 终止脚本，避免后续代码输出额外内容
   }
   

   调用ob_clean()会清空当前的输出缓冲区，flush()确保缓冲区内容被发送（这里主要起清理作用），最后用exit终止脚本，防止后续代码产生额外输出。

内容的提问来源于stack exchange，提问作者user3574603