تحديد تنسيق العرض التقديمي الأصلي في PHP

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

قراءة تنسيق العرض التقديمي الأصلي للعرض الذي تم تحميله في PHP باستخدام Aspose.Slides for PHP عبر Java، مقارنة واجهات برمجة التطبيقات للكشف، والتعامل مع الملفات، التدفقات، والصيغ القديمة.

نظرة عامة

بعد تحميل عرض تقديمي، استدعِ الطريقة Presentation::getSourceFormat لتحديد تنسيقه الأصلي. استخدمها عندما يعتمد المعالجة اللاحقة على التنسيق الذي تمّ تحميل المثيل الحالي منه.

تنسيق المصدر مختلف عن SaveFormat المحدد لملف الإخراج. حفظ الملف بتنسيق آخر لا يغيّر تنسيق المصدر للمثيل الحالي.

قراءة تنسيق المصدر لملف

هذا المثال يتطلّب ملف sample.pptx موجود. يقوم بتحميل الملف ويختار سياسة معالجة التطبيق باستخدام Presentation::getSourceFormat ، بدلاً من اسم الملف. غيّر مسار الإدخال لتجربة تنسيقات أخرى. يطبع المثال السياسة المختارة؛ استبدل الرسائل بمنطق تطبيقك.

use aspose\slides\Presentation;
use aspose\slides\SourceFormat;

$presentation = new Presentation("sample.pptx");
try {
    switch (java_values($presentation->getSourceFormat())) {
        case SourceFormat::Ppt:
        case SourceFormat::Pps:
        case SourceFormat::Pot:
            echo "Use the legacy PowerPoint processing policy." . PHP_EOL;
            break;
        case SourceFormat::Pptx:
            echo "Use the standard PPTX processing policy." . PHP_EOL;
            break;
        default:
            echo "Use the general policy for source format " . java_values($presentation->getSourceFormat()) . "." . PHP_EOL;
            break;
    }
} finally {
    $presentation->dispose();
}

التعرف على القيم المدعومة

الفئة SourceFormat تُعرّف ثوابت عددية تُميّز صيغ العروض التقديمية التالية. الامتدادات أدناه هي امتدادات تقليدية، ليست إعادة بناء لاسم الملف الأصلي.

قيمة SourceFormat	الامتداد	الصيغة
`Ppt`	`.ppt`	عرض PowerPoint 97–2003
`Pptx`	`.pptx`	عرض Office Open XML
`Pptm`	`.pptm`	عرض Office Open XML مع ماكرو
`Pps`	`.pps`	عرض شريحة PowerPoint 97–2003
`Ppsx`	`.ppsx`	عرض شريحة Office Open XML
`Ppsm`	`.ppsm`	عرض شريحة Office Open XML مع ماكرو
`Pot`	`.pot`	قالب PowerPoint 97–2003
`Potx`	`.potx`	قالب Office Open XML
`Potm`	`.potm`	قالب Office Open XML مع ماكرو
`Odp`	`.odp`	عرض OpenDocument
`Otp`	`.otp`	قالب OpenDocument
`Fodp`	`.fodp`	عرض Flat XML ODF
`Xml`	`.xml`	عرض PowerPoint XML

قراءة تنسيق المصدر لتدفق بيانات

هذا المثال يتطلّب ملف sample.pps موجود. قراءة بايتاته إلى تدفق ذاكرة يُحاكي إدخالاً يُستقبل بدون اسم ملف، مثل قيمة قاعدة بيانات أو مصفوفة بايتات تم تحميلها. يتلقى المُنشئ Presentation التدفق فقط.

use aspose\slides\Presentation;

$inputFile = new Java("java.io.File", "sample.pps");
$bytes = java("java.nio.file.Files")->readAllBytes($inputFile->toPath());
$stream = new Java("java.io.ByteArrayInputStream", $bytes);
try {
    $presentation = new Presentation($stream);
    try {
        echo "Source format: " . java_values($presentation->getSourceFormat()) . PHP_EOL;
    } finally {
        $presentation->dispose();
    }
} finally {
    $stream->close();
}

تستخدم الصيغ PPT و PPS و POT نفس بنية البايناري الأساسية. عند التحميل عبر مسار الملف، يمكن للامتداد أن يساعد في تمييز عرض شريحة أو قالب. بدون اسم ملف، قد يتم الإبلاغ عن محتوى PPS و POT القديم كـ SourceFormat::Ppt؛ المثال السابق للـ PPS يطبع القيمة العددية لـ SourceFormat::Ppt.

إذا كان تطبيقك يحتاج إلى الحفاظ على هذا التمييز، احتفظ باسم الملف الأصلي أو بيانات التعريف الفرعية بشكل منفصل. الامتداد يُعدّ تلميحًا مفيدًا لهذه الأنواع القديمة، لكنه لا ينبغي أن يكون الأساس الوحيد لتحديد محتوى عرض تقديمي عشوائي.

مقارنة الكشف قبل وبعد التحميل

استخدم PresentationFactory::getPresentationInfo و PresentationInfo::getLoadFormat عندما تحتاج إلى فحص ملف قبل تحميل نموذج كائن العرض الكامل. استخدم Presentation::getSourceFormat عندما تكون المثيلة موجودة بالفعل.

هذا المثال يتطلّب sample.pptx ويطبع القيم العددية لـ LoadFormat::Pptx و SourceFormat::Pptx على التوالي. في بيئة الإنتاج، اختر الـ API المناسب لمرحلة المعالجة؛ العرض الذي تم تحميله بالفعل لا يحتاج إلى فحص ثانٍ فقط للحصول على تنسيق المصدر.

use aspose\slides\Presentation;
use aspose\slides\PresentationFactory;

$path = "sample.pptx";
$information = PresentationFactory::getInstance()->getPresentationInfo($path);
echo "Before loading: " . java_values($information->getLoadFormat()) . PHP_EOL;

$presentation = new Presentation($path);
try {
    echo "After loading: " . java_values($presentation->getSourceFormat()) . PHP_EOL;
} finally {
    $presentation->dispose();
}

النتائج تستخدم ثوابت من فئات مختلفة: LoadFormat و SourceFormat. لا تقارن قيمها العددية ولا تفترض أن كل تنسيق له نتائج كشف متطابقة. قد يتم الإبلاغ عن PowerPoint XML كـ LoadFormat::Unknown قبل التحميل و SourceFormat::Xml بعد التحميل.

الحفاظ على تنسيقات المصدر والإخراج منفصلة

هذا المثال يتطلّب sample.pptx ويكتب converted.odp. يطبع القيمة العددية لـ SourceFormat::Pptx قبل وبعد حفظ المثيل الأصلي. فقط المثيل الجديد المُحمّل من إخراج ODP يُبلغ عن Odp.

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

$presentation = new Presentation("sample.pptx");
try {
    echo "Before saving: " . java_values($presentation->getSourceFormat()) . PHP_EOL;

    $presentation->save("converted.odp", SaveFormat::Odp);
    echo "After saving: " . java_values($presentation->getSourceFormat()) . PHP_EOL;

    $reopened = new Presentation("converted.odp");
    try {
        echo "Reopened output: " . java_values($reopened->getSourceFormat()) . PHP_EOL;
    } finally {
        $reopened->dispose();
    }
} finally {
    $presentation->dispose();
}

العرض الذي يُنشأ من الصفر باستخدام new Presentation() يُبلغ عن SourceFormat::Pptx. لا يوجد ملف إدخال: هذه هي القيمة الافتراضية لمثيل تم إنشاؤه حديثًا، وليست دليلًا على تحميل ملف PPTX. تتبع ما إذا كان تطبيقك قد أنشأ المثيلة أو حمّلها بشكل منفصل إذا كان هذا التمييز مهمًا.

تحويل تنسيق المصدر إلى امتداد

المثال التالي يتطلّب sample.pptx. يرمّز كل قيمة من قيم SourceFormat المدعومة حاليًا إلى امتداد تقليدي، دون تحليل اسم الملف المدخل. يضمن fallback عدم تعيين امتداد بصمت لقيمة غير معروفة.

use aspose\slides\Presentation;
use aspose\slides\SourceFormat;

$presentation = new Presentation("sample.pptx");
try {
    $extension = null;
    switch (java_values($presentation->getSourceFormat())) {
        case SourceFormat::Ppt:
            $extension = ".ppt";
            break;
        case SourceFormat::Pptx:
            $extension = ".pptx";
            break;
        case SourceFormat::Pptm:
            $extension = ".pptm";
            break;
        case SourceFormat::Pps:
            $extension = ".pps";
            break;
        case SourceFormat::Ppsx:
            $extension = ".ppsx";
            break;
        case SourceFormat::Ppsm:
            $extension = ".ppsm";
            break;
        case SourceFormat::Pot:
            $extension = ".pot";
            break;
        case SourceFormat::Potx:
            $extension = ".potx";
            break;
        case SourceFormat::Potm:
            $extension = ".potm";
            break;
        case SourceFormat::Odp:
            $extension = ".odp";
            break;
        case SourceFormat::Otp:
            $extension = ".otp";
            break;
        case SourceFormat::Fodp:
            $extension = ".fodp";
            break;
        case SourceFormat::Xml:
            $extension = ".xml";
            break;
        default:
            $extension = null;
            break;
    }

    echo ($extension !== null ? $extension : "No extension mapping is available.") . PHP_EOL;
} finally {
    $presentation->dispose();
}

