在 PHP 中管理簡報超連結

本頁內容簡介

使用 Aspose.Slides for PHP via Java，透過 PHP 範例在 PowerPowerPoint 與 OpenDocument 簡報中新增、格式化、更新與移除超連結。

簡介

超連結將簡報內容連接至網站或簡報內的某個位置。在 PowerPoint 中，超連結通常有兩種用途：

從文字、圖形或多媒體框格開啟網站。
從目錄等導航至其他投影片。

Aspose.Slides for PHP via Java 讓您可以新增這些連結、控制其外觀與聲音、更新其屬性並移除它們。以下範例示範如何在單一元素上使用超連結，及如何在簡報、投影片或文字框層級存取超連結。範例假設已初始化 PHP/Java Bridge 與 Aspose.Slides PHP 包裝器。未提供 PHP 參考頁面的 API 成員會連結至底層的 Java API。

Note

您也可以使用免費線上 Aspose PowerPoint 編輯器來編輯簡報。

新增 URL 超連結

您可以將網站 URL 指派給文字、圖形或多媒體框格。指派超連結的元素決定可點擊區域：文字部份會連結所選文字，而圖形或框格則會連結整個投影片物件。

將 URL 超連結新增至文字

若要將文字連結至網站，將 Hyperlink 傳遞給文字部份的 setHyperlinkClick 方法，如下所示。僅該文字部份會變成可點擊。

use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $textShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50, false);
    $textShape->addTextFrame("Aspose: File Format APIs");
    $portionFormat = $textShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
    $portionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
    $portionFormat->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
    $portionFormat->setFontHeight(32);

    $presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

將 URL 超連結新增至圖形與多媒體框格

若要使圖形或框格可點擊，呼叫其 setHyperlinkClick 方法。超連結屬於該物件本身，而非其中的文字部份。

相同方式也適用於圖片、音訊與視訊框格：將超連結指派給框格，必要時呼叫 setTooltip。

以下範例會使矩形可點擊：

use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50);

    $shape->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
    $shape->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");

    $presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

使用超連結建立目錄

內部超連結可讓讀者從目錄跳至特定投影片。以下範例使用 setInternalHyperlinkClick 將第一張投影片的「Page 2」文字連結至第二張投影片。

