composer-fallback/intl.symfony-polyfill

使用用户提供的包满足 "intl" 需求,或者回退到 "symfony-polyfill"。

1.1 2020-10-02 12:33 UTC

This package is auto-updated.

Last update: 2024-08-29 05:43:33 UTC


README

提供一个元包,用于需要 intl 库的库,当用户不满足初始要求时,回退到默认实现。

用法

composer require "composer-fallback/intl.symfony-polyfill:*"

Composer 会优先

  • 检查用户是否有 ext-intl
  • 否则,回退到 symfony/intl

工作原理

此包包含 2 个版本

  1. 最高版本 1.1 需要 ext-intl

  2. 最低版本 1.0 触发安装 symfony/intl

当用户有扩展 ext-intl 时,Composer 会选择此最高版本。否则,Composer 将选择最低版本,在这种情况下,将下载以下包:symfony/intl

它解决了什么问题?

你正在维护一个需要 intl 实现的库,但你不想要求特定的实现。

例如,你需要 intl 中定义的功能,但 polyfill 存在且足够。

当最终用户使用以下代码要求你的库时

{
    "name": "end-user/app",
    "require": {
      "acme/lib": "^1.0"
    }
}

他们可能会遇到这样的错误

composer up

Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Installation request for acme/lib ^1.0 -> satisfiable by acme/lib[1.0].
    - acme/lib 1.0 requires ext-intl * -> no matching package found.

你可以要求用户安装一个随机的包,这可以工作,但第一次体验非常糟糕,令人困惑。

通过使用 composer-fallback/intl.symfony-polyfill,用户将提供原生实现或回退到你的默认选择

满足首选要求的用户示例

{
    "name": "end-user/app",
    "require": {
        "acme/lib": "^1.0",
        "third-party/provide-implementation": "^1.0"
    }
}
composer up
...
Package operations: 2 installs, 0 updates, 0 removals
  - Installing acme/lib (1.0)
  - Installing composer-fallback/intl.symfony-polyfill (1.1)

回退到你的建议的用户示例

{
    "name": "end-user/app",
    "require": {
        "acme/lib": "^1.0"
    }
}
composer up
...
Package operations: 3 installs, 0 updates, 0 removals
  - Installing acme/lib (1.0)
  - Installing composer-fallback/intl.symfony-polyfill (1.0)
  - Installing symfony/intl (1.0)

贡献

此存储库是自动生成的。如果您想贡献并提交问题或拉取请求,请使用 composer-fallback/generator