استرجاع وتحديث معلومات العرض التقديمي في PHP

عن ماذا تتحدث هذه الصفحة

استكشف الشرائح والبنية والبيانات الوصفية في عروض PowerPoint وOpenDocument باستخدام Aspose.Slides للـ PHP للحصول على رؤى أسرع وتدقيق محتوى أكثر ذكاءً.

نظرة عامة

يمكن لـ Aspose.Slides التعرف على تنسيق العرض التقديمي وقراءة البيانات الوصفية للمستند دون إنشاء نموذج كائن عرض تقديمي كامل. يكون هذا مفيدًا عندما تحتاج إلى تصنيف الملفات، بناء جرد، أو فحص الخصائص قبل اتخاذ قرار بتحميل ومعالجة محتوى العرض التقديمي.

توضح هذه المقالة عملية فحص خفيفة الوزن باستخدام PresentationFactory وPresentationInfo، بالإضافة إلى تحديثات مستهدفة عبر DocumentProperties.

التحقق من تنسيق العرض التقديمي

استخدم PresentationFactory::getPresentationInfo لفحص ملف دون إنشاء كائن Presentation. تُظهر طريقة PresentationInfo::getLoadFormat التنسيق المكتشف، مثل PPTX أو PPT أو 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;
}

إنشاء جرد عرض تقديمي خفيف الوزن

عند معالجة عدد كبير من ملفات العرض التقديمي، قد تحتاج إلى جرد مدمج للتحقق أو الفهرسة أو نظام إدارة المستندات. في هذا السيناريو، استخدم PresentationFactory::getPresentationInfo للحصول على كائن PresentationInfo، ثم استدعِ PresentationInfo::readDocumentProperties لقراءة البيانات الوصفية للمستند. لا ينشئ هذا النهج كائن Presentation ولا يتطلب تجوالًا عبر نموذج كائن العرض الكامل.

القيم الإضافية التي تُظهرها DocumentProperties للجرد هي:

الطريقة	قيمة الجرد
getSlides	إجمالي عدد الشرائح.
getHiddenSlides	عدد الشرائح المخفية.
getNotes	عدد الشرائح التي تحتوي على ملاحظات.
getParagraphs	إجمالي عدد الفقرات، إن توفرت.
getWords	إجمالي عدد الكلمات.
getMultimediaClips	إجمالي عدد مقاطع الصوت والفيديو.

المثال التالي يقرأ هذه القيم دون إنشاء كائن Presentation ويطبع جردًا مدمجًا. كما يجمع بين DocumentProperties::getHeadingPairs وDocumentProperties::getTitlesOfParts لعرض مجموعات المحتوى مثل الخطوط والسمات وعناوين الشرائح.

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++;
            }
        }
    }
}

كل كائن HeadingPair يوفّر اسم مجموعة وعدد العناصر في تلك المجموعة. تُعيد طريقة DocumentProperties::getTitlesOfParts مصفوفة مسطّحة ومُرتّبة، لذا يُست‑هلك عدد العناوين المتتالية المحدد بواسطة كل زوج عنوان.

البيانات الوصفية المخزنة والقيود المتعلقة بالتنسيق

القيم التي تُرجعها طريقة PresentationInfo::readDocumentProperties تعكس البيانات الوصفية المتوفرة في المستند المصدر. لا يقوم Aspose.Slides بتحميل وتجوال نموذج كائن العرض لإعادة حساب هذه القيم لهذا الاستدعاء. تُقَدَّم الخصائص المفقودة بقيم افتراضية، وقد تكون القيم المخزنة قديمة إذا لم تُحدِّث تطبيق الحفظ الأخير خصائص المستند.

PPTX: يوفر التنسيق خصائص مستند موسعة لعدد الشرائح، الملاحظات، الشرائح المخفية، الفقرات، الكلمات، والوسائط المتعددة، بالإضافة إلى أزواج العناوين وعناوين الأجزاء. تعتمد التوافرية على الخصائص التي كتبها مُنتج المستند.
PPT: يمكن للتنسيق الثنائي تخزين خصائص ملخص المستند المقابلة. إذا كانت الخاصية غير موجودة أو لم تُحدَّث من قبل مُنتج المستند، تُعيد Aspose.Slides القيمة المخزنة أو الافتراضية بدلاً من حسابها من الشرائح.
ODP: توفر بيانات OpenDocument إحصائيات عامة للمستند، مثل عدد الصفحات والفقرات والكلمات، لكن هذه القيم لا تتطابق مع كل خاصية موسعة خاصة بـ PowerPoint. قد تكون بيانات الشرائح المخفية، ملاحظات الشرائح، الوسائط المتعددة، أزواج العناوين، وعناوين الأجزاء غير متاحة، وقد تُعيد خصائص الجرد قيمًا افتراضية. لا تُعَدَّ الصفر أو المصفوفة الفارغة دليلًا قاطعًا على عدم وجود المحتوى المقابل.

