GitHub Project PHP is a Laravel package that helps you manage your GitHub Projects (V2) in PHP.
It provides a simple webhook system to receive GitHub project events and automatically generate activity comments on issues and pull requests.
- Webhook Integration: Receive and process GitHub Projects V2 webhook events
- Queue Support: Process webhook events asynchronously for better performance
- API Endpoint: Generate comment messages via REST API
- 12+ Field Type Templates: Built-in templates for all GitHub Project field types
- Customizable Templates: Publish and customize Blade templates
- GitHub GraphQL API: Direct integration with GitHub's GraphQL API
- PHP ^8.4
- Laravel ^11.0|^12.0
- Composer
composer require cslant/github-project-php| Field Type | Description |
|---|---|
text | Simple text fields |
number | Numeric fields |
date | Date fields (Y-m-d format) |
single_select | Single-select dropdowns with color support |
multi_select | Multi-select fields |
checkbox | Boolean/toggle fields |
textarea | Long text content with diff view |
iteration | Iteration/sprint fields |
labels | Label/tag fields |
assignees | User assignment fields |
milestone | Milestone tracking |
unsupported | Fallback for unknown field types |
See the GitHub Project PHP Documentation for detailed usage instructions.
php artisan vendor:publish --provider="CSlant\GitHubProject\GithubProjectServiceProvider" --tag="views"This copies templates to resources/views/vendor/github-project/md/field_types/.
All field type templates receive:
$fieldName- Display name of the field$fieldType- Type of the field$fromValue- Previous value$toValue- New value$fieldData- Raw webhook data
Generate comment messages via API:
POST /github-project/generate-comment
Content-Type: application/json
{
"payload": { ... }
}
Enable queue processing in your config:
// config/github-project.php'is_queue_enabled' => true,Full documentation available at docs.cslant.com/github-project-php
Please see CHANGELOG for more information on what has changed recently.
The MIT License (MIT). Please see License File for more information.