README

Yii 2 核心Bower 资产

为官方 Composer 仓库安装提供的 Yii 2 核心Bower 包

功能

• 无需插件 通过 Composer 安装或更新 Yii 2 应用程序的 Bower 资产（甚至 v2.0.13 以上版本）

• 防止使用 Composer 安装和更新 Yii2 时 Bower 包的错误

  问题 1

  - yiisoft/yii2 2.0.12 需要 bower-asset/jquery 2.2.@stable | 2.1.@stable | 1.11.@stable | 1.12.@stable -> 未找到匹配的包。

• 官方安装方式 通过使用原始 Composer 仓库

厌倦了 fxp/composer-asset-plugin？这是一个好项目，有好的想法和实现。但它有一些问题：它大大减慢了 composer update 的速度，并且需要全局安装，从而影响所有项目。此外，还有 Travis 和 Scrutinizer 集成的特殊问题，有点令人烦恼。

与 Asset Packagist 相比，此包仅用于通过原始 Composer 仓库安装 Yii2 应用程序的 Bower 包，旨在使 Bower 与 Composer 分离。

支持的包

此 Bower 资产支持 Yii 2 核心（如 widgets 或 validators）。

对于 Yii 2 应用程序模板（如 yii2-app-basic 和 yii2-app-advanced），此包也支持 yii2-bootstrap 和其他依赖包，如 yii2-debug 和 yii2-gii。

安装

1. 需求包

在 Yii2 的 composer.json 中，在 yiisoft/yii2 之前要求 yidas/yii2-bower-asset。

示例 composer.json

"require": {
    "php": ">=5.4.0",
    "yidas/yii2-bower-asset": "~2.0.5",
    "yiisoft/yii2": "~2.0.5",
    "yiisoft/yii2-bootstrap": "~2.0.0"
}

在上述设置之后，您可以通过运行 composer require yidas/yii2-bower-asset 安装该包。它与 yidas/yii2-composer-bower-skip 相同，该插件使 composer 在没有 Bower 插件的情况下安装和更新 Yii2。

2. 设置应用程序配置

在 Yii2 应用程序的 config/web.php 中，添加一个名为 @bower 的别名，指向 @vendor/yidas/yii2-bower-asset/bower

$config = [
    ...
    'aliases' => [
        '@bower' => '@vendor/yidas/yii2-bower-asset/bower'
    ],
    ...
];

这种方法在效率和质量方面都是更好的选择。另外，您也可以使用安装程序来设置

通过包克隆安装程序安装

通过别名设置安装程序安装

3. 删除 Composer Asset-Packagist 仓库

如果您正在使用 Yii 的 2.0.13 或更高版本，您可能需要删除 composer.json 中的 repositories 设置以使用原始 Composer 仓库。

在 composer.json 中删除的示例片段

"repositories": [
    {
        "type": "composer",
        "url": "https://asset-packagist.org"
    }
]

最后，运行 composer update，然后享受它。

创建项目

如果您还没有 Yii2 项目，可以选择以下方式之一来创建

通过 Composer 创建项目

您可以使用以下包通过 Composer 创建 Yii2 项目

yidas/yii2-app-basic

composer create-project --prefer-dist yidas/yii2-app-basic

yidas/yii2-app-advanced

composer create-project --prefer-dist yidas/yii2-app-advanced

这些包是带有固定 Bower 的 Yii 2 应用程序模板，其中已包含 yidas/yii2-bower-asset。

从官方网站创建项目

您可以从官方 存档文件 下载 Yii2 项目，然后按照上述说明手动安装 yii2-bower-asset。

安装程序使用方法

如果您不想设置应用程序配置而想使用安装程序，有以下几种方式可以选择其中一种进行安装

通过包克隆安装程序安装

在Yii2的composer.json文件中，将脚本yidas\\yii2BowerAsset\\Installer::bower添加到post-package-install和post-package-update事件中。

"scripts": {
    "post-package-install": [
         "yidas\\yii2BowerAsset\\Installer::clone"
    ],
    "post-package-update": [
         "yidas\\yii2BowerAsset\\Installer::clone"
    ]
}

通过别名设置安装程序安装

在Yii2的composer.json文件中，将脚本yidas\\yii2BowerAsset\\Installer::setAlias添加到post-update-cmd事件中。

"scripts": {
    "post-package-install": [
         "yidas\\yii2BowerAsset\\Installer::setAlias"
    ],
    "post-package-update": [
         "yidas\\yii2BowerAsset\\Installer::setAlias"
    ],
    "unset-yii2-bower-asset": [
        "yidas\\yii2BowerAsset\\Installer::unsetAlias"
    ]
}

此安装将修改Yii2文件，您可以通过运行composer run-script unset-yii2-bower-asset来恢复。

限制

不要将Bower与Composer项目混合使用是本包的目标。

1. Bower包的多样性仅适用于Yii2核心。

2. Bower包的版本固定为当前Yii2版本。

3. 如果您在Yii2中需要其他Bower包，可以设置配置以适应此包或选择不使用。