Composer 安装 PHPPresentation 失败主因是 PHP 版本超 7.4、缺少 zip/xml 扩展及依赖冲突；推荐改用 imliam/phppresentation 分支，适配 PHP 8.0–8.3 并修复自动加载问题。
Composer 安装 PHPPresentation 失败？先确认 PHP 版本和扩展
PHPPresentation（即 phpoffice/phppresentation）已停止维护，官方推荐迁移到 phpoffice/phpspreadsheet 的幻灯片功能（尚未实现），或改用活跃的替代方案如 imliam/phppresentation（社区维护分支）。直接运行 composer require phpoffice/phppresentation 很可能失败，原因包括：
- PHP 版本不兼容：原版仅支持 PHP ≤ 7.4，8.0+ 会报
Root composer.json requires phpoffice/phppresentation ^0.10.0 -> satisfiable by phpoffice/phppresentation[0.10.0]后卡住 - 缺少
zip和xml扩展：生成 .pptx 必须启用，否则运行时报Class 'ZipArchive' not found - 依赖冲突：它硬依赖旧版
phpoffice/phpexcel，而该库与现代 Laravel/ Symfony 项目中的phpspreadsheet冲突
建议改用社区维护的分支：composer require imliam/phppresentation，它适配 PHP 8.0–8.3，并修复了命名空间和 PSR-4 加载问题。
引入 PHPPresentation 后调用 PresentationBuilder 报类未找到？自动加载没生效
即使 Composer 安装成功，new \PhpPresentation\IOFactory() 或 \PhpPresentation\PresentationBuilder::create() 仍可能报 Class not found。这不是代码写错，而是自动加载路径没刷进去：
- 确认
vendor/autoload.php已在入口文件中require，且路径正确（比如 CLI 脚本里写成require __DIR__.'/../vendor/autoload.php';而实际目录结构是src/vendor） - 执行
composer dump-autoload -o强制优化自动加载，尤其在添加新类或修改composer.json后 -
imliam/phppresentation的根命名空间是PhpPresentation，不是PhpOffice\PhpPresentation—— 错写命名空间是高频错误
最小验证代码：
立即学习“PHP免费学习笔记（深入）”；
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
<?php
require 'vendor/autoload.php';
use PhpPresentation\IOFactory;
use PhpPresentation\PresentationBuilder;
$phpPresentation = PresentationBuilder::create();
$slide = $phpPresentation->getActiveSlide();
$slide->createTextShape()->setText('Hello World');
$writer = IOFactory::createWriter($phpPresentation, 'PowerPoint2007');
$writer->save('test.pptx');
生成的 PPTX 打不开或提示“文件已损坏”？ZIP 写入权限和临时目录是关键
常见现象：代码无报错，文件生成了，但双击提示“PowerPoint 无法打开该文件”，或 Excel 提示“发现不可读内容”。根本原因往往不在 PHPPresentation 本身，而在底层 ZIP 封装环节：
- 目标路径（如
test.pptx）所在目录没有写权限，导致 ZIP 流写入不完整 —— 检查is_writable(dirname($path)) - 系统临时目录（
sys_get_temp_dir()）满或不可写，PHPPresentation 默认用它缓存 ZIP 分卷 —— 可显式指定临时路径：$writer->setTempDir('/tmp/phppresentation'); - PHP 的
open_basedir限制了临时目录访问，需在php.ini中放开，或改用内存流（不推荐大文件）
调试技巧：用 unzip -t test.pptx 在终端校验 ZIP 完整性；若报 broken，基本可锁定是写入阶段中断。
导出中文文本乱码或不显示？字体设置必须显式指定
PHPPresentation 默认不嵌入中文字体，setText() 填中文后，PPTX 在 Windows 上可能显示方块，在 macOS 上干脆空白。这不是编码问题（源文件 UTF-8 即可），而是字体缺失：
- 必须为每个
TextShape设置中文字体：$shape->setFontName('Microsoft YaHei')或'SimSun'（注意：字体名要和系统实际安装名称一致） - 避免用
setFontSize()单独调用，应链式写：$shape->setText('你好')->setFontName('Microsoft YaHei')->setFontSize(24) - 不支持 TTF 文件嵌入，所以不能指望“打包字体”——只能依赖目标机器是否装了同名字体
如果需要强一致性，唯一办法是转成图片再插入（用 GD 或 Imagick 渲染文字后 $slide->createDrawingShape()->setImageResource(...)），但会失去文本可编辑性。
真正麻烦的是跨平台字体映射：Windows 的 SimSun、macOS 的 STSong、Linux 的 WenQuanYi Zen Hei 名称全不同，没银弹，得按部署环境单独适配。