هذا التحويل لا يُحوّل ملفًا أو يستعيد نوع PPS/POT القديم الفاقد أثناء تحميل التدفق. للحفظ الفعلي، حدّد SaveFormat صراحة، أو استخدم التحويل الموضح في Save Presentations in Their Original Format.

التحقق من الصيغ عبر الحفظ وإعادة الفتح

هذا المثال المستقل يُنشئ عرضًا ويكتب ثلاثة ملفات في دليل العمل، مع استبدال الملفات ذات الأسماء نفسها. يعيد فتح كل مخرج إما عبر المسار أو من خلال تدفق ذاكرة. بالنسبة إلى PPTX و ODP، كلا المسارين يُبلغان عن الصيغة المحفوظة. بالنسبة إلى PPS، يُبلغ التحميل عبر المسار عن Pps، بينما يُبلغ تحميل نفس البايتات بدون اسم ملف عن Ppt.

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

$presentation = new Presentation();
try {
    $formats = [SaveFormat::Pptx, SaveFormat::Odp, SaveFormat::Pps];
    $extensions = ["pptx", "odp", "pps"];

    foreach ($formats as $index => $format) {
        $path = "roundtrip." . $extensions[$index];
        $presentation->save($path, $format);

        $fromFile = new Presentation($path);
        try {
            $inputFile = new Java("java.io.File", $path);
            $bytes = java("java.nio.file.Files")->readAllBytes($inputFile->toPath());
            $stream = new Java("java.io.ByteArrayInputStream", $bytes);
            try {
                $fromStream = new Presentation($stream);
                try {
                    echo $extensions[$index] . ": file=" . java_values($fromFile->getSourceFormat()) . ", stream=" . java_values($fromStream->getSourceFormat()) . PHP_EOL;
                } finally {
                    $fromStream->dispose();
                }
            } finally {
                $stream->close();
            }
        } finally {
            $fromFile->dispose();
        }
    }
} finally {
    $presentation->dispose();
}

الجدول التالي يلخّص التعرف على تنسيق المصدر للعرض وفقًا للامتدادات المطابقة. الأسماء تمثل ثوابت؛ الأمثلة بلغة PHP تطبع القيم العددية لها:

الصيغة المحفوظة	SourceFormat من مسار ملف	SourceFormat من تدفق بلا اسم
PPT	`Ppt`	`Ppt`
PPTX, PPTM	`Pptx`, `Pptm` على التوالي	نفس قيمة مسار الملف
PPS	`Pps`	`Ppt`
PPSX, PPSM	`Ppsx`, `Ppsm` على التوالي	نفس قيمة مسار الملف
POT	`Pot`	`Ppt`
POTX, POTM	`Potx`, `Potm` على التوالي	نفس قيمة مسار الملف
ODP, OTP	`Odp`, `Otp` على التوالي	نفس قيمة مسار الملف
FODP	`Fodp`	`Fodp`
PowerPoint XML	`Xml`	`Xml`

محتوى PPS/POT يُعرَّف كـ Ppt في التدفقات بلا اسم. يصف الجدول طريقة التعرف على الصيغة، وليس الحفاظ على جميع ميزات العرض أثناء التحويل.

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

هل يُغيّر حفظ العرض إلى ODP تنسيق المصدر لعرض تم تحميله من PPTX؟

لا. المثيل الحالي لا يزال يُبلغ عن Pptx. المثيل المحمّل من ملف ODP المحفوظ يُبلغ عن Odp.

هل يمكن للتدفق دائمًا تمييز عرض تقديمي قديم، عرض شريحة، أو قالب؟

لا. الصيغ PPT و PPS و POT تشترك في بنية البايناري. احتفظ باسم الملف أو بيانات التعريف الفرعية بشكل منفصل عندما يكون هذا التمييز مطلوبًا.

أي API يجب أن أستخدمه إذا كان العرض مُحمَّلاً بالفعل؟

اقرأ Presentation::getSourceFormat. استخدم PresentationFactory::getPresentationInfo للفحص قبل التحميل.

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