Truy xuất và Cập nhật Thông tin Bản trình bày trong PHP

Trang này nói về điều gì

Khám phá các slide, cấu trúc và siêu dữ liệu trong các bản trình bày PowerPoint và OpenDocument bằng Aspose.Slides cho PHP để có được những hiểu biết nhanh hơn và kiểm toán nội dung thông minh hơn.

Tổng quan

Aspose.Slides có thể xác định định dạng của một bản trình bày và đọc siêu dữ liệu tài liệu mà không cần tạo một mô hình đối tượng bản trình bày đầy đủ. Điều này hữu ích khi bạn cần phân loại tệp, xây dựng một danh mục, hoặc kiểm tra các thuộc tính trước khi quyết định tải và xử lý nội dung bản trình bày.

Bài viết này trình bày cách kiểm tra nhẹ thông qua PresentationFactory và PresentationInfo, cũng như cách cập nhật có mục tiêu thông qua DocumentProperties.

Kiểm tra định dạng bản trình bày

Nếu bạn đã có một bản trình bày đã tải, hãy xem mục Determine the Original Presentation Format để phát hiện sau khi tải và các hạn chế của các luồng PPT, PPS và POT legacy.

Sử dụng PresentationFactory::getPresentationInfo để kiểm tra tệp mà không tạo một thể hiện Presentation. Phương thức PresentationInfo::getLoadFormat sẽ báo cáo định dạng đã phát hiện, chẳng hạn PPTX, PPT hoặc ODP.

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$fileNames = ["pres.pptx", "pres.ppt", "pres.odp"];

foreach ($fileNames as $fileName) {
    $presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($fileName);
    $loadFormat = java_values($presentationInfo->getLoadFormat());
    $formatName = "Other (" . $loadFormat . ")";

    if ($loadFormat === LoadFormat::Pptx) {
        $formatName = "PPTX";
    } elseif ($loadFormat === LoadFormat::Ppt) {
        $formatName = "PPT";
    } elseif ($loadFormat === LoadFormat::Odp) {
        $formatName = "ODP";
    }

    echo $fileName . ": " . $formatName . PHP_EOL;
}

Xây dựng danh mục bản trình bày nhẹ

Khi bạn xử lý nhiều tệp bản trình bày, bạn có thể cần một danh mục gọn nhẹ để xác thực, lập chỉ mục, hoặc cho hệ thống quản lý tài liệu. Trong trường hợp này, hãy sử dụng PresentationFactory::getPresentationInfo để lấy một đối tượng PresentationInfo, sau đó gọi PresentationInfo::readDocumentProperties để đọc siêu dữ liệu tài liệu. Cách tiếp cận này không tạo một thể hiện Presentation và cũng không yêu cầu bạn duyệt toàn bộ mô hình đối tượng bản trình bày.

Các thuộc tính mở rộng được cung cấp bởi DocumentProperties cung cấp các giá trị kiểm kê sau:

Phương thức	Giá trị kiểm kê
getSlides	Tổng số slide.
getHiddenSlides	Số slide ẩn.
getNotes	Số slide có ghi chú.
getParagraphs	Tổng số đoạn văn khi có sẵn.
getWords	Tổng số từ.
getMultimediaClips	Tổng số đoạn âm thanh và video.

Ví dụ dưới đây đọc các giá trị này mà không tạo đối tượng Presentation và in ra một danh mục gọn nhẹ. Nó cũng kết hợp DocumentProperties::getHeadingPairs với DocumentProperties::getTitlesOfParts để hiển thị các nhóm nội dung như phông chữ, chủ đề và tiêu đề slide.

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$filePath = "sample.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($filePath);
$documentProperties = $presentationInfo->readDocumentProperties();

$loadFormat = java_values($presentationInfo->getLoadFormat());
$formatName = "Other (" . $loadFormat . ")";

if ($loadFormat === LoadFormat::Pptx) {
    $formatName = "PPTX";
} elseif ($loadFormat === LoadFormat::Ppt) {
    $formatName = "PPT";
} elseif ($loadFormat === LoadFormat::Odp) {
    $formatName = "ODP";
}

echo "File: " . basename($filePath) . PHP_EOL;
echo "Format: " . $formatName . PHP_EOL;
echo "Title: " . java_values($documentProperties->getTitle()) . PHP_EOL;
echo "Author: " . java_values($documentProperties->getAuthor()) . PHP_EOL;
echo "Statistics:" . PHP_EOL;
echo "  Slides: " . java_values($documentProperties->getSlides()) . PHP_EOL;
echo "  Hidden slides: " . java_values($documentProperties->getHiddenSlides()) . PHP_EOL;
echo "  Slides with notes: " . java_values($documentProperties->getNotes()) . PHP_EOL;
echo "  Paragraphs: " . java_values($documentProperties->getParagraphs()) . PHP_EOL;
echo "  Words: " . java_values($documentProperties->getWords()) . PHP_EOL;
echo "  Multimedia clips: " . java_values($documentProperties->getMultimediaClips()) . PHP_EOL;

$headingPairs = $documentProperties->getHeadingPairs();
$titlesOfParts = $documentProperties->getTitlesOfParts();

if (java_is_null($headingPairs) || java_is_null($titlesOfParts)) {
    echo "Content groups: not available" . PHP_EOL;
} else {
    $headingPairs = java_values($headingPairs);
    $titlesOfParts = java_values($titlesOfParts);
    $partIndex = 0;

    if (count($headingPairs) === 0 || count($titlesOfParts) === 0) {
        echo "Content groups: not available" . PHP_EOL;
    } else {
        echo "Content groups:" . PHP_EOL;

        foreach ($headingPairs as $headingPair) {
            $partCount = java_values($headingPair->getCount());
            echo "  " . java_values($headingPair->getName()) . " (" . $partCount . ")" . PHP_EOL;

            for ($partOffset = 0; $partOffset < $partCount && $partIndex < count($titlesOfParts); $partOffset++) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }

        if ($partIndex < count($titlesOfParts)) {
            echo "  Other parts:" . PHP_EOL;

            while ($partIndex < count($titlesOfParts)) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }
    }
}

Mỗi HeadingPair cung cấp một tên nhóm và số mục trong nhóm đó. DocumentProperties::getTitlesOfParts trả về một mảng phẳng, có thứ tự, vì vậy hãy tiêu thụ số tiêu đề liên tiếp được chỉ định bởi mỗi heading pair.

Siêu dữ liệu đã lưu và các hạn chế định dạng

Các thuộc tính kiểm kê được trả về bởi PresentationInfo::readDocumentProperties phản ánh siêu dữ liệu có trong tài liệu nguồn. Aspose.Slides không tải và duyệt mô hình đối tượng bản trình bày để tính lại các giá trị này cho lời gọi này. Các thuộc tính thiếu sẽ được biểu diễn bằng các giá trị mặc định, và các giá trị đã lưu có thể lỗi thời nếu ứng dụng lưu tệp lần cuối không cập nhật các thuộc tính tài liệu.

PPTX: Định dạng cung cấp các thuộc tính tài liệu mở rộng cho số slide, ghi chú, slide ẩn, đoạn văn, từ và đa phương tiện, cũng như các heading pair và tiêu đề phần. Tính khả dụng phụ thuộc vào các thuộc tính mà nhà sản xuất tài liệu đã ghi.
PPT: Định dạng nhị phân có thể lưu các thuộc tính tóm tắt tài liệu tương ứng. Nếu một thuộc tính không tồn tại hoặc không được nhà sản xuất tài liệu làm mới, Aspose.Slides sẽ trả về giá trị đã lưu hoặc giá trị mặc định thay vì tính toán lại từ các slide.
ODP: Siêu dữ liệu OpenDocument cung cấp các thống kê chung của tài liệu, chẳng hạn số trang, đoạn văn và từ, nhưng các giá trị này không khớp với mọi thuộc tính mở rộng riêng của PowerPoint. Siêu dữ liệu slide ẩn, slide ghi chú, đa phương tiện, heading‑pair và part‑title có thể không có, và các thuộc tính kiểm kê có thể trả về giá trị mặc định. Đừng coi giá trị 0 hoặc mảng rỗng là bằng chứng chắc chắn rằng nội dung tương ứng không tồn tại.

Sử dụng cách tiếp cận siêu dữ liệu nhẹ cho các danh mục và kiểm tra sơ bộ. Tải bản trình bày và duyệt mô hình đối tượng sống khi kết quả phải phản ánh các thay đổi trong bộ nhớ hoặc khi bạn cần xác minh nội dung thực tế của bản trình bày.

