13

对于我正在进行的一个项目,我们希望使用 git 作为我们经常修改的某些数据的修订跟踪器。我们正在使用 php 作为 web 前端,我们需要一个 goo php git 客户端来使用。我在互联网上遇到了一些,它们都倾向于具有相同的限制......

不支持 HTTP。我们需要能够推/拉到远程存储库。我们还需要克隆。

理想情况下,我正在寻找不使用 git 命令的东西(即:exec() 的包装器),但如果类运行良好,我愿意解决。我见过一个 C 库,它似乎可以满足我的要求,但是 php 语言绑定不完整,并且 http 函数被标记为实验性的。

有人对通过 php 使用 git 和 http 有任何见解吗?

4

3 回答 3

10

https://github.com/kbjr/Git.php

Git.php 是一个围绕 git 调用的包装类,它使用proc_open而不是exec运行命令。虽然它没有推/拉方法,但它确实有一个run运行自定义 git 命令的通用方法,所以它可以像这样使用:

$repo = Git::open('/path/to/repo');
$repo->run('push origin master');

它也确实有克隆方法(clone_to以及clone_from进行本地克隆和clone_remote远程克隆)。

于 2012-02-17T05:30:57.423 回答
3

一种可能性是使用 PHP 的 SSH 库通过连接回 Web 服务器来执行这些操作?

或者我发现这组类允许您通过 HTTP 克隆和读取其他元数据,但不能推送或拉取。但是,如果您有足够的勇气扩展它们来做到这一点,这可能是一个起点。我可以想象复制这些过程并使其与各种服务器版本等兼容将是很多工作。

[2014 年 3 月 23 日更新,收到赞成票后 - 谢谢!]

我确实得到了一些尝试实现上述内容的方法(我正在寻找一个实现,画了一个空白,所以试图写我自己的),这就像我想的那样很难我实际上放弃了它,因为我找到了一种更简单的方法来在不同的架构中实现这一点,但这是我尝试编写的类。它基本上可以工作,但对我工作的环境变化很脆弱(即它不能很好地处理错误或问题)。

它用:

  1. 赫祖特/php-ssh
  2. 一个 ssh 配置文件 - 简化在代码中设置身份验证凭据的技巧

(注意 - 我必须快速从代码中删除一些细节来发布它。所以你需要稍微摆弄一下才能将它集成到你的应用程序/命名空间等中。)

<?php
/**
 * @author: scipilot
 * @since: 31/12/2013
 */

/**
 * Class GitSSH allows you to perform Git functions over an SSH session.
 * i.e. you are using the command-line Git commands after SSHing to a host which has the Git client.
 *
 * You don't need to know about the SSH to use the class, other than the fact you will need access
 * to a server via SSH which has the Git client installed. Its likely this is the local web server.
 *
 * This was made because PHP has no good native Git client.
 *
 * Requires herzult/php-ssh
 *
 * Example php-ssh config file would be
 *
 * <code>
 *  Host localhost
 *  User git
 *  IdentityFile id_rsa
 *
 *  Host your.host.domain.com
 *  User whoever
 *  IdentityFile ~/.ssh/WhoeverGit
 *</code>
 */
class GitSSH {
    protected $config;
    protected $session;
    protected $sPath;
    /**
     * @var string
     */
    protected $sConfigPath = '~/.ssh/config';

    /**
     * Connects to the specified host, ready for further commands.
     *
     * @param string $sHost         Host (entry in the config file) to connect to.
     * @param string $sConfigPath Optional; config file path. Defaults to ~/.ssh/config,
     *                            which is probably inaccessible for web apps.
     */
    function __construct($sHost, $sConfigPath=null){
        \Log::info('New GitSSH '.$sHost.', '.$sConfigPath);
        if(isset($sConfigPath)) $this->sConfigPath = $sConfigPath;

        $this->config = new \Ssh\SshConfigFileConfiguration($this->sConfigPath, $sHost);
        $this->session = new \Ssh\Session($this->config, $this->config->getAuthentication());
    }

    public function __destruct() {
        $this->disconnect();
    }

    /**
     * Thanks to Steve Kamerman, as there isn't a native disconnect.
     */
    public function disconnect() {
        $this->exec('echo "EXITING" && exit;');
        $this->session = null;
    }

