ext application

ext-приложение

Базовый компонент для интеграции Sencha Ext JS в PHP-приложение.

Введение

Эта библиотека обеспечивает простую абстракцию различных требований при запуске приложений Sencha Ext JS 6 (хотя и 5 тоже должно работать) из контекста разработки и производства с использованием страниц, сгенерированных сервером. В сборках для разработки и производства используются разные деревья исходного кода для обслуживания файлов приложений. Этот процесс основан на так называемом манифесте и микрозагрузчике Javascript. Чтобы обеспечить бесперебойную работу этого процесса со страницами и маршрутизацией, сгенерированными сервером, библиотека подключается к созданию манифеста и динамически изменяет манифест в зависимости от требуемой среды и контекста.

В настоящее время эта библиотека используется только в качестве основы teqneers/ext-application-bundle, пакета Symfony, который интегрирует Ext JS в приложение на базе Symfony. Мы не пытались использовать библиотеку как отдельный компонент или в каком-либо другом контексте, кроме среды Symfony, поэтому ниже описано только то, как она должна работать теоретически без пакета. Мы будем признательны за любую помощь и вклад, чтобы сделать библиотеку более полезной за пределами пакета.

Установка

Вы можете установить эту библиотеку с помощью композитора

 composer require teqneers/ext-application

или добавьте пакет напрямую в файл композитора.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 (MIT)

Авторские права (c) 2021 TEQneers GmbH & Co. KG

Настоящим бесплатно любому лицу, получившему копию данного программного обеспечения и связанных с ним файлов документации («Программное обеспечение»), предоставляется разрешение на работу с Программным обеспечением без ограничений, включая, помимо прочего, права на использование, копирование, изменение, объединение. публиковать, распространять, сублицензировать и/или продавать копии Программного обеспечения, а также разрешать лицам, которым предоставлено Программное обеспечение, делать это при соблюдении следующих условий:

Вышеупомянутое уведомление об авторских правах и данное уведомление о разрешении должны быть включены во все копии или существенные части Программного обеспечения.

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИЯМИ ТОВАРНОЙ ЦЕННОСТИ, ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ. НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ АВТОРЫ ИЛИ ОБЛАДАТЕЛИ АВТОРСКИХ ПРАВ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБЫЕ ПРЕТЕНЗИИ, УБЫТКИ ИЛИ ДРУГУЮ ОТВЕТСТВЕННОСТЬ, БУДЬ В ДЕЙСТВИЯХ ПО КОНТРАКТУ, ПРАВОНАРУШЕНИЮ ИЛИ ДРУГИМ ОБРАЗОМ, ВОЗНИКАЮЩИЕ ОТ, ИЗ ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ДРУГИМИ СДЕЛКАМИ, ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ.