مثال على تحويل ODS إلى XLSX في PHP

تحويل جداول بيانات ODS إلى XLSX هو طلب شائع عند دمج مستندات المكتب في تطبيقات الويب، خاصة عندما تقبل الأنظمة اللاحقة فقط صيغ Microsoft Excel. GroupDocs.Conversion Cloud SDK for PHP يوفر واجهة برمجة تطبيقات موثوقة على الخادم تتعامل مع هذا التحويل بدقة عالية. في هذا الدليل ستتعلم كيفية إعداد SDK، تشغيل تحويل كامل، قياس الأداء، وتطبيق أفضل الممارسات للمعالجة السريعة والفعالة في الذاكرة.

خطوات تحويل ODS إلى XLSX في PHP

تثبيت SDK عبر Composer - نفّذ الأمر composer require groupdocs-conversion-cloud لإضافة المكتبة إلى مشروعك.
تكوين بيانات اعتماد API - أنشئ كائن Configuration باستخدام معرف العميل والسر الخاصين بك، ثم أنشئ كائن ConversionApi. راجع مرجع API للحصول على تفاصيل الفئات.
رفع ملف ODS المصدر - استخدم نقطة النهاية UploadFile لتخزين الملف في تخزين سحابة GroupDocs.
إنشاء إعدادات التحويل - اضبط outputFormat إلى XLSX وعدّل أي معلمات اختيارية مثل preserveFormatting.
تنفيذ التحويل - استدعِ convertDocument مع معرف الملف المرفوع وكائن الإعدادات.
تنزيل نتيجة XLSX - استرجع الملف المحول باستخدام نقطة النهاية DownloadFile واحفظه محليًا.

توضح هذه الخطوات سير عمل تحويل ODS إلى XLSX في PHP الأساسي مع الحفاظ على استهلاك الذاكرة منخفضًا ووقت التنفيذ قصيرًا.

عينة PHP ODS إلى XLSX - مثال كامل للكود

يعرض المثال التالي تحويلًا كاملاً من البداية إلى النهاية باستخدام GroupDocs.Conversion Cloud SDK for PHP.

<?php
require 'vendor/autoload.php';

use GroupDocsConversionCloud\Configuration;
use GroupDocsConversionCloud\Api\ConversionApi;
use GroupDocsConversionCloud\Models\ConvertSettings;
use GroupDocsConversionCloud\Models\StorageFile;

// ---------------------------------------------------------------------
// 1. تكوين بيانات اعتماد API (استبدلها بالقيم الخاصة بك)
// ---------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');
$config->setAppKey('YOUR_CLIENT_SECRET');

// ——————————————————————— // 2. Initialize the Conversion API // ——————————————————————— $conversionApi = new ConversionApi($config);


// ---------------------------------------------------------------------
// 3. تحميل ملف ODS إلى تخزين سحابة GroupDocs
// ---------------------------------------------------------------------
$uploadResponse = $conversionApi->uploadFile(
    new StorageFile(['path' => 'sample.ods', 'file' => fopen('sample.ods', 'rb')])
);
$sourcePath = $uploadResponse->getPath();

// ---------------------------------------------------------------------
// 4. تعيين خيارات التحويل (صيغة الإخراج XLSX)
// ---------------------------------------------------------------------
$convertSettings = new ConvertSettings();
$convertSettings->setOutputFormat('XLSX');
$convertSettings->setFilePath($sourcePath);

// ——————————————————————— // 5. تنفيذ التحويل // ——————————————————————— $convertResponse = $conversionApi->convertDocument($convertSettings); $downloadUrl = $convertResponse->getUrl();


// ---------------------------------------------------------------------
// 6. Download the converted XLSX file
// ---------------------------------------------------------------------
$targetFile = fopen('output.xlsx', 'wb');
$ch = curl_init($downloadUrl);
curl_setopt($ch, CURLOPT_FILE, $targetFile);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_exec($ch);
curl_close($ch);
fclose($targetFile);

