PHP Reporting Library For MYSQL

محرك التقارير الذكي - إصدار المجتمع

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

ابدء

1- لديك خيار إما استنساخ إصدار المجتمع من Smart Report Engine أو تنزيله مباشرة من صفحة التنزيل هذه

2- بعد التنزيل قم باستخراج المجلد المضغوط للكشف عن بنية SmartReportEngine. سوف يشبه المحتوى شيئًا مشابهًا لما يلي:

├── SmartReportingEngine/
├── sre_config/
   └── config.php
├── sre_reports/
├── db/
  └── example.sql
├── examples/
└── sre_bootstrap.php

3- لبدء مشروعك الأول على الخادم الخاص بك، تحتاج إلى استيراد نموذج لقاعدة بيانات MySQL. ستمكنك هذه العملية من بدء استخدام Smart Report Engine بسلاسة.

• داخل الحزمة التي تم تنزيلها من Smart Report Engine، حدد موقع الملف "/db/example.sql" في الدليل "db". يحتوي ملف SQL هذا على الأوامر اللازمة لإنشاء وتعبئة جدول MySQL واحد يسمى "العناصر"
• حدد قاعدة بيانات MySQL لإعداد مشروعك الأول. يمكنك اختيار قاعدة بيانات موجودة أو إنشاء قاعدة جديدة خصيصًا لهذا المشروع.
• قم باستيراد الملف "example.sql" إلى قاعدة بيانات MySQL التي اخترتها. سيؤدي هذا إلى إنشاء جدول "العناصر" وملؤه بالبيانات الأولية.

4- تكوين سلسلة اتصال قاعدة البيانات

• انتقل إلى الدليل "sre_config" ضمن حزمة Smart Report Engine Community Edition. ستجد هناك ملف "config.php". يرجى فتح هذا الملف باستخدام أي محرر نصوص تفضله.
• ستجد في ملف "config.php" قسمًا مخصصًا لتكوين قاعدة البيانات. قم بتحديث سلسلة الاتصال بالتفاصيل المناسبة لقاعدة بيانات MySQL حيث قمت باستيراد ملف SQL النموذجي أثناء الخطوة الثالثة. تأكد من تقديم اسم المضيف الصحيح واسم قاعدة البيانات واسم المستخدم وكلمة المرور في الحقول المخصصة لذلك.

5- احفظ التغييرات في ملف "config.php".

6- في دليل "/الأمثلة" الخاص بإصدار المجتمع، ستجد ثلاثة أمثلة مفيدة لتبدأ باستخدام Smart Report Engine. لتنفيذ أي من هذه الأمثلة، ما عليك سوى الوصول إلى عناوين URL الخاصة بها من متصفح الويب الخاص بك. سيمكنك هذا من عرض التقرير الذي تم إنشاؤه بناءً على الكود الموجود في كل مثال.

7- إذا كنت تفضل إنشاء المشاريع النموذجية من الصفر، فيرجى متابعة الخطوة 8 في عملية التثبيت.

ملاحظة: بغض النظر عن اختيارك، ستوفر أقسام التعليمات البرمجية شرحًا للتعليمات البرمجية في كل مثال.

8- للبدء في كتابة مشروعك الأول، ستحتاج إلى برنامج PHP نصي جديد. لغرض هذا البرنامج التعليمي، يمكنك إضافة البرنامج النصي إلى الدليل الجذر لإصدار المجتمع، إلى جانب الملف "sre_bootstrap.php". إذا قمت بتنزيل إصدار المجتمع يدويًا (دون استخدام Composer)، فستحتاج إلى طلب ملف التحميل التلقائي "sre_bootstrap.php" في التعليمات البرمجية الخاصة بك، كما هو موضح في المثال أدناه. في حالة وضع الكود الخاص بك في مواقع مختلفة لمشاريع أخرى، تأكد من ضبط المسار إلى ملف التحميل التلقائي هذا وفقًا لذلك. يرجى اتباع الخطوات التالية للبدء بمشروعك:

• قم بإنشاء برنامج نصي PHP جديد لمشروعك.
• اختياريًا، ضع البرنامج النصي في الدليل الجذر لإصدار المجتمع (نفس مستوى "sre_bootstrap.php") لغرض هذا البرنامج التعليمي.
• في مشروعك الجديد الأول، حاول كتابة كود PHP البسيط التالي. يجب أن تعمل دون أي مشاكل.

use SRE E ngine C ustomEngine ;
use SRE E ngine R eportOptions ;

require_once " sre_bootstrap.php " ;

try {

   $report = new ReportOptions ();
   $report - > select_tables( " items " )
           - > set_grouping( " country " )
           - > set_title( " Items Per country " )
           ->select_all_fields ();
   $engine = new CustomEngine( $report ) ;
   $report_path = $engine->create_report ();
   if ( $report_path ) {
      // The user will be redirected to the URL of the generated report. All generated reports are stored as subdirectories under /sre_reports.
      header( " location: " . $report_path ) ;
      exit ();
   }
} catch (Exception $e ) {
   echo $e->getMessage ();
}

قم بإنشاء هذا التقرير

إرشادات التعليمات البرمجية: فهم المثال

يوضح الكود المعطى مثالًا أساسيًا لاستخدام Smart Report Engine بشكل فعال. دعنا نتعرف على الكود خطوة بخطوة لفهم كيفية عمله:

• مساحات الأسماء: يستخدم الكود المعطى مساحتي أسماء، "SREEngineCustomEngine" و"SREEngineReportOptions." تساعد مساحات الأسماء هذه في تنظيم أجزاء معينة من التعليمات البرمجية والوصول إليها.
• يتطلب "sre_bootstrap.php": إذا قمت بتنزيل إصدار المجتمع يدويًا (بدون استخدام Composer)، فستحتاج إلى إضافة ملف خاص يسمى "sre_bootstrap.php" إلى التعليمات البرمجية الخاصة بك.
• إنشاء كائن ReportOptions: يقوم الكود بتهيئة كائن من فئة "ReportOptions". هذا الكائن مسؤول عن تحديد الخيارات المطلوبة لتقريرك. يمكنك تخصيص خيارات متعددة، مع الأخذ في الاعتبار أن بعض الميزات حصرية للإصدار التجاري.
• تمرير كائن ReportOptions إلى CustomEngine: بمجرد تعيين خيارات التقرير، يمكنك تمرير كائن "ReportOptions" إلى مُنشئ فئة "CustomEngine". يعالج هذا الفصل إنشاء تقريرك بناءً على الخيارات المتوفرة.
• استدعاء وظيفة CreateReport: لإنشاء التقرير الخاص بك، يمكنك استدعاء وظيفة "CreateReport" باستخدام كائن "CustomEngine". تقوم هذه الوظيفة بمعالجة الخيارات المحددة وإنشاء التقرير. عند الإنشاء الناجح، يقوم بإرجاع عنوان URL للتقرير. سيتم حفظ جميع التقارير التي تم إنشاؤها باستخدام Smart Report Engine تلقائيًا في دليل "sre_reports".

روابط مهمة

• المزيد من الأمثلة
• مقارنة تفصيلية للتراخيص لمساعدتك على فهم الفروق بين الإصدارات المجتمعية والإصدارات التجارية بشكل أفضل، قدمنا ​​نظرة عامة مختصرة في هذه الصفحة. وهو يسلط الضوء على الاختلافات الرئيسية في الميزات وحالات الاستخدام لكل إصدار.
• استكشاف أخطاء محرك التقارير الذكي وإصلاحها الغرض من هذا القسم في الوثائق هو توجيه المستخدمين عبر نقاط التحقق الأساسية التي يجب أخذها في الاعتبار عند مواجهة أية مشكلات أثناء عملية إنشاء التقرير باستخدام Smart Report Engine. بالإضافة إلى ذلك، سوف نستكشف ميزة التسجيل الخاصة بـ Smart Report Engine، والتي تساعد في استكشاف المشكلات المحتملة التي قد تنشأ في التقارير التي تم إنشاؤها وإصلاحها.
• وثائق Smart Report Engine في هذا القسم، ستكتشف وثائق وأمثلة شاملة لكل فئة وطريقة وثابت مدمج في Smart Report Engine.
• ما الجديد سيشمل هذا القسم أحدث الميزات المقدمة في Smart Report Engine.
• الصفحة الرئيسية لمحرك التقارير الذكية
• اتصل بنا

ترخيص إصدار المجتمع

يسمح لك إصدار المجتمع بما يلي:

• قم بتجربة محرك التقارير الذكي (الميزات غير المميزة فقط).
• استخدم Smart Report Engine بحرية للاستخدام الشخصي.
• قم بدمج Smart Report Engine بحرية في المشاريع المجانية مفتوحة المصدر طالما أنك تحتفظ بمطالبات حقوق الطبع والنشر الخاصة بنا.

يقيدك إصدار المجتمع مما يلي:

• الوصول إلى الميزات المميزة.
• دمج محرك التقارير الذكي في المشاريع التجارية أو SaaS.
• إزالة المطالبة "بدعم من" من التقارير التي تم إنشاؤها بواسطة إصدار المجتمع من Smart Report Maker.

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

محرك التقارير الذكية برو

يعد Smart Report Engine Pro إصدارًا متقدمًا من Smart Report Engine، مما يتيح الوصول إلى جميع ميزاته المتميزة. بسعر 64 دولارًا فقط لترخيص الفريق، يوفر الإصدار الاحترافي العديد من المزايا، بما في ذلك:

• الوصول الكامل إلى جميع الميزات المميزة.
• يمكن استخدامها في SaaS والمشاريع التجارية.
• التكامل السهل مع أي نظام تسجيل دخول قائم على الجلسة.
• عدم وجود إسناد "مدعوم من" في تذييل التقارير التي تم إنشاؤها.
• سنة مجانية من الترقيات المجانية.
• خصم 70% على رسوم الترقية المستقبلية (بعد فترة الترقية المجانية).
• أولوية دعم العملاء.
• إمكانية نشر Smart Report Engine على عدد غير محدود من الخوادم أو المشاريع.
• يسمح ترخيص الفريق بالاستخدام بواسطة ما يصل إلى 7 مطورين، بينما يسمح ترخيص Enterprise بعدد غير محدود من المطورين داخل المؤسسة.
• مجانًا (بدون رسوم إضافية) عند تسليم Smart Report Engine مع منتجك التجاري.

مؤلف

Webuccino خلق منتجات سهلة الاستخدام منذ عام 2007