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

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

احفظ عروض PowerPoint و OpenDocument إلى ملفات أو تدفقات في PHP باستخدام Aspose.Slides، وقم بتكوين إخراج PPTX وتقرير التقدم.

نظرة عامة

بعد إنشاء عرض تقديمي أو فتح عرض موجود، استخدم طريقة Presentation::save لكتابة النتيجة. يمكن لـ Aspose.Slides للـ PHP عبر Java حفظ عرض تقديمي إلى ملف أو تدفق بصيغ PowerPoint و OpenDocument و PDF وغيرها. تغطي الأقسام التالية عمليات الحفظ القياسية والخيارات المتاحة لإخراج PPTX.

حفظ العروض التقديمية إلى ملفات

لحفظ عرض تقديمي إلى ملف، مرِّر مسار الإخراج وقيمة SaveFormat إلى طريقة Presentation::save. تحدد قيمة التنسيق نوع الملف الذي تُنشئه Aspose.Slides.

المثال التالي ينشئ عرضاً تقديمياً ويحفظه كملف PPTX:

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

$presentation = new Presentation();
try {
    // أضف أو عدّل محتوى العرض التقديمي هنا.

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

حفظ العروض التقديمية بالتنسيق الأصلي

لأمثلة الكشف عن الملفات والتدفقات، وسلوك العروض التي تم إنشاؤها حديثاً، والتمييز بين تنسيقات المصدر والإخراج، راجع تحديد تنسيق العرض الأصلي.

في تطبيق معالجة دفعات، قد لا يكون تنسيق الإدخال معروفاً مسبقاً. بعد تحميل ملف، اقرأ تنسيقه الأصلي من طريقة Presentation::getSourceFormat. مرِّر القيمة الناتجة من SourceFormat إلى SlideUtil::toSaveFormat للحصول على قيمة SaveFormat المقابلة، ثم استخدم Presentation::save لكتابة العرض المعدل.

المثال الكامل التالي يعالج كل ملف في دليل الإدخال، يحدث عنوانه، ويحفظه في دليل الإخراج بنفس التنسيق الذي تم تحميله منه:

use aspose\slides\Presentation;
use aspose\slides\SlideUtil;

$inputDirectory = __DIR__ . DIRECTORY_SEPARATOR . "Input";
$outputDirectory = __DIR__ . DIRECTORY_SEPARATOR . "Output";

if (!is_dir($outputDirectory) && !mkdir($outputDirectory, 0777, true)) {
    echo("Cannot create the output directory." . PHP_EOL);
}

$inputFiles = is_dir($inputDirectory) ? scandir($inputDirectory) : false;
if ($inputFiles !== false && is_dir($outputDirectory)) {
    foreach ($inputFiles as $fileName) {
        $inputPath = $inputDirectory . DIRECTORY_SEPARATOR . $fileName;
        if (!is_file($inputPath)) {
            continue;
        }

        $presentation = null;
        $presentationLoaded = false;
        try {
            $presentation = new Presentation($inputPath);
            $presentationLoaded = true;
            $saveFormat = SlideUtil::toSaveFormat($presentation->getSourceFormat());
            $presentation->getDocumentProperties()->setTitle("Processed by the batch application");

            $outputPath = $outputDirectory . DIRECTORY_SEPARATOR . $fileName;
            $presentation->save($outputPath, $saveFormat);
        } catch (\Throwable $exception) {
            echo("Cannot process '" . $inputPath . "': " . $exception->getMessage() . PHP_EOL);
        } finally {
            if ($presentationLoaded) {
                $presentation->dispose();
            }
        }
    }
}

SlideUtil::toSaveFormat يطابق صيغ PPT و PPTX و ODP و PPTM و PPSX و PPSM و POTX و POTM و PPS و POT و OTP و FODP و PowerPoint XML مع صيغ حفظ العروض المقابلة. يطابق صيغ المصدر للعرض فقط؛ ولا يُقصد به اختيار صيغ التصدير مثل PDF أو HTML أو TIFF أو الصور. تمرير قيمة SourceFormat غير مدعومة أو غير صالحة يؤدي إلى حدوث IllegalArgumentException.

تستخدم ملفات PPT و PPS و POT القديمة نفس الحاوية الثنائية. عندما يُحمَّل عرض من تدفق دون امتداد ملف، قد يتم التعرف على ملف PPS أو POT على أنه PPT. إذا كان من الضروري الحفاظ على هذه الأنواع الفرعية القديمة، احتفظ باسم الملف الأصلي أو بيانات التعريف الخاصة بالتنسيق بشكل منفصل واستخدمها عند اختيار اسم الملف وإخراجه.

حفظ العروض التقديمية إلى تدفقات

لكتابة عرض تقديمي دون الاعتماد على مسار ملف نهائي، مرِّر تدفقًا قابلاً للكتابة وقيمة SaveFormat إلى طريقة Presentation::save. هذا النهج مفيد عندما يجب إرجاع الإخراج من خدمة ويب، أو تخزينه في قاعدة بيانات، أو معالجته في الذاكرة.

المثال التالي يحفظ عرضًا تقديميًا جديدًا إلى تدفق ملف:

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

$presentation = new Presentation();
try {
    $outputStream = new Java("java.io.FileOutputStream", "Output.pptx");
    try {
        $presentation->save($outputStream, SaveFormat::Pptx);
    } finally {
        $outputStream->close();
    }
} finally {
    $presentation->dispose();
}

حفظ العروض التقديمية بنوع عرض محدد مسبقًا

يمكنك تحديد الطريقة التي يفتح بها PowerPoint العرض المحفوظ عند بدء التشغيل. استخدم طريقة ViewProperties::setLastView مع قيمة ViewType قبل الحفظ.

المثال التالي يكوّن عرض Slide Master كالعرض الأولي:

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

$presentation = new Presentation();
try {
    $presentation->getViewProperties()->setLastView(ViewType::SlideMasterView);
    $presentation->save("SlideMasterView.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

حفظ العروض التقديمية بصيغة Office Open XML الصارمة

لإنشاء ملف PPTX يتوافق مع ملف التعريف الصارم لـ Office Open XML، أنشئ كائنًا من نوع PptxOptions واستخدم طريقة PptxOptions::setConformance مع Conformance::Iso29500_2008_Strict. ثم مرِّر الخيارات إلى طريقة Presentation::save.

use aspose\slides\Conformance;
use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$options = new PptxOptions();
$options->setConformance(Conformance::Iso29500_2008_Strict);

$presentation = new Presentation();
try {
    $presentation->save("StrictOfficeOpenXml.pptx", SaveFormat::Pptx, $options);
} finally {
    $presentation->dispose();
}

حفظ العروض التقديمية بصيغة Office Open XML في وضع Zip64

يحد الأرشيف ZIP القياسي من الحجم المضغوط وغير المضغوط لكل مدخل، وملف الأرشيف الكلي، وعدد المدخلات. لأن ملف PPTX هو أرشيف ZIP، قد يتجاوز عرض كبير جدًا هذه الحدود. امتدادات ZIP64 ترفع حدود الحجم وعدد المدخلات.

استخدم طريقة PptxOptions::setZip64Mode للتحكم فيما إذا كانت Aspose.Slides تكتب امتدادات ZIP64:

IfNecessary يستخدم ZIP64 فقط عندما يتجاوز العرض حدود ZIP القياسية. هذا هو الوضع الافتراضي.
Never يعطل امتدادات ZIP64.
Always يكتب دائمًا امتدادات ZIP64.

المثال التالي يفعّل دائمًا امتدادات ZIP64 للعرض الناتج:

use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\Zip64Mode;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setZip64Mode(Zip64Mode::Always);

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

Warning

إذا تم استخدام Zip64Mode::Never ولا يمكن للعرض أن يندرج ضمن حدود ZIP القياسية، فإن عملية الحفظ تُثير استثناءً من نوع PptxException.

حفظ العروض التقديمية بصيغة Office Open XML مع مستويات الضغط

لإخراج PPTX، يمكنك موازنة سرعة الحفظ مقابل حجم الملف باستخدام طريقة PptxOptions::setCompressionLevel. توفر فئة CompressionLevel هذه القيم:

None يخزن البيانات دون ضغط.
Level1 يوفر أسرع ضغط وأكبر حجم مضغوط للخرج.
Level2 حتى Level5 يفضّلان تدريجيًا حجم خرج أصغر على سرعة الحفظ.
Level6 يوازن بين سرعة الحفظ وحجم الملف. هذا هو المستوى الافتراضي.
Level7 وLevel8 يفضّلان حجم خرج أصغر على سرعة الحفظ.
Level9 يوفر أقوى ضغط ويتطلب أطول وقت معالجة.

المثال التالي يحفظ عرضًا تقديميًا دون ضغط:

use aspose\slides\CompressionLevel;
use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setCompressionLevel(CompressionLevel::None);

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

المثال التالي يستخدم أقصى مستوى ضغط:

use aspose\slides\CompressionLevel;
use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setCompressionLevel(CompressionLevel::Level9);

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

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

عند حفظ عرض كـ PPTX، تتحكم طريقة PptxOptions::setRefreshThumbnail في صورة المستند المصغرة:

true يعيد توليد الصورة المصغرة أثناء عملية الحفظ. هذه هي القيمة الافتراضية.
false يحافظ على الصورة المصغرة الحالية. إذا لم يكن للعرض صورة مصغرة، لا تُنشئ Aspose.Slides صورة جديدة.

المثال التالي يحفظ عرضًا تقديميًا دون تحديث صورته المصغرة:

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

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setRefreshThumbnail(false);

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

Note

تعطيل تحديث الصورة المصغرة يمكن أن يقلل من الوقت المطلوب لحفظ ملف PPTX.

حفظ تحديثات التقدم كنسبة مئوية

لمراقبة عملية الحفظ، قدم وكيل Java يطبق الواجهة IProgressCallback ومرّر الوكيل إلى طريقة SaveOptions::setProgressCallback. ستستدعي Aspose.Slides بعد ذلك طريقة IProgressCallback::reporting مع قيم التقدم أثناء التصدير.

المثال التالي يبلّغ تقدم تصدير PDF إلى وحدة التحكم:

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

class ExportProgressHandler {
    function reporting($progressValue) {
        $progress = java("java.lang.Double")->valueOf($progressValue)->intValue();
        echo($progress . "% of the file has been converted." . PHP_EOL);
    }
}

$progressHandler = java_closure(new ExportProgressHandler(), null, java("com.aspose.slides.IProgressCallback"));

$options = new PdfOptions();
$options->setProgressCallback($progressHandler);

$presentation = new Presentation("Sample.pptx");
try {
    $presentation->save("Output.pdf", SaveFormat::Pdf, $options);
} finally {
    $presentation->dispose();
}

Note

توفر Aspose أداة مجانية تُدعى PowerPoint Splitter مبنية على API الخاص بـ Aspose.Slides. تقوم بحفظ الشرائح المختارة من عرض كملفات PPT أو PPTX منفصلة.

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

هل تدعم Aspose.Slides الحفظ المتدرج أو “الحفظ السريع”?

لا. كل عملية حفظ تكتب ملف إخراج كامل بدلاً من تحديث الأجزاء التي تغيرت فقط.

هل يمكن لعدة خيوط (threads) حفظ نفس كائن Presentation؟

لا. كائن Presentation غير آمن للاستخدام المتعدد الخيوط. يجب الوصول إلى كل كائن وحفظه من خيط واحد فقط في كل مرة.

ماذا يحدث للروابط التشعبية والملفات المرتبطة خارجيًا عند حفظ عرض تقديمي؟

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

هل يمكنني حفظ بيانات تعريف المستند مثل المؤلف، العنوان، الشركة، وتاريخ الإنشاء؟

نعم. اضبط document properties المناسبة قبل الحفظ، وستقوم Aspose.Slides بكتابة هذه الخصائص إلى ملف الإخراج.

تحويل العروض إلى صيغ متعددة في PHP إدارة عرض الشرائح في PHP