php - 使用 PHP composer 克隆 git repo

Question

我正在尝试使用composer从github自动克隆一个不在packagist中的git存储库，但它不起作用，我不知道我做错了什么。

我认为我必须将它包含在“存储库”中，如下所示：

"repositories": [
    {
        "url": "https://github.com/l3pp4rd/DoctrineExtensions.git",
        "type": "git"
    }
],

然后可能在“要求”部分列出它。它应该类似于此示例，但它不起作用。它只是给出了这个错误：

您的要求无法解决为一组可安装的软件包。

有没有人尝试过做这样的事情？

score 156 · Accepted Answer

该软件包实际上可以通过 packagist 获得。在这种情况下，您不需要自定义存储库定义。只需确保添加一个require（始终需要）具有匹配的版本约束。

通常，如果 packagegist 上有包可用，请不要添加 VCS 存储库。它只会减慢速度。

对于无法通过 packagist 获得的软件包，请使用VCS（或 git）存储库，如您的问题所示。当你这样做时，请确保：

“存储库”字段在根 composer.json 中指定（它是一个仅根字段，来自所需包的存储库定义被忽略）
存储库定义指向有效的 VCS 存储库
如果类型是“git”而不是“vcs”（如您的问题），请确保它实际上是一个 git repo
你有一个有require问题的包裹
约束中的约束require与 VCS 存储库提供的版本相匹配。您可以使用它composer show <packagename>来查找可用的版本。在这种情况下~2.3将是一个不错的选择。
中的require名称与远程中的名称匹配composer.json。在这种情况下，它是gedmo/doctrine-extensions。

composer.json这是一个通过 VCS 存储库安装相同包的示例：

{
    "repositories": [
        {
            "url": "https://github.com/l3pp4rd/DoctrineExtensions.git",
            "type": "git"
        }
    ],
    "require": {
        "gedmo/doctrine-extensions": "~2.3"
    }
}

VCS repo 文档很好地解释了所有这些。

如果有可用的 git（或其他 VCS）存储库composer.json，请不要使用“包”存储库。包 repos 要求您提供定义中的所有元数据，并且将完全忽略提供的 dist 和源中的任何composer.json存在。它们还有其他限制，例如在大多数情况下不允许正确更新。

避免包 repos（另见文档）。

score 127 · Accepted Answer

在 2013 年撰写本文时，这是一种方法。Composer 增加了对更好方法的支持：参见@igorw 的回答

你有存储库吗？

Composer 支持 Git、Mercurial 和 SVN。

您对存储库有写入权限吗？

是的？

存储库有composer.json文件吗

如果您有一个存储库，您可以写入：添加composer.json文件，或修复现有文件，不要使用下面的解决方案。

转到@igorw 的答案

仅当您没有存储库
或存储库没有 Acomposer.json并且您无法添加它时才使用它

这将覆盖 Composer 可能能够从原始存储库中读取的所有内容composer.json，包括包的依赖项和自动加载。

使用package类型会将正确定义所有内容的负担转移到您身上。更简单的方法是在存储库中有一个composer.json文件，然后使用它。

此解决方案实际上仅适用于您无法更改的废弃 ZIP 下载或您只能阅读但不再维护的存储库的极少数情况。

"repositories": [
    {
        "type":"package",
        "package": {
          "name": "l3pp4rd/doctrine-extensions",
          "version":"master",
          "source": {
              "url": "https://github.com/l3pp4rd/DoctrineExtensions.git",
              "type": "git",
              "reference":"master"
            }
        }
    }
],
"require": {
    "l3pp4rd/doctrine-extensions": "master"
}

score 52 · Accepted Answer

您可以像这样将 git 存储库包含到 composer.json：

"repositories": [
{
    "type": "package",
    "package": {
        "name": "example-package-name", //give package name to anything, must be unique
        "version": "1.0",
        "source": {
            "url": "https://github.com/example-package-name.git", //git url
            "type": "git",
            "reference": "master" //git branch-name
        }
    }
}],
"require" : {
  "example-package-name": "1.0"
}

