如何在Zend Framework 1中不依赖Composer使用PhpSpreadsheet

1. 下载PhpSpreadsheet独立包 #

• 去PhpSpreadsheet的官方仓库下载适配PHP7.4的稳定版压缩包（推荐1.29.x系列，该版本支持PHP7.3+）
• 解压后，将里面的PhpSpreadsheet目录（即原压缩包内的src文件夹内容）放到ZF1项目的类库目录下，比如直接丢到项目根目录的library/里，或者单独建个third-party/目录统一存放第三方类库

2. 配置ZF1的自动加载规则 #

ZF1依赖自带的自动加载器，需要把PhpSpreadsheet的命名空间纳入加载范围，两种配置方式选其一即可：

• 方式一：在bootstrap.php中配置
  在项目的application/bootstrap.php里添加以下代码：

  // 注册PhpSpreadsheet的命名空间前缀
  Zend_Loader_Autoloader::getInstance()->registerNamespace('PhpSpreadsheet_');
  // 更新include_path，确保PhpSpreadsheet所在目录被纳入
  set_include_path(implode(PATH_SEPARATOR, array(
      realpath(APPLICATION_PATH . '/../library'),
      realpath(APPLICATION_PATH . '/../third-party'), // 如果放在这个目录就加，否则去掉
      get_include_path(),
  )));
  

• 方式二：在application.ini中配置
  打开application/configs/application.ini，添加：

  autoloaderNamespaces[] = "PhpSpreadsheet_"
  includePaths.library = APPLICATION_PATH "/../library"
  includePaths.thirdparty = APPLICATION_PATH "/../third-party" ; 对应存放目录，按需添加
  

3. 检查并安装依赖扩展 #

PhpSpreadsheet需要几个PHP扩展支持，确认你的PHP7.4已启用以下扩展：

• xml、zip、gd、mbstring
  如果缺失，用服务器包管理器安装，比如Ubuntu系统执行：

apt install php7.4-xml php7.4-zip php7.4-gd php7.4-mbstring

安装完成后重启Web服务器生效

4. 编写测试代码验证 #

在任意控制器里写个简单的测试动作，比如：

public function testExcelAction()
{
    // 禁用视图渲染，避免输出多余内容
    $this->_helper->viewRenderer->setNoRender(true);
    $this->_helper->layout->disableLayout();

    // 初始化Spreadsheet对象
    $spreadsheet = new PhpSpreadsheet_Spreadsheet();
    $activeSheet = $spreadsheet->getActiveSheet();
    $activeSheet->setCellValue('A1', '测试内容');
    $activeSheet->setCellValue('B1', 'PhpSpreadsheet在ZF1中运行正常');

    // 输出Excel文件
    header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
    header('Content-Disposition: attachment;filename="test_zf1.xlsx"');
    header('Cache-Control: max-age=0');

    $writer = new PhpSpreadsheet_Writer_Xlsx($spreadsheet);
    $writer->save('php://output');
    exit;
}

访问该控制器动作，如果能正常下载Excel文件，说明集成成功

常见问题排查 #

• 类找不到：检查命名空间是否正确注册，PhpSpreadsheet的目录是否在include_path范围内
• 扩展错误：对应安装缺失的PHP扩展，重启服务器
• 内存不足：在代码开头添加ini_set('memory_limit', '256M');（根据实际需求调整数值）

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