use aspose\slides\FillType;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $firstSlide = $presentation->getSlides()->get_Item(0);
    $secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());

    $tableOfContents = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 40, 40, 300, 100);
    $tableOfContents->getFillFormat()->setFillType(FillType::NoFill);
    $tableOfContents->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
    $tableOfContents->getTextFrame()->getParagraphs()->clear();

    $paragraph = new Paragraph();
    $paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $paragraph->setText("Title of slide 2 .......... ");

    $linkPortion = new Portion();
    $linkPortion->setText("Page 2");
    $linkPortion->getPortionFormat()->getHyperlinkManager()->setInternalHyperlinkClick($secondSlide);

    $paragraph->getPortions()->add($linkPortion);
    $tableOfContents->getTextFrame()->getParagraphs()->add($paragraph);

    $presentation->save("link_to_slide.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

格式化超連結

顏色

setColorSource 方法（屬於 Hyperlink）決定超連結使用簡報的超連結顏色或文字部份的格式。若要套用自訂文字顏色，請選取 HyperlinkColorSource::PortionFormat 並設定該部份的填色。本功能於 PowerPoint 2019 中首次加入；較舊版本不會套用此設定。

以下範例在同一投影片上新增兩個文字超連結。第一個使用紅色文字填色，第二個則保留預設的超連結顏色。

use aspose\slides\FillType;
use aspose\slides\Hyperlink;
use aspose\slides\HyperlinkColorSource;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $coloredShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 450, 50, false);
    $coloredShape->addTextFrame("This hyperlink uses a custom color.");
    $coloredPortionFormat = $coloredShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
    $coloredPortionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
    $coloredPortionFormat->getHyperlinkClick()->setColorSource(HyperlinkColorSource::PortionFormat);
    $coloredPortionFormat->getFillFormat()->setFillType(FillType::Solid);
    $coloredPortionFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);

    $defaultShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 450, 50, false);
    $defaultShape->addTextFrame("This hyperlink uses the default color.");
    $defaultShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));

    $presentation->save("presentation-out-hyperlink.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

音效

超連結在啟動時可以播放音效，或停止已在播放的音效。可使用以下方法設定這些行為：

Hyperlink::setSound 指定與超連結相關聯的音訊。
Hyperlink::setStopSoundOnClick 控制在點擊超連結時是否停止先前的音效。

新增超連結音效

以下範例載入 sampleaudio.wav 並將其與第一張投影片上的按鈕關聯。點擊按鈕會播放音效並跳至下一張投影片。該投影片上的第二個圖形在點擊時會停止先前的音效，且不執行任何導覽操作。

use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $audioFile = new Java("java.io.File", "sampleaudio.wav");
    $audioPath = $audioFile->toPath();
    $audioData = java("java.nio.file.Files")->readAllBytes($audioPath);
    $hyperlinkSound = $presentation->getAudios()->addAudio($audioData);

    $firstSlide = $presentation->getSlides()->get_Item(0);

    $playButton = $firstSlide->getShapes()->addAutoShape(ShapeType::SoundButton, 100, 100, 100, 50);
    $playButton->setHyperlinkClick(Hyperlink::getNextSlide());

    if (!java_values($playButton->getHyperlinkClick()->getStopSoundOnClick()) && java_is_null($playButton->getHyperlinkClick()->getSound()))
    {
        $playButton->getHyperlinkClick()->setSound($hyperlinkSound);
    }

    $secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());

    $stopButton = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 100, 50);
    $stopButton->setHyperlinkClick(Hyperlink::getNoAction());

    $stopButton->getHyperlinkClick()->setStopSoundOnClick(true);

    $presentation->save("hyperlink-sound.pptx", SaveFormat::Pptx);
} catch (JavaException $exception) {
    echo "Unable to read the audio file: " . $exception->getMessage() . PHP_EOL;
} finally {
    $presentation->dispose();
}

擷取超連結音效

以下範例開啟上述建立的簡報，並透過 getSound 與 getBinaryData 讀取第一個圖形的超連結音訊至記憶體。

use aspose\slides\Presentation;

