ghostwriter/git

PHP wrapper for Git commands.

0.1.3 2026-01-26 01:48 UTC

Requires

• php: ~8.4.0 || ~8.5.0
• ext-mbstring: *
• ghostwriter/container: ^6.0.1
• ghostwriter/filesystem: ^0.1.2
• ghostwriter/shell: ^0.1.4

Requires (Dev)

• ext-xdebug: *
• ghostwriter/coding-standard: dev-main
• mockery/mockery: ^1.6.12
• phpunit/phpunit: ^12.5.7
• symfony/var-dumper: ^8.0.4

BSD-3-Clause

• Nathanael Esayeas

• git
• ghostwriter

README

PHP wrapper for Git commands

Installation

You can install the package via composer:

composer require ghostwriter/git

Star ⭐️ this repo if you find it useful

You can also star (🌟) this repo to find it easier later.

Usage

use Ghostwriter\Git\Git;

$environmentVariables = [
    'GIT_AUTHOR_NAME'  => 'Nathanael Esayeas',
    'GIT_AUTHOR_EMAIL' => '[e-mail]',
];

$git = Git::new('/path/to/repo', $environmentVariables);
$git->init();
$git->add('file.txt');
$git->commit('-m', 'Initial commit');
$git->push('origin', 'main');

// Cloning a repository
$git->clone('[e-mail]:ghostwriter/git.git', '--depth=1', '/path/to/clone');

// Each cloned repository should be managed with its own Git instance as follows:
$environmentVariables['GIT_AUTHOR_NAME'] = 'ghostwriter';
$environmentVariables['GIT_AUTHOR_EMAIL'] = '[e-mail]';

$clonedGit = Git::new('/path/to/clone', $environmentVariables);
$clonedGit->status();

Credits

• Nathanael Esayeas
• All Contributors

Changelog

Please see CHANGELOG.md for more information on what has changed recently.

License

Please see LICENSE for more information on the license that applies to this project.

Security

Please see SECURITY.md for more information on security disclosure process.