快速上手

软件要求

使用 PhpSpreadsheet 开发，需要 PHP7.4 版本或更新的版本。其他要求，如 PHP 扩展，由 composer 强制执行。详情见 composer.json 文件中的 require 部分。

PHP 版本支持

LTS 版本说明：对 PHP 版本的支持将只在该 PHP 版本的寿命结束后的六个月内维持。

目前要求的PHP最低版本是 PHP 7.4：最后一个版本是2022年9月29日的7.4.32，安全支持在2022年11月28日结束 LTS，所以 PhpSpreadsheet 将支持 PHP 7.4 到2023年5月28日。PHP 8.0 在2023年11月26日正式结束 LTS，PhpSpreadsheet 将继续支持 PHP 8.0 到该日期后的6个月。

安装

使用 composer 来安装 PhpSpreadsheet：

  1. composer require phpoffice/phpspreadsheet

如果你想要查看对应的文档和示例的话，可以通过下面的命令安装

  1. composer require phpoffice/phpspreadsheet --prefer-source

如果你在一台开发机器上安装，而该机器的 PHP 版本与将要部署的服务器不同，或者你的 PHP CLI 版本与你的运行时间如 php-fpm 或 Apache 的 mod_php 不一样，那么你可能需要在安装前在 composer.json 中加入以下内容：

  1. {
  2.     "require": {
  3.         "phpoffice/phpspreadsheet": "^1.23"
  4.     },
  5.     "config": {
  6.         "platform": {
  7.             "php": "7.4"
  8.         }
  9.     }
  10. }

然后执行 composer install

开始使用

这将是使用 spreadsheet 的最简单方法：

  1. <?php
  3. require 'vendor/autoload.php';
  5. use PhpOffice\PhpSpreadsheet\Spreadsheet;
  6. use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
  8. $spreadsheet = new Spreadsheet();
  9. $activeWorksheet = $spreadsheet->getActiveSheet();
  10. $activeWorksheet->setCellValue('A1', 'Hello World !');
  12. $writer = new Xlsx($spreadsheet);
  13. $writer->save('hello world.xlsx');

跟着例子学习 spreadsheet

学习 spreadsheet 的好方法是运行一些 demo。不要忘记通过 -prefer-source composer 标志下载它们。然后通过 PHP 内置的 webserver 来加载它：

  1. php -S localhost:8000 -t vendor/phpoffice/phpspreadsheet/samples

然后通过浏览器访问：http://localhost:8000/

可以在命令行中执行如下命令来运行示例

  1. php vendor/phpoffice/phpspreadsheet/samples/Basic/01_Simple.php