ReourceLoader

概述

ResourceLoader 是 MediaWiki 1.19 引入的一个核心组件，旨在改进 MediaWiki 维基的性能和可维护性。它取代了传统的 `load.php` 脚本，负责加载和管理维基页面所需的各种资源，例如 CSS 文件、JavaScript 文件、以及其他依赖项。ResourceLoader 的核心思想是将这些资源组织成“模块”，并利用现代 Web 开发技术（如模块化、压缩、缓存）来优化加载过程。它极大地提升了页面加载速度，降低了服务器负载，并简化了自定义和扩展的流程。ResourceLoader 的设计目标是提供一个灵活、高效、可扩展的资源管理系统，以适应不断增长的维基需求。在ResourceLoader 出现之前，MediaWiki的资源加载方式比较原始，存在诸多问题，例如资源重复加载、加载顺序不确定、难以进行优化等。ResourceLoader 解决了这些问题，成为现代 MediaWiki 维基不可或缺的一部分。MediaWiki 1.40 版本对 ResourceLoader 进行了进一步的优化和改进，使其更加稳定和高效。

主要特点

ResourceLoader 具有以下关键特点：

模块化： 将资源组织成模块，每个模块包含一组相关的 CSS 和 JavaScript 文件。这使得资源管理更加清晰和易于维护。
依赖管理： 能够自动处理模块之间的依赖关系，确保资源按照正确的顺序加载。依赖关系的解析是ResourceLoader的核心功能之一。
压缩和合并： 能够将多个 CSS 和 JavaScript 文件压缩和合并成一个文件，减少 HTTP 请求数量，提高页面加载速度。
缓存： 能够利用浏览器缓存和服务器缓存，减少资源加载时间。浏览器缓存对于优化用户体验至关重要。
版本控制： 能够为每个模块分配版本号，以便在更新资源时能够正确地进行缓存失效。版本控制系统可以与ResourceLoader集成。
延迟加载： 能够延迟加载一些非关键的资源，例如只有在用户滚动页面时才需要加载的资源。延迟加载能够显著提升首屏加载速度。
条件加载： 能够根据不同的条件加载不同的资源，例如根据用户设备类型或浏览器类型加载不同的 CSS 文件。条件语句在实现条件加载时起着关键作用。
自定义模块： 允许开发者创建自定义模块，以扩展维基的功能。自定义模块开发需要熟悉ResourceLoader的API。
与Extension的集成： 能够与各种 MediaWiki 扩展程序无缝集成，方便扩展程序加载所需的资源。MediaWiki扩展通常会使用ResourceLoader来加载资源。
调试工具： 提供了一些调试工具，帮助开发者诊断资源加载问题。调试工具使用指南可以帮助开发者更好地理解ResourceLoader。

使用方法

使用 ResourceLoader 主要涉及以下几个步骤：

1. 定义模块： 在 `LocalSettings.php` 文件中定义模块。可以使用 `wfResourceLoaderModules` 函数来定义模块。每个模块需要指定一个名称、一个描述、以及包含的 CSS 和 JavaScript 文件。例如：

```php $wgResourceLoaderModules = [

   'my.module' => [
       'description' => 'My custom module',
       'styles' => 'my.module.css',
       'scripts' => 'my.module.js',
   ],

]; ```

2. 注册模块： 在维基页面中使用 `mw.loader.load()` 函数来注册模块。例如：

```javascript mw.loader.load('my.module'); ```

3. 加载模块： 当页面加载时，ResourceLoader 会自动加载已注册的模块。

4. 创建自定义模块： 创建自定义模块需要将 CSS 和 JavaScript 文件放在特定的目录下（通常是 `extensions/` 目录下）。然后，在 `LocalSettings.php` 文件中定义模块，并指定 CSS 和 JavaScript 文件的路径。自定义模块目录结构需要遵循一定的规范。

5. 使用条件加载： 可以使用 `mw.config.get()` 函数来获取配置变量，并根据配置变量的值来决定是否加载某个模块。例如：

```javascript if (mw.config.get('wgDeviceType') === 'mobile') {

   mw.loader.load('mobile.module');

} ```

6. 调试模块： 可以通过在 URL 中添加 `?debug=1` 参数来启用 ResourceLoader 的调试模式。调试模式会显示资源加载的详细信息，帮助开发者诊断问题。ResourceLoader调试模式是诊断问题的有效方法。

7. 管理模块依赖： 使用 `requires` 属性来定义模块之间的依赖关系。例如：

```php $wgResourceLoaderModules = [

   'my.module' => [
       'description' => 'My custom module',
       'styles' => 'my.module.css',
       'scripts' => 'my.module.js',
       'requires' => ['jquery', 'mediawiki.api'],
   ],

]; ```

8. 使用 ResourceLoader API： ResourceLoader 提供了丰富的 API，例如 `mw.loader.load()`, `mw.loader.getState()`, `mw.loader.define()` 等。这些 API 可以帮助开发者更灵活地控制资源加载过程。ResourceLoader API文档提供了详细的API说明。