score 6 · Accepted Answer

只需告诉作曲家使用源（如果有）：

composer update --prefer-source

或者：

composer install --prefer-source

然后，您将获得作为克隆存储库而不是提取的 tarball 的包，因此您可以进行一些更改并将它们提交回来。当然，假设您对存储库具有写入/推送权限，并且 Composer 知道项目的存储库。

免责声明：我想我可能会回答一些不同的问题，但这正是我发现这个问题时所寻找的，所以我希望它对其他人也有用。

如果 Composer 不知道项目的存储库在哪里，或者项目没有正确的 composer.json，情况会有点复杂，但其他人已经回答了这样的场景。

score 3 · Accepted Answer

我遇到了以下错误：The requested package my-foo/bar could not be found in any version, there may be a typo in the package name.

如果您要分叉另一个 repo 来进行自己的更改，您最终会得到一个新的存储库。

例如：

https://github.com/foo/bar.git
=>
https://github.com/my-foo/bar.git

新的 url 需要进入 composer.json 的存储库部分。

my-foo/bar请记住，如果您想在 require 部分中引用您的 fork ，则必须在composer.json新 repo 内的文件中重命名包。

{
    "name":         "foo/bar",

=>

{
    "name":         "my-foo/bar",

如果您刚刚分叉了最简单的方法，那就是在 github 中对其进行编辑。

score 3 · Accepted Answer

我尝试加入这里提到的解决方案，因为它需要列出一些重要的点。

正如@igorw 的回答中提到的那样，在这种情况下，存储库的 URL 必须在 composer.json 文件中指定，但是因为在这两种情况下，composer.json 都必须存在（不像@Mike Graf 的第二种方式）在Packagist 上发布它是差别不大（此外，Github 目前也以 npm 包的形式提供包服务），唯一的区别是注册后在 packagist 界面上直接输入 URL。
此外，它的缺点是它不能依赖使用这种方法的外部库，因为递归存储库定义在 Composer 中不起作用。此外，由于它，它似乎有一个“错误”，因为递归定义在依赖项中失败，在根目录中显式重新指定存储库似乎还不够，而且包中的所有依赖项都必须被重新指定。

使用作曲家文件（2012 年 10 月 18 日 15:13 igorw 回答）

{
    "repositories": [
        {
            "url": "https://github.com/l3pp4rd/DoctrineExtensions.git",
            "type": "git"
        }
    ],
    "require": {
        "gedmo/doctrine-extensions": "~2.3"
    }
}

没有作曲家文件（2013 年 1 月 23 日 17:28 Mike Graf 回答）

"repositories": [
    {
        "type":"package",
        "package": {
          "name": "l3pp4rd/doctrine-extensions",
          "version":"master",
          "source": {
              "url": "https://github.com/l3pp4rd/DoctrineExtensions.git",
              "type": "git",
              "reference":"master"
            }
        }
    }
],
"require": {
    "l3pp4rd/doctrine-extensions": "master"
}

score 2 · Accepted Answer

就我而言，我使用 Symfony2.3.x 并且最小稳定性参数默认为“稳定”（这很好）。我想导入不在 packagist 中的 repo，但遇到了同样的问题“您的要求无法解决为一组可安装的软件包。”。我尝试导入的仓库中的 composer.json 似乎使用了最低稳定性的“开发”。

因此，要解决此问题，请不要忘记验证minimum-stability. 我通过要求一个dev-master版本而不是本文中master所述的方式解决了这个问题。

score 1 · Accepted Answer

如果你想使用composer.jsonGitHub 中的一个，你可以查看这个示例（在 VCS 部分下）。

package 部分适用于没有composer.json. 但是，您也没有遵循该示例，否则它也会起作用。请阅读它关于包存储库的内容：

基本上，您定义了包含在作曲家存储库中的相同信息packages.json，但仅适用于单个包。同样，最少的必填字段是名称、版本以及 dist 或 source。

php - 使用 PHP composer 克隆 git repo

8 回答 8

Related

Reference