README

PHPPowerPoint是一个使用纯PHP编写的库，提供了一套用于写入不同演示文稿文件格式的类，例如Microsoft Office Open XML（OOXML或OpenXML）或OASIS Open Document Format for Office Applications（OpenDocument或ODF）。

PHPPowerPoint是一个开源项目，根据LGPL版本3的条款授权。PHPPowerPoint旨在通过整合持续集成和单元测试来成为一款高质量的软件产品。您可以阅读开发者文档和API文档来了解更多关于PHPPowerPoint的信息。

了解更多关于PHPPowerPoint的信息

• 功能
• 要求
• 安装
• 入门
• 已知问题
• 贡献
• 开发者文档
• API文档

功能

• 创建内存中的演示文稿表示
• 设置演示文稿元数据（作者、标题、描述等）
• 从头开始或从现有幻灯片添加幻灯片
• 支持不同的字体和字体样式
• 支持不同的格式、样式、填充、渐变
• 支持超链接和富文本字符串
• 添加不同样式的图片（位置、旋转、阴影）
• 设置打印选项（页眉、页脚、页边距、纸张大小、方向）
• 输出到不同的文件格式：PowerPoint 2007 (.pptx)、OpenDocument演示文稿 (.odp)、序列化演示文稿
• ...还有很多其他功能！

要求

PHPPowerPoint需要以下内容

• PHP 5.3+
• Zip扩展
• XML解析器扩展
• XMLWriter扩展（可选，用于写入DOCX和ODT）

安装

建议您通过composer安装PHPPowerPoint库。为此，请将以下行添加到您的composer.json文件中。

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

或者，您可以从发布页面下载最新版本。在这种情况下，您将需要注册自动加载器。注册自动加载器仅在您的项目中不使用composer时才需要。

require_once 'path/to/PhpPowerpoint/src/PhpPowerpoint/Autoloader.php';
\PhpOffice\PhpPowerpoint\Autoloader::register();

入门

以下是PHPPowerPoint库的基本用法示例。

require_once 'src/PhpPowerpoint/Autoloader.php';
\PhpOffice\PhpPowerpoint\Autoloader::register();

$objPHPPowerPoint = new PhpPowerpoint();

// Create slide
$currentSlide = $objPHPPowerPoint->getActiveSlide();

// Create a shape (drawing)
$shape = $currentSlide->createDrawingShape();
$shape->setName('PHPPowerPoint logo')
      ->setDescription('PHPPowerPoint logo')
      ->setPath('./resources/phppowerpoint_logo.gif')
      ->setHeight(36)
      ->setOffsetX(10)
      ->setOffsetY(10);
$shape->getShadow()->setVisible(true)
                   ->setDirection(45)
                   ->setDistance(10);

// Create a shape (text)
$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 PHPPowerPoint!');
$textRun->getFont()->setBold(true)
                   ->setSize(60)
                   ->setColor( new Color( 'FFE06B20' ) );
                   
$oWriterPPTX = IOFactory::createWriter($objPHPPowerPoint, 'PowerPoint2007');
$oWriterPPTX->save(__DIR__ . "/sample.pptx");
$oWriterODP = IOFactory::createWriter($objPHPPowerPoint, 'ODPresentation');
$oWriterODP->save(__DIR__ . "/sample.odp");

在示例文件夹中提供了更多示例。您还可以阅读开发者文档和API文档以获取更多详细信息。

贡献

我们欢迎每个人为PHPPowerPoint做出贡献。以下是一些您可以做的事情来贡献

• 阅读我们的贡献指南
• Fork我们并请求向develop分支拉取请求
• 向GitHub提交错误报告或功能请求
• 关注 @PHPOffice 在Twitter上