matgou/docker-php

Docker PHP客户端

v0.2.1 2014-07-16 10:16 UTC

This package is not auto-updated.

Last update: 2024-09-24 07:55:41 UTC


README

Docker PHP(因为没有一个更好的名字)是一个用PHP编写的Docker客户端。这个库仍在开发中。目前支持的还不多,但目标是达到100%的API支持。

测试套件目前通过了Docker远程API v1.9的测试。

Travis-CI Scrutinizer Code Quality

版本控制

目前还没有稳定版,API正在快速演变,但我们仍然尝试根据semver来对库进行语义版本控制,但略有变动

  • 主版本号保持为0,直到API冻结
  • 次版本号在做出向后不兼容的更改时增加
  • 修订版号在添加新功能时增加

因此,如果您想设置0.5版本,请使用版本约束~0.5.0,应该就没什么问题。

在我们达到稳定API之前,我们不会记录升级程序,请阅读代码和PR以了解最新动态。您也可以向我们寻求帮助,我们都是好人!

安装

当然,推荐安装Docker PHP的方式是使用Composer

{
    "require": {
        "stage1/docker-php": "@dev"
    }
}

注意:Docker PHP还没有稳定版本。

用法

请参阅文档

单元测试

使用Composer设置测试套件

$ composer install --dev

使用PHPUnit运行它

$ bin/phpunit

贡献

以下是一些规则,遵循这些规则可以简化代码审查,并让维护者在接受和合并您的工作之前进行讨论。

  • 您必须遵循PSR-1PSR-2
  • 您必须运行测试套件。
  • 您必须编写(或更新)单元测试。
  • 您应该编写文档。

请编写有意义的提交信息,并在提交Pull Request之前rebase您的分支

可能会要求您压缩您的提交。这用于在合并之前“清理”您的Pull Request(我们不希望提交像fix testsfix 2fix 3等)。

此外,在GitHub上创建您的Pull Request时,您必须写一个描述,说明上下文或解释您为什么要创建它。

谢谢!

致谢

这份README大量借鉴了willdurand/Negotiation by @willdurand。这个人相当厉害。

项目

已知使用docker-php的项目

  • JoliCi,在不同的和隔离的堆栈上运行您的测试

许可证

MIT许可证(MIT)

版权所有 (c) 2013 Geoffrey Bachelet geoffrey@stage1.io

在此特此授予任何获得本软件及其相关文档副本(以下简称“软件”)的人免费使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许向软件提供者提供软件的人进行上述操作,但需遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。

软件按“原样”提供,不提供任何形式的保证,无论是明示的、暗示的,包括但不限于适销性、适用于特定目的和版权侵权的保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任承担责任,无论这些责任是在合同行为、侵权行为或其他行为中产生的,无论是在软件或软件的使用或其他操作中产生的。