README

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

用法

composer require "composer-fallback/php-80.symfony-polyfill:*"

Composer 会优先

• 检查用户是否具有 php>=8.0
• 否则，回退到 symfony/polyfill-php80

它是如何工作的

此包包含 2 个版本

1. 最高版本 1.1 需要 php: >=8.0。

2. 最低版本 1.0 会触发 symfony/polyfill-php80 的安装。

当用户拥有正确的 php 版本时，Composer 将选择此最高版本。否则，Composer 将选择最低版本，在这种情况下，将下载以下包：symfony/polyfill-php80。

它解决了什么问题？

您正在维护一个需要 php 8.0 实现的库，但您不希望要求特定的实现。

例如，您需要定义在 php 8.0 中的函数，但 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 php >=8.0 -> no matching package found.

您可以让用户安装一个随机的包，它工作，但用户体验非常糟糕，一开始可能会令人困惑。

通过使用 composer-fallback/php-80.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/php-80.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/php-80.symfony-polyfill (1.0)
  - Installing symfony/polyfill-php80 (1.0)

贡献

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