echo “Conversion completed. File saved as output.xlsx\n”;

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (sample.ods, output.xlsx) لتطابق مواقع ملفاتك الفعلية، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل جداول البيانات السحابي عبر واجهة برمجة التطبيقات REST باستخدام cURL

يمكنك أيضًا إجراء نفس التحويل دون كتابة كود PHP عن طريق استدعاء نقاط النهاية REST مباشرةً.

الحصول على رمز وصول

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

تحميل ملف ODS

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=sample.ods" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.ods"

ابدأ التحويل

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"sample.ods","outputFormat":"XLSX"}'

تنزيل نتيجة XLSX

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

للحصول على قائمة كاملة بنقاط النهاية والمعلمات، راجع الوثائق الرسمية لواجهة برمجة التطبيقات.

التثبيت والإعداد في PHP

تثبيت الحزمة

composer require groupdocs-conversion-cloud

تحميل SDK - أحدث إصدار متاح في صفحة التحميل.
تكوين بيانات الاعتماد - أنشئ كائن Configuration باستخدام client_id و client_secret الخاصين بك.
إعداد التسجيل (اختياري) - يمكن لـ SDK كتابة سجلات الطلبات إلى ملف؛ فعّله في الإعداد إذا كنت بحاجة إلى سجلات تحويل مفصلة.
تطبيق الترخيص - للاستخدام في الإنتاج، اشترِ ترخيصًا وطبّقه كما هو موضح في صفحة الترخيص.

مثال تحويل ODS إلى XLSX في PHP باستخدام GroupDocs.Conversion

GroupDocs.Conversion Cloud تتعامل مع الجزء الثقيل من تحليل ملفات ODS، وربط أنماط cell ، وإنشاء مصنف XLSX متوافق مع المعايير. البنية السحابية تزيل الحاجة إلى تثبيتات Office المحلية وتضمن نتائج متسقة عبر المنصات. يوضح هذا المثال كيف يمكن لاستدعاء API واحد أن يحل محل سير عمل سطح مكتب متعدد الخطوات.

ميزات GroupDocs.Conversion التي تهم هذه المهمة

دعم كامل لـ ODS - يتم الحفاظ على جميع بيانات الخلايا والصيغ والتنسيق.
سرعة تحويل عالية - معالجة الخادم المُحسّنة تُقدّم نتائج بأقل من ثانية للملفات النموذجية.
استهلاك منخفض للذاكرة - الخدمة تُبث البيانات، مما يحافظ على استهلاك الذاكرة أقل من 50 MB حتى للجداول الكبيرة.
تسجيل التحويل - سجلات مفصلة متاحة عبر كائن الاستجابة وتسجيل الخادم الاختياري.
توثيق شامل - يتم توفير مواد مرجعية وعينات كود في التوثيق الرسمي.

تكوين خيارات التحويل من ODS إلى XLSX

يمكنك ضبط التحويل بدقة عن طريق تعديل نموذج ConvertSettings:

$convertSettings = new ConvertSettings();
$convertSettings->setOutputFormat('XLSX');
$convertSettings->setPreserveCellFormatting(true);
$convertSettings->setPassword('optionalPassword'); // if the source ODS is protected

تتيح لك هذه الخيارات التحكم فيما إذا كنت تريد الحفاظ على التنسيق الأصلي، أو تضمين كلمات المرور، أو تحديد التحويل لأوراق معينة.

تحسين سرعة تحويل ODS إلى XLSX واستخدام الذاكرة

فيما يلي اختبار قياسي تم إجراؤه على مثيل t3.medium نموذجي من AWS.

حجم الملف	وقت التحويل	الذاكرة القصوى
0.5 MB	0.42 s	32 MB
1 MB	0.68 s	38 MB
5 MB	1.95 s	45 MB
10 MB	3.80 s	52 MB

