修改PHP Bulletproof类以支持PDF、Word等非图片文件上传

我之前用Bulletproof处理多类型文件上传时也踩过类似的坑，你说的“仅需5分钟修改”确实可行，但容易漏掉几个关键配置点，下面一步步给你梳理：

• 第一步：更新类内的默认MIME类型数组
  找到Bulletproof类中定义允许MIME类型的属性（通常叫$allowedMime或$mimeTypes），在原有图片MIME的基础上，添加PDF和Word对应的类型：

  // 示例代码，替换类中对应数组
  protected $allowedMime = [
      'image/jpeg',
      'image/png',
      'image/gif',
      // 新增以下MIME
      'application/pdf',
      'application/msword', // .doc文件
      'application/vnd.openxmlformats-officedocument.wordprocessingml.document' // .docx文件
  ];
  

  这里要注意：.doc和.docx的MIME类型是不同的，两个都不能少。

• 第二步：补充允许的扩展名列表
  很多人只改MIME却忘了更新扩展名白名单，类里一般会有$allowedExtensions这类属性，把pdf、doc、docx加进去：

  protected $allowedExtensions = ['jpg', 'png', 'gif', 'pdf', 'doc', 'docx'];
  

• 第三步：调整文件大小限制（按需）
  Word或PDF文件可能比图片大，如果你遇到“文件过大”的错误，要么修改类内的默认大小：

  protected $maxSize = 10 * 1024 * 1024; // 10MB，单位字节
  

  要么在实例化时动态设置：

  $bulletproof->setSize(15); // 允许最大15MB
  

• 第四步：调用时的正确配置
  就算改了类的默认值，也建议在调用时明确设置一次，避免缓存或默认值覆盖的问题：

  require 'path/to/Bulletproof.php';
  $bulletproof = new Bulletproof\Image();
  
  // 手动指定允许的MIME
  $bulletproof->setMime([
      'image/jpeg',
      'image/png',
      'application/pdf',
      'application/msword',
      'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
  ]);
  
  // 手动指定允许的扩展名
  $bulletproof->setAllowedExtensions(['jpg', 'png', 'pdf', 'doc', 'docx']);
  
  // 处理上传
  if ($bulletproof->upload()) {
      echo "上传成功！文件名：" . $bulletproof->getName();
  } else {
      // 打印错误信息定位问题
      echo "上传失败：" . $bulletproof->getError();
  }
  

• 最后：检查PHP服务器配置
  如果以上都做了还是不行，大概率是PHP本身的限制：

  • 打开php.ini，确保file_uploads = On
  • 调整upload_max_filesize和post_max_size，比如设为10M或更大，且post_max_size要大于upload_max_filesize

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