استخدم نهج البيانات الوصفية الخفيفة للجرد والفحوص الأولية. حمّل العرض التقديمي وتفقد نموذج كائنه الحي عندما يجب أن يعكس النتيجة تغييرات الذاكرة أو عندما تحتاج إلى التحقق من المحتوى الفعلي للعرض.

تحديث خصائص العرض التقديمي

يمكن أيضًا تعديل الخصائص التي تُرجعها طريقة PresentationInfo::readDocumentProperties دون إنشاء كائن Presentation . طبّق التغييرات باستخدام PresentationInfo::updateDocumentProperties، ثم اكتب العرض المرتبط باستخدام PresentationInfo::writeBindedPresentation.

الصورة التالية تُظهر خصائص المستند الأصلية.

Original document properties of the PowerPoint presentation

المثال التالي يُغيّر العنوان ووقت الحفظ الأخير ويكتب النتيجة إلى ملف جديد:

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();
}

الصورة التالية تُظهر خصائص المستند المحدثة.

Changed document properties of the PowerPoint presentation

روابط مفيدة

للفحوص الأمنية ذات الصلة وإعدادات الحماية، راجع المقالات التالية:

الأسئلة المتكررة

كيف يمكنني التحقق مما إذا كانت الخطوط مضمنة وما هي الخطوط المُضمَّنة؟

حمّل العرض التقديمي واستخدم Presentation::getFontsManager. استدعِ FontsManager::getEmbeddedFonts للحصول على الخطوط المضمنة وFontsManager::getFonts للحصول على الخطوط المستخدمة في العرض. قارن النتيجتين لتحديد الخطوط المطلوبة للعرض ولكن غير مُضمنة.

كيف يمكنني بسرعة معرفة ما إذا كان الملف يحتوي على شرائح مخفية وعددها؟

عند كفاية البيانات الوصفية المخزنة، اقرأ DocumentProperties::getHiddenSlides عبر PresentationFactory::getPresentationInfo وPresentationInfo::readDocumentProperties. هذا مناسب لجرد خفيف الوزن. إذا تم تعديل العرض في الذاكرة، قد تكون البيانات الوصفية المخزنة مفقودة أو قديمة، أو إذا أردت التحقق من القيم الحية، تنقّـل عبر Presentation::getSlides وتفقد طريقة Slide::getHidden لكل شريحة.

هل يمكنني اكتشاف ما إذا كان تم استخدام حجم وشكل مخصص للشرائح، وما إذا كانت تختلف عن الإعدادات الافتراضية؟

نعم. حمّل العرض التقديمي واستدعِ Presentation::getSlideSize. استخدم SlideSize::getType، SlideSize::getSize، وSlideSize::getOrientation لمقارنة الإعدادات الحالية مع القيم المسبقة المتوقعة والأبعاد.

هل هناك طريقة سريعة لمعرفة ما إذا كانت المخططات تشير إلى مصادر بيانات خارجية؟

نعم. حدد كل كائن Chart واستدعِ ChartData::getDataSourceType. لمصنف خارجي، استدعِ ChartData::getExternalWorkbookPath. يحدد نوع مصدر البيانات والمسار إشارة إلى مرجع خارجي، لكن التحقق من توفر الهدف يتطلب فحصًا منفصلًا للموارد.

كيف يمكنني تقييم “الشرائح الثقيلة” التي قد تبطئ العرض أو تصدير PDF؟

لا توجد خاصية تعقيد واحدة. تجوّل عبر Presentation::getSlides ومجموعات BaseSlide::getShapes لكل شريحة. استخدم عدد الأشكال ووجود صور كبيرة، تأثيرات، رسوم متحركة، أو وسائط متعددة كإشارات فحص، وقم بقياس عملية تصيير أو تصدير ممثلة قبل اعتبار الشريحة عبئًا مؤكدًا على الأداء.

فتح العروض التقديمية في PHP دمج العروض التقديمية بفعالية في PHP