Cập nhật thuộc tính bản trình bày

Các thuộc tính được trả về bởi PresentationInfo::readDocumentProperties cũng có thể được thay đổi mà không tạo một thể hiện Presentation nào. Áp dụng các thay đổi bằng PresentationInfo::updateDocumentProperties, sau đó ghi bản trình bày đã liên kết bằng PresentationInfo::writeBindedPresentation.

Hình ảnh dưới đây cho thấy các thuộc tính tài liệu gốc.

Original document properties of the PowerPoint presentation

Ví dụ dưới đây thay đổi tiêu đề và thời gian lưu lần cuối, sau đó ghi kết quả vào một tệp mới:

use aspose\slides\PresentationFactory;

$sourceFile = "sample.pptx";
$outputFile = "sample_with_updated_properties.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($sourceFile);
$documentProperties = $presentationInfo->readDocumentProperties();

$documentProperties->setTitle("Quarterly sales report");
$documentProperties->setLastSavedTime(new Java("java.util.Date"));

$presentationInfo->updateDocumentProperties($documentProperties);
$outputStream = new Java("java.io.FileOutputStream", $outputFile);
try {
    $presentationInfo->writeBindedPresentation($outputStream);
} finally {
    $outputStream->close();
}

Hình ảnh sau đây cho thấy các thuộc tính tài liệu đã được cập nhật.

Changed document properties of the PowerPoint presentation

Liên kết hữu ích

Đối với các kiểm tra bảo mật và cài đặt bảo vệ liên quan, hãy xem các bài viết sau:

Câu hỏi thường gặp

Làm sao tôi có thể kiểm tra xem phông chữ có được nhúng hay không và chúng là những phông nào?

Tải bản trình bày và sử dụng Presentation::getFontsManager. Gọi FontsManager::getEmbeddedFonts để lấy các phông chữ đã nhúng và FontsManager::getFonts để lấy các phông chữ được bản trình bày sử dụng. So sánh hai kết quả để tìm các phông chữ cần thiết cho việc hiển thị nhưng chưa được nhúng.

Làm sao tôi có thể nhanh chóng biết tệp có slide ẩn và có bao nhiêu?

Khi siêu dữ liệu tài liệu đã lưu đủ, đọc DocumentProperties::getHiddenSlides thông qua PresentationFactory::getPresentationInfo và PresentationInfo::readDocumentProperties. Cách này phù hợp cho một danh mục nhẹ. Nếu bản trình bày đã được sửa đổi trong bộ nhớ, siêu dữ liệu lưu có thể thiếu hoặc lỗi thời, hoặc bạn cần xác minh các giá trị sống, hãy duyệt Presentation::getSlides và kiểm tra phương thức Slide::getHidden của từng slide.

Tôi có thể phát hiện liệu kích thước và hướng slide tùy chỉnh có được sử dụng và chúng có khác so với mặc định không?

Có. Tải bản trình bày và gọi Presentation::getSlideSize. Sử dụng SlideSize::getType, SlideSize::getSize và SlideSize::getOrientation để so sánh các cài đặt hiện tại với các thiết lập và kích thước mặc định.

Có cách nhanh để xem biểu đồ có tham chiếu đến nguồn dữ liệu bên ngoài không?

Có. Xác định mỗi Chart và gọi ChartData::getDataSourceType. Đối với một workbook bên ngoài, gọi ChartData::getExternalWorkbookPath. Kiểu nguồn dữ liệu và đường dẫn sẽ chỉ ra sự tham chiếu bên ngoài, nhưng việc xác minh nguồn có tồn tại hay không cần một kiểm tra tài nguyên riêng.

Làm sao tôi đánh giá các slide ‘nặng’ có thể làm chậm việc render hoặc xuất PDF?

Không có một thuộc tính phức tạp duy nhất. Duyệt Presentation::getSlides và bộ sưu tập BaseSlide::getShapes của mỗi slide. Sử dụng số lượng hình dạng và sự hiện diện của ảnh lớn, hiệu ứng, hoạt ảnh hoặc đa phương tiện như các dấu hiệu sàng lọc, và đo một lần render hoặc xuất mẫu trước khi xem slide là nút thắt hiệu năng đã được xác nhận.

Mở bản trình chiếu trong PHP Xác định Định dạng Bản trình chiếu Gốc trong PHP