    /**
     * Run a command (in the current working directory set by cd)
     * @param $sCommand
     * @return string
     */
    protected function exec($sCommand) {
        //echo "\n".$sCommand."\n";
        $exec = $this->session->getExec();
        $result = $exec->run('cd '.$this->sPath.'; '.$sCommand);
        // todo: parse/scrape the result, return a Result object?
        return $result;
    }

    /**
     * CD to a folder. (This not an 'incremental' cd!)
     * Devnote: we don't really execute the cd now, it's appended to other commands. Each command seems to re-login?
     *
     * @param string $sPath Absolute filesystem path, or relative from user home
     */
    public function cd($sPath){
        $this->sPath = $sPath;

        // @todo this is useless! each command seems to run in a separate login?
        //$result = $this->exec('cd'); // /; ls');
        //return $result;
    }

    /**
     * @return string
     */
    public function ls(){
        $result = $this->exec('ls ');

        return $result;
    }

    public function gitAdd($sOptions=null, array $aFiles=null){
        $result = $this->exec('git add '
            .(empty($sOptions) ? '' : ' '.$sOptions)
            .(empty($aFiles) ? '' : ' '.implode(' ', $aFiles))
        );

        return $result;
    }

    public function gitClone($sRepo, $sBranch=null, $sTarget=null){
        \Log::info('GitSSH::clone '.$sRepo.', '.$sBranch.', '.$sTarget);
        $result = $this->exec('git clone '
            .(empty($sBranch) ? '' : ' --branch '.$sBranch)
            .' '.$sRepo
            .' '.$sTarget);

        return $result;
    }

    public function gitCommit($sMessage, $sOptions=null, array $aFiles=null){
        $result = $this->exec('git commit '
            .'-m "'.addcslashes($sMessage, '"').'"'
            .(empty($sOptions) ? '' : ' '.$sOptions)
            .(empty($aFiles) ? '' : ' '.implode(' ', $aFiles))
        );

        return $result;
    }

    public function gitPull($sOptions=null, $sRepo=null, $sRefspec=null){
        $result = $this->exec('git pull '
            .(empty($sOptions) ? '' : ' '.$sOptions)
            .(empty($sRepo) ? '' : ' '.$sRepo)
            .(empty($sRefspec) ? '' : ' '.$sRefspec)
        );

        return $result;
    }

    public function gitPush($sOptions=null, $sRepo=null, $sRefspec=null){
        $result = $this->exec('git push '
            .(empty($sOptions) ? '' : ' '.$sOptions)
            .(empty($sRepo) ? '' : ' '.$sRepo)
            .(empty($sRefspec) ? '' : ' '.$sRefspec)
        );

        return $result;
    }

    /**
     * @return string the raw result from git status
     */
    public function gitStatus(){
        $result = $this->exec('git status');
        return $result;
    }

}
于 2013-12-30T10:56:55.623 回答
0

这看起来很有希望:http: //gitphp.org(断开的链接;查看存档版本

我想那会为你做的。这是它的描述:

GitPHP 是 git 存储库的 Web 前端。它模仿标准 gitweb 的外观,但使用 PHP 编写并使用 Smarty 模板进行自定义。它有一些附加功能,包括通过 GeSHi PHP 类和项目类别支持的语法突出显示。它适用于标准 git 以及 Windows 上的 msysgit。

设置应该相当简单——只需将压缩包解压到您要安装的位置,将 config/gitphp.conf.php.example 复制到 config/gitphp.conf.php,然后将 conf 中的 projectroot 设置为指向您的目录裸 git 存储库是,如果还没有,则使网络服务器可以写入 templates_c 目录。你可以查看 config/gitphp.conf.defaults.php 中所有可用的选项和默认值,如果你想覆盖默认值,可以将一个选项复制到你的配置文件中。如果您想对项目进行更高级的控制,例如为项目定义类别或从文本文件加载项目,您还可以将 config/projects.conf.php.example 复制到 config/projects.conf.php 并对其进行编辑。包含的自述文件中有更详细的说明。

注意:如果您要升级现有的 gitphp.conf.php 不会被覆盖,但我建议检查 gitphp.conf.defaults.php 以了解可能已添加的新配置选项。

您可以查看在此站点上运行的 Live Copy。

于 2012-02-14T22:01:02.693 回答