9. 配置缓存策略： 可以通过修改 `LocalSettings.php` 文件中的相关配置项来配置 ResourceLoader 的缓存策略。例如，可以设置缓存的有效期、缓存的目录等。缓存配置选项可以帮助开发者优化缓存性能。

10. 利用ResourceLoaderHooks： ResourceLoader 提供了各种Hooks，允许开发者在资源加载过程中执行自定义操作。例如，可以在资源加载之前或之后添加自定义的 CSS 或 JavaScript 代码。ResourceLoaderHooks提供了扩展ResourceLoader功能的强大机制。

相关策略

ResourceLoader 可以与其他策略结合使用，以进一步优化维基性能。

| 策略名称 | 描述 | 优点 | 缺点 | ResourceLoader 集成方式 | |---|---|---|---|---| |+ 性能优化策略比较 | | HTTP/2 | 一种新的 HTTP 协议，能够提高页面加载速度。 | 减少了 HTTP 请求数量，提高了数据传输效率。 | 需要服务器支持 HTTP/2 协议。 | ResourceLoader 可以利用 HTTP/2 协议来加速资源加载。 | | 浏览器缓存 | 利用浏览器缓存来减少资源加载时间。 | 减少了服务器负载，提高了页面加载速度。 | 缓存失效时可能会导致用户看到旧版本的资源。 | ResourceLoader 默认启用了浏览器缓存。 | | CDN | 使用内容分发网络来加速资源加载。 | 提高了资源加载速度，降低了服务器负载。 | 需要付费使用 CDN 服务。 | ResourceLoader 可以配置为从 CDN 加载资源。 | | 图片优化 | 优化图片大小和格式，减少图片加载时间。 | 提高了页面加载速度，降低了服务器带宽消耗。 | 需要对图片进行处理。 | ResourceLoader 可以加载经过优化的图片。 | | 代码压缩 | 压缩 CSS 和 JavaScript 代码，减少文件大小。 | 提高了页面加载速度，降低了服务器带宽消耗。 | 压缩后的代码可读性较差。 | ResourceLoader 默认会对 CSS 和 JavaScript 代码进行压缩。 | | 延迟加载图片 | 延迟加载非关键的图片，提高首屏加载速度。 | 提高了首屏加载速度，改善了用户体验。 | 需要编写 JavaScript 代码来实现延迟加载。 | ResourceLoader 可以与延迟加载图片的代码结合使用。 | | 预加载资源 | 预加载关键的资源，减少页面加载时间。 | 提高了页面加载速度，改善了用户体验。 | 可能会增加服务器负载。 | ResourceLoader 可以预加载关键的资源。 | | 移动端优化 | 针对移动端设备进行优化，提高页面加载速度。 | 改善了移动端用户体验。 | 需要编写专门的移动端 CSS 和 JavaScript 代码。 | ResourceLoader 可以根据设备类型加载不同的资源。 | | 服务器端缓存 | 使用服务器端缓存来减少数据库查询次数。 | 降低了服务器负载，提高了页面加载速度。 | 缓存失效时可能会导致用户看到旧数据。 | ResourceLoader 可以与服务器端缓存结合使用。 | | Gzip 压缩 | 使用 Gzip 压缩来减少文件大小。 | 提高了页面加载速度，降低了服务器带宽消耗。 | 需要服务器支持 Gzip 压缩。 | ResourceLoader 可以加载经过 Gzip 压缩的资源。 | | 资源合并 | 将多个 CSS 和 JavaScript 文件合并成一个文件。 | 减少了 HTTP 请求数量，提高了页面加载速度。 | 合并后的文件体积较大。 | ResourceLoader 默认会对 CSS 和 JavaScript 文件进行合并。 | | 代码分割 | 将 JavaScript 代码分割成多个小文件，按需加载。 | 提高了页面加载速度，改善了用户体验。 | 需要编写复杂的代码分割逻辑。 | ResourceLoader 可以加载经过代码分割的 JavaScript 文件。 | | Webpack | 一种流行的 JavaScript 模块打包工具。 | 提供了强大的模块化、压缩、缓存等功能。 | 需要学习 Webpack 的使用方法。 | ResourceLoader 可以与 Webpack 集成，加载经过 Webpack 打包的资源。 | | Rollup | 另一种 JavaScript 模块打包工具。 | 专注于生成更小的、更高效的代码包。 | 需要学习 Rollup 的使用方法。 | ResourceLoader 可以与 Rollup 集成，加载经过 Rollup 打包的资源。 |

HTTP/2、浏览器缓存、CDN、图片优化、代码压缩、延迟加载、预加载资源、移动端优化、服务器端缓存、Gzip压缩、资源合并、代码分割、Webpack、Rollup、ResourceLoader API

立即开始交易

注册IQ Option (最低入金 $10) 开设Pocket Option账户 (最低入金 $5)

加入我们的社区

关注我们的Telegram频道 @strategybin，获取： ✓ 每日交易信号 ✓ 独家策略分析 ✓ 市场趋势警报 ✓ 新手教学资料