快速上手

软件要求

使用 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
  2. require 'vendor/autoload.php';
  3. use PhpOffice\PhpSpreadsheet\Spreadsheet;
  4. use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
  5. $spreadsheet = new Spreadsheet();
  6. $activeWorksheet = $spreadsheet->getActiveSheet();
  7. $activeWorksheet->setCellValue('A1', 'Hello World !');
  8. $writer = new Xlsx($spreadsheet);
  9. $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