README

此库提供了一种简单的方法，可以将任何jQuery库包含到您的PHP项目中。这包括使用远程原始jQuery库或在您的服务器上本地缓存。功能包括

• 检查最新jQuery版本
• 自动使用任何主要版本的修复版本
• 使用任何风味的jQuery库：精简版、瘦版、未压缩版或瘦精简版。
• 列出所有可用版本
• 使用git版本

许可证

本项目采用 GNU LGPL 3.0 许可。

安装

通过Composer

composer install technicalguru/jquery

通过包下载

您可以从 GitHub 发布页面 下载源代码包

安装后任务

当您想使用本地缓存功能时，需要将目录 vendor/technicalguru/jquery/js 设置为您的web服务器可写。

如何使用

列出可用版本

$versionList = \TgJQuery\JQuery::getVersions();

此方法列出所有可用版本。

获取最新版本号

可以通过以下方式获取最新稳定版本：

$lastestVersionNumber = \TgJQuery\JQuery::getLatest();

如果您对最新的3.3修复版本感兴趣

$lastestVersionNumber = \TgJQuery\JQuery::getLatest('3.3');

获取远程库的URI

以下方法将为您提供用于进一步检查的URI

use TgJQuery\JQuery;

// Get URI to latest version, as uncompressed JS
$uri = JQuery::getUri('latest', JQuery::UNCOMPRESSED, TRUE);

// Get URI to 3.5.1 version, as slim JS
$uri = JQuery::getUri('3.5.1', JQuery::SLIM, TRUE);

// Get URI to latest 3.x git build, as minified JS
$uri = JQuery::getUri('3.x-git', JQuery::MINIFIED, TRUE);

布尔参数 TRUE 告诉jQuery仅使用远程版本，而不进行缓存。

您也可以以相同的方式获取正确的HTML脚本标签，将其包含在您的HTML输出中

use TgJQuery\JQuery;

// Get HTML link to latest version, as uncompressed JS
$link = JQuery::getLink('latest', JQuery::UNCOMPRESSED, TRUE);

// Get HTML link to 3.5.1 version, as slim JS
$link = JQuery::getLink('3.5.1', JQuery::SLIM, TRUE);

// Get HTML link to latest 3.x git build, as minified JS
$link = JQuery::getLink('3.x-git', JQuery::MINIFIED, TRUE);

缓存jQuery库

大多数项目更喜欢不在远程CDN上提供服务jQuery库，而是本地提供。这也是默认设置。这就是为什么 getUri() 和 getLink() 调用可以写得如此简洁。

use TgJQuery\JQuery;

// Get a local cache URI to latest version, as minified JS
$uri = JQuery::getUri('latest');

// Get local cache HTML link to 3.5.1 version, as slim minified JS
$link = JQuery::getLink('3.5.1', JQuery::SLIM_MINIFIED);

性能考虑

当前版本在您的脚本中首次调用 getLatest() 和 getVersions() 时会触发对 https://code.jqueryjs.cn 的远程调用。版本列表不会在多个HTTP请求之间进行缓存。这将在以后的版本中添加。

然而，建议在您的应用程序中使用定义的版本，以避免jQuery在后台动态升级时的副作用。

贡献

在 GitHub 问题跟踪器 中报告错误、请求增强或拉取请求。