PHPPresentation 开源项目教程

1. 项目介绍

PHPPresentation 是一个用纯 PHP 编写的库，用于读写演示文稿文档。它支持多种文件格式，包括 Microsoft Office Open XML（OOXML 或 OpenXML）和 OASIS Open Document Format for Office Applications（OpenDocument 或 ODF）。PHPPresentation 是一个开源项目，遵循 LGPL 版本 3 许可证。该项目旨在通过持续集成和单元测试来提供高质量的软件产品。

2. 项目快速启动

安装

推荐使用 Composer 安装 PHPPresentation 库。在你的 composer.json 文件中添加以下内容：

{
  "require": {
    "phpoffice/phppresentation": "dev-master"
  }
}

然后运行 composer install 命令。

基本使用示例

以下是一个基本的 PHPPresentation 使用示例：

require_once 'vendor/autoload.php';

use PhpOffice\PhpPresentation\PhpPresentation;
use PhpOffice\PhpPresentation\IOFactory;
use PhpOffice\PhpPresentation\Style\Color;
use PhpOffice\PhpPresentation\Style\Alignment;

$objPHPPowerPoint = new PhpPresentation();

// 创建幻灯片
$currentSlide = $objPHPPowerPoint->getActiveSlide();

// 创建一个图形（图片）
$shape = $currentSlide->createDrawingShape();
$shape->setName('PHPPresentation logo')
      ->setDescription('PHPPresentation logo')
      ->setPath('/resources/phppowerpoint_logo.gif')
      ->setHeight(36)
      ->setOffsetX(10)
      ->setOffsetY(10);
$shape->getShadow()->setVisible(true)
                   ->setDirection(45)
                   ->setDistance(10);

// 创建一个文本框
$shape = $currentSlide->createRichTextShape()
                      ->setHeight(300)
                      ->setWidth(600)
                      ->setOffsetX(170)
                      ->setOffsetY(180);
$shape->getActiveParagraph()->getAlignment()->setHorizontal(Alignment::HORIZONTAL_CENTER);

$textRun = $shape->createTextRun('Thank you for using PHPPresentation!');
$textRun->getFont()->setBold(true)
                   ->setSize(60)
                   ->setColor(new Color('FFE06B20'));

// 保存为 PowerPoint 2007 格式
$oWriterPPTX = IOFactory::createWriter($objPHPPowerPoint, 'PowerPoint2007');
$oWriterPPTX->save(__DIR__ . "/sample.pptx");

// 保存为 OpenDocument Presentation 格式
$oWriterODP = IOFactory::createWriter($objPHPPowerPoint, 'ODPresentation');
$oWriterODP->save(__DIR__ . "/sample.odp");

3. 应用案例和最佳实践

应用案例

PHPPresentation 可以用于以下场景：

• 自动化报告生成：在企业环境中，自动生成和分发报告。
• 在线教育平台：生成课程幻灯片，支持多种格式导出。
• 数据可视化：将数据可视化结果导出为演示文稿格式。

最佳实践

• 使用 Composer：推荐使用 Composer 管理依赖，确保项目的可维护性和可扩展性。
• 遵循代码规范：使用 PHP CS Fixer 等工具确保代码风格一致。
• 单元测试：编写单元测试以确保代码的稳定性和可靠性。

4. 典型生态项目

• PHPOffice/PhpSpreadsheet：用于处理 Excel 文件的 PHP 库。
• PHPOffice/PhpWord：用于处理 Word 文档的 PHP 库。
• PHPOffice/Common：提供 PHPOffice 项目的通用功能和工具。

这些项目共同构成了 PHPOffice 生态系统，为 PHP 开发者提供了丰富的文档处理工具。