klaussilveira / gitter
Gitter 允许您以面向对象的方式与 Git 仓库进行交互。
1.0
2022-01-13 23:58 UTC
Requires
- php: >=5.3
- symfony/process: ^2.8
Requires (Dev)
- mockery/mockery: 0.9.1
- phpunit/phpunit: ~8
- symfony/filesystem: ^2.8
README
Gitter 允许您通过 PHP 以面向对象的方式与 Git 仓库交互。库的主要目标不是替换系统 git
命令,而是提供一致、稳定且高效的面向对象接口。
大多数命令都发送到系统的 git
命令,然后由 Gitter 进行解析和解释。所有这些对您来说都是透明的,所以您不必担心任何问题。
要求
- git (https://git-scm.cn) (已测试 1.7.5.4)
作者和贡献者
- Klaus Silveira (创建者,开发者)
许可证
用法
Gitter 非常易于使用,您只需要调用几个方法就可以开始。例如,创建新的仓库
$client = new Gitter\Client;
$repository = $client->createRepository('/home/user/test');
或者裸仓库
$client = new Gitter\Client;
$repository = $client->createRepository('/home/user/test', true);
或者打开现有的仓库
$client = new Gitter\Client;
$repository = $client->getRepository('/home/user/anothertest');
这两种方法都将返回一个 Repository
对象,该对象具有各种方法,允许您与该仓库进行交互。
获取提交列表
一旦您掌握了 Repository
对象,您可以使用
$commits = $repository->getCommits();
print_r($commits);
来获取各种提交的列表。
获取单个提交
给定特定的提交哈希,您可以找到有关该提交的信息
$commit = $repository->getCommit('920be98a05');
print_r($commit);
获取仓库统计信息
可以将统计聚合器添加到仓库中
$repository->addStatistics(array(
new Gitter\Statistics\Contributors,
new Gitter\Statistics\Date,
new Gitter\Statistics\Day,
new Gitter\Statistics\Hour
));
print_r($repository->getStatistics());