نصائح لتحسين الأداء

ضغط ملف ODS المصدر قبل الرفع لتقليل زمن تأخير الشبكة.
إعادة استخدام نفس مثيل ConversionApi لعدة ملفات لتجنب عبء المصادقة المتكرر.
تعطيل الميزات غير الضرورية مثل استخراج الصور عندما لا تكون مطلوبة.

أفضل الممارسات لتحويل ODS إلى XLSX موثوق في PHP

تحقق من صحة ملفات الإدخال - تأكد من أن ملف ODS مُشكل بشكل صحيح قبل إرساله إلى API.
معالجة الأخطاء بلطف - افحص استجابة API لأكواد الأخطاء وسجّل requestId لتسهيل استكشاف الأخطاء.
استخدام البث للملفات الكبيرة - قم بتحميل وتنزيل الملفات كتيارات للحفاظ على استهلاك الذاكرة منخفضًا.
اختبار الحالات الحدية - تحقق من الصيغ والخلايا المدمجة والأنماط المخصصة لتجنب فقدان البيانات.
مراقبة سجلات التحويل - فعّل التسجيل على جانب الخادم لالتقاط مقاييس الأداء وأي تحذيرات تحويل.

الخلاصة

تحويل ODS إلى XLSX في PHP سهل مع GroupDocs.Conversion Cloud SDK for PHP. يقدم SDK معالجة سريعة وفعّالة في الذاكرة، وتسجيل شامل، ووثائق مفصلة تساعدك على بناء تدفقات عمل قوية للجداول. تذكر الحصول على ترخيص مناسب للاستخدام في الإنتاج؛ تفاصيل الأسعار متاحة على صفحة المنتج، ويمكن طلب ترخيص مؤقت من صفحة الترخيص المؤقت. ابدأ بدمج التحويل اليوم وسهّل خطوط أنابيب المستندات الخاصة بك.

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

ما هي سرعة تحويل ODS إلى XLSX النموذجية في PHP؟
بالنسبة للملفات التي يصل حجمها إلى 5 ميغابايت، عادةً ما يكتمل التحويل في أقل من ثانيتين، كما هو موضح في جدول القياس. الملفات الأكبر تتوسع خطيًا، لكن الخدمة السحابية تحافظ على استهلاك منخفض للذاكرة.
كيف يمكنني تسجيل تفاصيل التحويل للمراجعة؟
تُعيد SDK قيمة requestId والطوابع الزمنية في كائن الاستجابة. يمكنك أيضًا تمكين التسجيل على جانب الخادم في إعدادات حسابك لالتقاط حمولات الطلب والاستجابة الكاملة.
أين يمكنني العثور على مرجع API لإعدادات التحويل؟
جميع النماذج، بما في ذلك ConvertSettings، موثقة في مرجع API الرسمي. يوفر المرجع أمثلة لكل خيار قابل للتكوين.
هل هناك طريقة لاختبار SDK دون شراء ترخيص؟
نعم، يمكنك طلب ترخيص مؤقت من صفحة الترخيص المؤقت. هذا يتيح لك تقييم ميزات التحويل قبل الالتزام بخطة مدفوعة.

خطوات تحويل ODS إلى XLSX في PHP#

عينة PHP ODS إلى XLSX - مثال كامل للكود#

تحويل جداول البيانات السحابي عبر واجهة برمجة التطبيقات REST باستخدام cURL#

التثبيت والإعداد في PHP#

مثال تحويل ODS إلى XLSX في PHP باستخدام GroupDocs.Conversion#

ميزات GroupDocs.Conversion التي تهم هذه المهمة#

تكوين خيارات التحويل من ODS إلى XLSX#

تحسين سرعة تحويل ODS إلى XLSX واستخدام الذاكرة#

أفضل الممارسات لتحويل ODS إلى XLSX موثوق في PHP#

الخلاصة#

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

اقرأ المزيد#