ext application

تطبيق تحويلة

مكون أساسي لدمج Sencha Ext JS في تطبيق PHP

مقدمة

توفر هذه المكتبة فكرة مجردة بسيطة حول المتطلبات المختلفة عند تشغيل تطبيقات Sencha Ext JS 6 (على الرغم من أن 5 منها يجب أن تعمل أيضًا) من سياق التطوير والإنتاج باستخدام الصفحات التي أنشأها الخادم. تستخدم عمليات التطوير والإنتاج أشجار مصدر مختلفة لخدمة ملفات التطبيق منها. تعتمد هذه العملية على ما يسمى بالبيان ومحمل جافا سكريبت الصغير. للتأكد من أن هذه العملية تعمل بسلاسة مع الصفحات التي أنشأها الخادم والتوجيه، ترتبط المكتبة بإنشاء البيان وتقوم بتعديل البيان ديناميكيًا بناءً على البيئة والسياق المطلوبين.

تُستخدم هذه المكتبة حاليًا فقط كأساس لحزمة teqneers/ext-application-bundle، وهي حزمة Symfony التي تدمج Ext JS في تطبيق يعتمد على Symfony. لم نحاول استخدام المكتبة كمكون مستقل أو في أي سياق آخر غير بيئة Symfony، لذا فإن ما يلي هو فقط كيفية العمل نظريًا بدون الحزمة. نحن نقدر أي مساعدة ومساهمة لجعل المكتبة أكثر فائدة خارج الحزمة.

تثبيت

يمكنك تثبيت هذه المكتبة باستخدام الملحن

 composer require teqneers/ext-application

أو قم بإضافة الحزمة إلى ملف Composer.json مباشرة.

مثال

بالنظر إلى بنية الدليل التالية لتطبيق وهمي

 ./
|-- src/            Application source code
|-- htdocs/         Public web-facing directory (document root)
|   |-- index.php   PHP front controller
|   |-- app/        Root folder for Ext JS application production build
|-- my-app/         The Ext JS application source folder (sencha generate app -ext MyApp ./my-app)

يجب عليك تكوين التطبيق الخاص بك (على سبيل المثال من ملف Index.php)

 $ config =  TQ  ExtJS  Application  Configuration ApplicationConfiguration (
    __DIR__ . ' /../my-app ' ,     // the absolute path to the Ext JS application workspace
    ' ../my-app ' ,                // the relative path from the public web-facing directory to the Ext JS application workspace
    __DIR__ ,                    // the absolute path to the public web-facing directory
    ' / '                         // the relative path from the  public web-facing directory to the root directory used for production build artifacts (usually /)
);

// add a default build
$ config -> addBuild (
    ' default ' ,          // the build name (just for referencing the build)
    ' / ' ,                // the application path relative to the Ext JS application workspace (usually / unless you have multiple applications and/or packages in a single workspace)
    ' app ' ,              // the application path relative to the root directory used for production build artifacts
    ' manifest.json ' ,    // the build manifest filename for development builds
    ' bootstrap.js ' ,     // the micro-loader filename for development builds
    null ,               // the application cache manifest filename for development builds (usually NULL)
    ' bootstrap.json ' ,   // the build manifest filename for production builds
    ' bootstrap.js ' ,     // the micro-loader filename for production builds
    ' cache.appcache '    // the application cache manifest filename fro production builds
);

$ application = new  TQ  ExtJS  Application  Application (
    $ config ,
    new  TQ  ExtJS  Application  Manifest  ManifestLoader (),
    ' dev ' // dev or prod depending on wether you want to run from development or drom production build
);

$ microLoader = $ application -> getMicroLoaderFile (); // returns a SplFileInfo for the configured micro-loader
$ hasAppCache = $ application -> hasAppCache ();
if ( $ hasAppCache ) {
    $ appCache = $ application -> getAppCacheFile (); // returns a SplFileInfo for the configured application cache manifest
}
$ manifest    = $ application -> getManifest ( ' /htdocs ' ); // returns a TQExtJSApplicationManifestManifest configured correctly when running document root on your application base path

echo $ manifest ; // outputs the manifest

عند تشغيل التطبيق في وضع التطوير، يجب عليك التأكد من أن جذر مستند خادم الويب الخاص بك هو مستوى أعلى من الدليل العام (العادي) الذي يواجه الويب حتى يتمكن خادم الويب من خدمة الملفات من مساحة عمل تطبيق Ext JS أيضًا.

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا (MIT)

حقوق الطبع والنشر (ج) لعام 2021 مملوكة لشركة TEQneers GmbH & Co. KG

يُمنح الإذن مجانًا لأي شخص يحصل على نسخة من هذا البرنامج وملفات الوثائق المرتبطة به ("البرنامج")، للتعامل في البرنامج دون قيود، بما في ذلك، على سبيل المثال لا الحصر، حقوق الاستخدام والنسخ والتعديل والدمج. ونشر و/أو توزيع وترخيص من الباطن و/أو بيع نسخ من البرنامج، والسماح للأشخاص الذين تم توفير البرنامج لهم بالقيام بذلك، وفقًا للشروط التالية:

يجب تضمين إشعار حقوق الطبع والنشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الكبيرة من البرنامج.

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