$presentation = new Presentation("hyperlink-sound.pptx");
try {
    if (java_values($presentation->getSlides()->size()) > 0 && java_values($presentation->getSlides()->get_Item(0)->getShapes()->size()) > 0) {
        $hyperlink = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getHyperlinkClick();
        $sound = java_is_null($hyperlink) ? null : $hyperlink->getSound();
        if (!java_is_null($sound)) {
            $audioData = $sound->getBinaryData();
            echo "Extracted " . strlen(java_values($audioData)) . " bytes of hyperlink audio." . PHP_EOL;
        } else {
            echo "The first shape has no hyperlink sound." . PHP_EOL;
        }
    } else {
        echo "The presentation has no first slide or shape to inspect." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

提示文字與互動設定

在將超連結指派給文字或圖形後，您可以呼叫以下 Hyperlink 方法：

setTooltip 設定檢視者可顯示為連結提示的文字。
setTargetFrame 指定在父 HTML 框架集中 (如適用) 的目標框架。
setHistory 控制在啟動連結時是否將其目的地加入已檢視超連結的清單。
setHighlightClick 控制點擊時是否突出顯示超連結。

從簡報中移除超連結

使用 getAnyHyperlinks 於變更前收集超連結容器（包括文字部份連結）。以下範例會從第一張投影片移除兩種啟動方式。若僅需移除其中一種，請僅呼叫 removeHyperlinkClick 或 removeHyperlinkMouseOver；移除點擊動作不會同時移除滑鼠移過的對應動作。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("pres.pptx");
try {
    if (java_values($presentation->getSlides()->size()) > 0) {
        $containers = [];
        foreach ($presentation->getSlides()->get_Item(0)->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
            $containers[] = $container;
        }
        foreach ($containers as $container) {
            $container->getHyperlinkManager()->removeHyperlinkClick();
            $container->getHyperlinkManager()->removeHyperlinkMouseOver();
        }
        $presentation->save("pres-removed-hyperlinks.pptx", SaveFormat::Pptx);
    } else {
        echo "The presentation has no slides to process." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

若要無條件移除，可使用 removeAllHyperlinks 在一次呼叫中移除所選範圍內的兩種啟動方式。若需選擇性清理並涵蓋母片、版面配置與備註，請參閱 Report, Sanitize, and Verify Hyperlinks。

建立完整的超連結清單

在發佈簡報之前，先清點其互動操作與網路連結。getAnyHyperlinks 會傳回 IHyperlinkContainer 物件，而非單純的 URL 字串清單。請檢查每個容器的 getHyperlinkClick 與 getHyperlinkMouseOver。它們是獨立的：同一容器可能同時提供兩種動作，因此完整報告可能需要每個容器最多兩列。

僅掃描圖形層級的超連結可能會遺漏附加於文字部份的連結。請改為查詢適當的範圍，並保留返回的容器，以便稍後更新或移除其動作。

查詢簡報、投影片與文字框範圍

HyperlinkQueries 類別可透過 Presentation::getHyperlinkQueries、IBaseSlide::getHyperlinkQueries 與 TextFrame::getHyperlinkQueries 取得。每個範圍支援相同的查詢：

getHyperlinkClicks 回傳具有點擊動作的容器。
getHyperlinkMouseOvers 回傳具有滑鼠移過動作的容器。
getAnyHyperlinks 回傳具有任一或兩者動作的容器。

以下範例建立 hyperlink-audit-input.pptx，其中包含外部點擊連結、檔案滑鼠移過連結、內部投影片導覽、文字滑鼠移過連結，以及巨集動作。此範例不會執行任何這些動作。相同的三個查詢在每個範圍皆適用；計數描述的是容器數量，而非動作總數。文字框範圍會排除其所屬圖形本身的連結。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

function printQueryCounts($scope, $queries) {
    $clickCount = java_values($queries->getHyperlinkClicks()->size());
    $mouseOverCount = java_values($queries->getHyperlinkMouseOvers()->size());
    $anyCount = java_values($queries->getAnyHyperlinks()->size());
    echo "$scope: click=$clickCount, mouse-over=$mouseOverCount, any=$anyCount" . PHP_EOL;
}

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $destination = $presentation->getSlides()->addEmptySlide($slide->getLayoutSlide());
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 400, 60);
    $shape->getTextFrame()->setText("Click the text to go to slide 2");
    $shape->getHyperlinkManager()->setExternalHyperlinkClick("https://example.com/");
    $shape->getHyperlinkClick()->setTooltip("Public website");
    $shape->getHyperlinkManager()->setExternalHyperlinkMouseOver("file:///C:/private/report.xlsx");

    $portionFormat = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
    $portionFormat->getHyperlinkManager()->setInternalHyperlinkClick($destination);
    $portionFormat->getHyperlinkManager()->setExternalHyperlinkMouseOver("https://example.com/help");
    $macroButton = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 120, 200, 60);
    $macroButton->getHyperlinkManager()->setMacroHyperlinkClick("ReviewPresentation");

    printQueryCounts("Presentation", $presentation->getHyperlinkQueries());
    printQueryCounts("Slide 1", $slide->getHyperlinkQueries());
    printQueryCounts("Text frame", $shape->getTextFrame()->getHyperlinkQueries());
    $presentation->save("hyperlink-audit-input.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

在此範例中，簡報與投影片的查詢各回報三個點擊容器、兩個滑鼠移過容器，以及三個任一動作的容器。文字框查詢則在每個類別回報一個容器。

分類動作與目的地

使用 Hyperlink::getActionType 先判斷動作類型，再解析其目的地。HyperlinkActionType 的值涵蓋了超過網頁導覽的情況：

Values	審核意義
`Hyperlink`	外部超連結；檢查 URL 及其協議。
`JumpSpecificSlide`	內部導覽至特定投影片。
`JumpFirstSlide`, `JumpPreviousSlide`, `JumpNextSlide`, `JumpLastSlide`, `JumpLastViewedSlide`	內建投影片放映導覽，於放映環境中解析。
`JumpEndShow`, `StartCustomSlideShow`	結束目前的放映或啟動自訂投影片放映。
`StartMacro`	執行巨集。
`StartProgram`	啟動程式。
`OpenFile`, `OpenPresentation`	開啟檔案或其他簡報；需與網路 URL 分別審查。
`StartStopMedia`	開始或停止媒體播放。
`NoAction`, `Unknown`	無導覽動作，或未識別的動作，需要審查。

從 getExternalUrl 讀取外部目的地，從 getTargetSlide 讀取特定內部目的地。內部動作與內建指令可能沒有外部 URL；空的 URL 並不表示容器沒有動作。當 getExternalUrlOriginal 回傳的值與正規化的 URL 不同時，請保留該值，且在可用時包含由 getTooltip 回傳的提示文字。

報告、清理與驗證超連結

以下 PHP 範例讀取現有的簡報（使用上述建立的檔案），寫入 hyperlink-audit.json，套用政策，儲存為 hyperlink-sanitized.pptx，並重新開啟以再次檢查兩種啟動方式。它在變更前收集容器，並利用參照相等性避免重複處理同一容器。簡報查詢涵蓋普通投影片；若要進行套件範圍的清點，亦會明確查詢母片、版面配置、備註，以及存在時的備註與講義母片。

報告記錄以 1 為起始的投影片索引與可用的 getSlideId。對於支援的容器，ISlideComponent::getSlide 提供其所屬投影片。母片、版面配置與備註並無普通投影片索引，會以其範圍辨識。圖形容器與文字部份格式容器會分別標記；其他容器類型保留其執行時類型名稱。每個容器在報告中取得本地 ID，以便關聯其兩個動作。報告將動作類型儲存為 PHP 列舉定義的整數常數。

此刻意嚴格的應用程式政策僅允許絕對的 HTTPS URL 與有效的內部投影片目標。它會拒絕巨集、程式、檔案動作、其他投影片放映動作、未知動作以及其他 URL 協定。這些拒絕屬於政策決策，而非 Aspose.Slides 安全性判斷。僅有 HTTPS 並不足以建立信任：請為您的應用程式加入主機白名單與其他檢查。原始與正規化的外部 URL 皆會被檢查。此範例僅審核中繼資料，未跟隨連結或執行動作。

若需修正，容器的 getHyperlinkManager 支援 setExternalHyperlinkClick、removeHyperlinkClick 與 removeHyperlinkMouseOver。此處會將被禁止的外部點擊連結取代為固定的 HTTPS 登陸頁面；其他被禁止的點擊與被禁止的滑鼠移過動作則分別移除。將 $replaceExternalClicks 設為 false 則可直接移除所有違反政策的項目。請於部署前選擇應用程式自有的取代頁面。

報告的匯出標記採用保守的 PDF 審查政策：將滑鼠移過動作以及除外部連結或特定投影片跳轉之外的任何動作標記為可能不受支援。這僅是審查提示，非功能測試，也不保證未標記的連結在匯出時會存續。支援的 PDF 與 HTML 匯出可能會保留超連結，視動作、匯出選項與檢視器而定。光柵 images 與 video 無法保留互動超連結；在為這些輸出執行審計時，請將每個動作皆標記。

use aspose\slides\HyperlinkActionType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

class HyperlinkAudit {
    public function slideIndex($presentation, $slide) {
        if (java_is_null($slide)) return null;
        for ($index = 0; $index < java_values($presentation->getSlides()->size()); $index++) {
            if (java_values($presentation->getSlides()->get_Item($index)->equals($slide))) return $index + 1;
        }
        return null;
    }

    public function isHttps($value) {
        if ($value === null || $value === '') return false;
        $parts = parse_url($value);
        return $parts !== false && isset($parts['scheme'], $parts['host']) && strcasecmp($parts['scheme'], 'https') === 0 && $parts['host'] !== '';
    }

    public function policyViolation($link) {
        if (java_is_null($link)) return null;
        $action = java_values($link->getActionType());
        if ($action === HyperlinkActionType::JumpSpecificSlide) {
            return java_is_null($link->getTargetSlide()) ? 'Missing target slide' : null;
        }
        if ($action !== HyperlinkActionType::Hyperlink) return 'Action is not allowed';
        if (!$this->isHttps(java_values($link->getExternalUrl()))) return 'Normalized URL is not absolute HTTPS';
        $original = java_values($link->getExternalUrlOriginal());
        if ($original !== null && $original !== '' && !$this->isHttps($original)) return 'Original URL is not absolute HTTPS';
        return null;
    }

    public function addScope(&$found, $slide) {
        if (!java_is_null($slide)) {
            foreach ($slide->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
                $found[] = $container;
            }
        }
    }

    public function collectContainers($presentation) {
        $found = [];
        foreach ($presentation->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
            $found[] = $container;
        }
        $masters = $presentation->getMasters();
        for ($index = 0; $index < java_values($masters->size()); $index++) {
            $this->addScope($found, $masters->get_Item($index));
        }
        $layouts = $presentation->getLayoutSlides();
        for ($index = 0; $index < java_values($layouts->size()); $index++) {
            $this->addScope($found, $layouts->get_Item($index));
        }
        $slides = $presentation->getSlides();
        for ($index = 0; $index < java_values($slides->size()); $index++) {
            $this->addScope($found, $slides->get_Item($index)->getNotesSlideManager()->getNotesSlide());
        }
        $this->addScope($found, $presentation->getMasterNotesSlideManager()->getMasterNotesSlide());
        $this->addScope($found, $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide());
        $seen = new Java('java.util.IdentityHashMap');
        $unique = [];
        foreach ($found as $container) {
            if (!java_values($seen->containsKey($container))) {
                $seen->put($container, true);
                $unique[] = $container;
            }
        }
        return $unique;
    }

    public function addRow(&$rows, $presentation, $link, $activation, $container, $containerId) {
        if (java_is_null($link)) return;
        $ownerSlide = java_instanceof($container, java('com.aspose.slides.ISlideComponent')) ? $container->getSlide() : null;
        $targetSlide = $link->getTargetSlide();
        $violation = $this->policyViolation($link);
        $ownerType = java_instanceof($container, java('com.aspose.slides.IShape')) ? 'Shape' : (java_instanceof($container, java('com.aspose.slides.IPortionFormat')) ? 'Text portion' : java_values($container->getClass()->getSimpleName()));
        $action = java_values($link->getActionType());
        $ordinaryAction = $action === HyperlinkActionType::Hyperlink || $action === HyperlinkActionType::JumpSpecificSlide;
        $externalUrl = java_values($link->getExternalUrl());
        $originalUrl = java_values($link->getExternalUrlOriginal());
        $rows[] = [
            'ContainerId' => $containerId,
            'SlideIndex' => $this->slideIndex($presentation, $ownerSlide),
            'SlideId' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getSlideId()),
            'Scope' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getClass()->getSimpleName()),
            'OwnerType' => $ownerType,
            'Activation' => $activation,
            'ActionType' => $action,
            'ExternalUrl' => $externalUrl,
            'TargetSlideIndex' => $this->slideIndex($presentation, $targetSlide),
            'TargetSlideId' => java_is_null($targetSlide) ? null : java_values($targetSlide->getSlideId()),
            'Tooltip' => java_values($link->getTooltip()),
            'OriginalExternalUrl' => $originalUrl === $externalUrl ? null : $originalUrl,
            'PotentiallyUnsafe' => $violation !== null,
            'PolicyViolation' => $violation,
            'TargetExport' => 'PDF',
            'PotentiallyUnsupportedByExport' => $activation === 'mouse-over' || !$ordinaryAction
        ];
    }
}

$replaceExternalClicks = true;
$replacementUrl = 'https://example.com/blocked-link';
$audit = new HyperlinkAudit();
$presentation = new Presentation('hyperlink-audit-input.pptx');
try {
    $containers = $audit->collectContainers($presentation);
    $rows = [];
    foreach ($containers as $index => $container) {
        $audit->addRow($rows, $presentation, $container->getHyperlinkClick(), 'click', $container, $index + 1);
        $audit->addRow($rows, $presentation, $container->getHyperlinkMouseOver(), 'mouse-over', $container, $index + 1);
    }
    $json = json_encode($rows, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
    if ($json === false) {
        echo 'Unable to encode the audit report: ' . json_last_error_msg() . PHP_EOL;
    } elseif (file_put_contents('hyperlink-audit.json', $json . PHP_EOL) === false) {
        echo 'Unable to write the audit report.' . PHP_EOL;
    } else {
        foreach ($containers as $container) {
            $click = $container->getHyperlinkClick();
            if ($audit->policyViolation($click) !== null) {
                if ($replaceExternalClicks && java_values($click->getActionType()) === HyperlinkActionType::Hyperlink) {
                    $container->getHyperlinkManager()->setExternalHyperlinkClick($replacementUrl);
                } else {
                    $container->getHyperlinkManager()->removeHyperlinkClick();
                }
            }
            if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) {
                $container->getHyperlinkManager()->removeHyperlinkMouseOver();
            }
        }
        $presentation->save('hyperlink-sanitized.pptx', SaveFormat::Pptx);

        $reopened = new Presentation('hyperlink-sanitized.pptx');
        try {
            $remainingContainers = $audit->collectContainers($reopened);
            $violations = 0;
            foreach ($remainingContainers as $container) {
                if ($audit->policyViolation($container->getHyperlinkClick()) !== null) $violations++;
                if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) $violations++;
            }
            echo 'Audit rows: ' . count($rows) . '; prohibited actions after reopening: ' . $violations . PHP_EOL;
            if ($violations !== 0) {
                echo 'Verification failed: do not distribute the saved presentation.' . PHP_EOL;
            }
        } finally {
            $reopened->dispose();
        }
    }
} finally {
    $presentation->dispose();
}

