README

PHP 中处理 Git 仓库的库。

安装

下载最新包 或使用 Composer

composer require penobit/git-php

库需要 PHP 5.6 或更高版本和 git 客户端（Git 的路径必须在系统变量 PATH 中）。

下载 Git 安装程序

适用于 Linux

适用于 Windows

适用于 其他

用法

$git = new Penobit\Git\Git;
// create repo object
$repo = $git->open('/path/to/repo');

// create a new file in repo
$filename = $repo->getRepositoryPath() . '/readme.txt';
file_put_contents($filename, "Lorem ipsum
    dolor
    sit amet
");

// commit
$repo->addFile($filename);
$repo->commit('init commit');

初始化空仓库

$repo = $git->init('/path/to/repo-directory');

带参数

$repo = $git->init('/path/to/repo-directory', [
    '--bare', // creates bare repo
]);

克隆仓库

// Cloning of repository into subdirectory 'git-php' in current working directory
$repo = $git->cloneRepository('https://github.com/penobit/git-php.git');

// Cloning of repository into own directory
$repo = $git->cloneRepository('https://github.com/penobit/git-php.git', '/path/to/my/subdir');

基本操作

$repo->hasChanges();    // returns boolean
$repo->commit('commit message');
$repo->merge('branch-name');
$repo->checkout('master');

$repo->getRepositoryPath();

// adds files into commit
$repo->addFile('file.txt');
$repo->addFile('file1.txt', 'file2.txt');
$repo->addFile(['file3.txt', 'file4.txt']);

// renames files in repository
$repo->renameFile('old.txt', 'new.txt');
$repo->renameFile([
    'old1.txt' => 'new1.txt',
    'old2.txt' => 'new2.txt',
]);

// removes files from repository
$repo->removeFile('file.txt');
$repo->removeFile('file1.txt', 'file2.txt');
$repo->removeFile(['file3.txt', 'file4.txt']);

// adds all changes in repository
$repo->addAllChanges();

分支

// gets list of all repository branches (remotes & locals)
$repo->getBranches();

// gets list of all local branches
$repo->getLocalBranches();

// gets name of current branch
$repo->getCurrentBranchName();

// creates new branch
$repo->createBranch('new-branch');

// creates new branch and checkout
$repo->createBranch('patch-1', TRUE);

// removes branch
$repo->removeBranch('branch-name');

标签

// gets list of all tags in repository
$repo->getTags();

// creates new tag
$repo->createTag('v1.0.0');
$repo->createTag('v1.0.0', $options);
$repo->createTag('v1.0.0', [
    '-m' => 'message',
]);

// renames tag
$repo->renameTag('old-tag-name', 'new-tag-name');

// removes tag
$repo->removeTag('tag-name');

历史

// returns last commit ID on current branch
$commitId = $repo->getLastCommitId();
$commitId->getId(); // or (string) $commitId

// returns commit data
$commit = $repo->getCommit('734713bc047d87bf7eac9674765ae793478c50d3');
$commit->getId(); // instance of CommitId
$commit->getSubject();
$commit->getBody();
$commit->getAuthorName();
$commit->getAuthorEmail();
$commit->getAuthorDate();
$commit->getCommitterName();
$commit->getCommitterEmail();
$commit->getCommitterDate();
$commit->getDate();

// returns commit data of last commit on current branch
$commit = $repo->getLastCommit();

远程

// pulls changes from remote
$repo->pull('remote-name', ['--options']);
$repo->pull('origin');

// pushs changes to remote
$repo->push('remote-name', ['--options']);
$repo->push('origin');
$repo->push('origin', ['master', '-u']);

// fetchs changes from remote
$repo->fetch('remote-name', ['--options']);
$repo->fetch('origin');
$repo->fetch('origin', ['master']);

// adds remote repository
$repo->addRemote('remote-name', 'repository-url', ['--options']);
$repo->addRemote('origin', 'git@github.com:penobit/git-php.git');

// renames remote
$repo->renameRemote('old-remote-name', 'new-remote-name');
$repo->renameRemote('origin', 'upstream');

// removes remote
$repo->removeRemote('remote-name');
$repo->removeRemote('origin');

// changes remote URL
$repo->setRemoteUrl('remote-name', 'new-repository-url');
$repo->setRemoteUrl('upstream', 'https://github.com/penobit/git-php.git');

故障排除 - 如何为命令提供用户名和密码

1. 使用 SSH 而不是 HTTPS - https://stackoverflow.com/a/8588786
2. 将凭据存储到 Git 凭据存储

• 在 Windows Git Bash 中推送 github 而不输入用户名密码

• 在 git 中缓存您的 github 密码

• Git 工具凭据存储

1. 将用户名和密码插入到远程 URL 中

• git remote add origin https://user:password@server/path/repo.git

1. 对于 push()，您可以使用 --repo 参数

• $git->push(NULL, ['--repo' => 'https://user:password@server/path/repo.git']);

其他命令

要运行其他命令，您可以使用 execute 方法

$output = $repo->execute('command');
$output = $repo->execute('command', 'with', 'parameters');

// example:
$repo->execute('remote', 'set-branches', $originName, $branches);

自定义方法

您可以创建自定义方法。例如

class OwnGit extends \Penobit\Git\Git {
	public function open($directory) {
		return new OwnGitRepository($directory, $this->runner);
	}
}

class OwnGitRepository extends \Penobit\Git\GitRepository {
	public function setRemoteBranches($name, array $branches) {
		$this->run('remote', 'set-branches', $name, $branches);
		return $this;
	}
}


$git = new OwnGit;
$repo = $git->open('/path/to/repo');
$repo->addRemote('origin', 'repository-url');
$repo->setRemoteBranches('origin', [
	'branch-1',
	'branch-2',
]);