composer如何安装并在项目中使用Excel处理插件_composer引入PhpSpreadsheet【实战】

composer安装需先配置全局命令：windows用官方安装器勾选Add to PATH，macos/linux用curl下载后移至/usr/local/bin并加执行权限；再通过composer require phpoffice/phpspreadsheet引入PhpSpreadsheet库，注意require autoload.php、路径正确及大文件读取优化。

Composer 安装失败或命令不可用？先确认基础环境

没装好 composer，后面所有操作都白搭。不是“下载个 composer.phar 放项目里就行”，得让系统全局识别 composer 命令。

• Windows 用户推荐用 官方安装器，勾选“Add to PATH”；装完在 CMD 执行 composer --version，有输出才算成功
• macOS / Linux 用户优先用 curl -sS https://getcomposer.org/installer | php 下载 composer.phar，再执行 sudo mv composer.phar /usr/local/bin/composer 并加执行权限：sudo chmod +x /usr/local/bin/composer
• 如果报错 Command "composer" not found，说明 PATH 没生效，重启终端或运行 source ~/.zshrc（或 ~/.bash_profile）

用 composer require 引入 PhpSpreadsheet 到项目

别去 gitHub 下 zip 包手动解压，也别用 git clone，直接走 Composer 依赖管理最稳。PhpSpreadsheet 是官方维护的现代 excel 库，替代已废弃的 PHPExcel。

• 确保你在项目根目录（即有 composer.json 的地方），运行：

  composer require phpoffice/phpspreadsheet

• 会自动写入 composer.json 的 require 字段，并生成/更新 vendor/autoload.php
• 如果提示版本冲突（比如 laravel 项目里已有旧版 guzzlehttp/guzzle），加 --with-all-dependencies 强制兼容：

  composer require phpoffice/phpspreadsheet --with-all-dependencies

• 国内慢？提前配好镜像源：

  composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

在 PHP 脚本中加载并读写 Excel 文件

引入后不 autoload 就等于没装。PhpSpreadsheet 不提供全局函数，必须用命名空间 + 自动加载。

• 开头必须包含：

  require 'vendor/autoload.php';

• 读取 .xlsx 文件示例：

  $spreadsheet = PhpOfficePhpSpreadsheetIOFactory::load('data.xlsx'); $worksheet = $spreadsheet->getActiveSheet(); echo $worksheet->getCell('A1')->getValue();

• 写入新文件示例：

  $spreadsheet = new PhpOfficePhpSpreadsheetSpreadsheet(); $sheet = $spreadsheet->getActiveSheet(); $sheet->setCellValue('A1', 'Hello World'); $writer = new PhpOfficePhpSpreadsheetWriterXlsx($spreadsheet); $writer->save('output.xlsx');

• 注意：IOFactory::load() 会根据后缀自动选择读取器，但只支持 .xlsx、.xls、.csv 等常见格式；读 .xls 需额外装 phpoffice/phpspreadsheet 的依赖 markbaker/complex 和 markbaker/matrix（Composer 会自动处理）

常见报错和绕过方式

实际写代码时卡在某一步，大概率是这几个点没对上。

立即学习“PHP免费学习笔记（深入）”；

• class 'PhpOfficePhpSpreadsheetSpreadsheet' not found：没执行 require 'vendor/autoload.php'，或者路径错了（比如脚本不在项目根目录，要写成 __DIR__ . '/vendor/autoload.php'）
• Could not open data.xlsx for reading! File does not exist：检查文件路径是否相对当前脚本位置，建议用绝对路径调试：__DIR__ . '/data.xlsx'
• 内存溢出（Allowed memory size exhausted）：大文件读取默认加载全量数据，改用 ChunkReadFilter 或设置读取配置：

  $reader = PhpOfficePhpSpreadsheetIOFactory::createReader('Xlsx'); $reader->setReadDataOnly(true); // 只读值，不读样式

• Laravel 中导出 Excel 报 500？确认没漏掉 use PhpOfficePhpSpreadsheetSpreadsheet;，且控制器方法里没 echo 其他内容（会破坏二进制响应头）

实际用起来，最常被忽略的是 vendor/autoload.php 的引入时机和路径，以及读大文件时没开 setReadDataOnly(true) 导致 OOM。其他都是路径、命名空间、扩展（如 zip、xml）没开这类基础问题。