使用上述建立的輸入，報告包含五筆動作列。檔案滑鼠移過連結與巨集點擊已被移除，而 HTTPS 連結與內部投影片導覽則保留。驗證結果顯示零個被禁止的動作。包含被禁止的外部點擊 URL 的輸入也會測試取代分支。具備允許的點擊且被禁止的滑鼠移過的容器會保留其點擊動作。

此選擇性清理與 removeAllHyperlinks 不同，後者會無條件在所選範圍內移除兩種啟動方式，不考慮政策。此處的驗證僅檢查超連結動作；不會移除嵌入的 VBA 專案、OLE 物件或其他動態內容，也不會驗證匯出的 PDF 或 HTML 檔案。

常見問答

如何將連結指向特定區段或其第一張投影片？

PowerPoint 中的區段會將投影片分組，但內部超連結只能指向單一投影片。若要導向區段，請將連結指向該區段的第一張投影片。

我可以將超連結附加到母片元素，使其在所有投影片上皆有效嗎？

可以。母片與版面配置的元素支援超連結。這些元素上的連結會在使用相應母片或版面配置的投影片放映時生效。

匯出為 PDF、HTML、圖像或影片時，超連結會被保留嗎？

支援的 PDF 與 HTML 匯出可能會保留超連結；光柵圖像與影片則不會。請參閱 Report, Sanitize, and Verify Hyperlinks 中的匯出注意事項。

在 PHP 中管理簡報 BLOB 以有效使用記憶體在 PHP 中管理媒體檔案