GIT API

A PHP API to get infos and manage a GIT distant or local repository., _(*1)

Usage

Working with a local repository clone:, _(*2)

// open a repo
$local_repo = ~/repositories/git-api
$repo = \GitApi\GitApi::open($local_repo)

// commiters list
$repo->getCommitersList()

// branches list
$repo->getBranchesList()

// commits list
$repo->getCommitsList()

// current branch
$repo->getCurrentBranch()

// description
$repo->getDescription()

// tags list
$repo->getTagsList()

// last commit infos
$repo->getLastCommitInfos()

// tree
$repo->getTree()

// tree for first dir
$repo->getTree('HEAD', $first_dir)

// files info
$repo->getFilesInfo()

// recursive tree
$repo->getRecursiveTree()

// commits history
$repo->getCommitsHistory()

Working with a distant repository URL will create a local clone:, _(*3)

// create a clone of a distant repo in a local dir
// if the local clone already exists, a `git pull` will be processed on it
$distant_repo = https://github.com/atelierspierrot/git-api
$local_repo = ~/repositories/git-api
$repo = \GitApi\GitApi::create($local_repo, $distant_repo)

// ... same as above

Installation

For a complete information about how to install this package and load its namespace, please have a look at our USAGE documentation., _(*4)

If you are a Composer user, just add the package to the requirements of your project's composer.json manifest file:, _(*5)

"atelierspierrot/git-api": "@stable"

You can use a specific release or the latest release of a major version using the appropriate version constraint., _(*6)

Please note that this package depends on the externals PHP Patterns and PHP Library., _(*7)

Author & License

GIT API, _(*8)

http://github.com/atelierspierrot/git-api, _(*9)

Copyright (c) 2013-2016 Pierre Cassat and contributors, _(*10)

Licensed under the Apache 2.0 license., _(*11)

http://www.apache.org/licenses/LICENSE-2.0, _(*12)

Les Ateliers Pierrot - Paris, France, _(*13)

http://www.ateliers-pierrot.fr/ - contact@ateliers-pierrot.fr, _(*14)