Download the PHP package bkwld/codebasehq without Composer
On this page you can find all versions of the php package bkwld/codebasehq. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bkwld/codebasehq
More information about bkwld/codebasehq
Files in bkwld/codebasehq
Package codebasehq
Short Description Tools for integrating Laravel apps with CodebaseHQ features
License MIT
Informations about the package codebasehq
CodebaseHQ
This is a Laravel Package that makes it easy to integrate with select Codebase features:
- Pushing of exceptions, including full stack trace and all environment variables.
- A command that can be used in a deploy script to log a deployment.
- A command that can be used to comment on all tickets that were referenced in deployed git commit logs.
Installation
- Add it to your composer.json (
"bkwld/codebasehq": "~4.0"
) and do a composer install. - Add the service provider to your app.php config file providers:
Bkwld\CodebaseHQ\ServiceProvider::class,
.
Configuration
You will need to supply credentials to your CodebaseHQ account for this package to work. You can either store the following in your .env
file (preferred) or publish and edit the config file for this package (php artisan vendor:publish --provider=="Bkwld\CodebaseHQ\ServiceProvider"
).
- To log exceptions, only the
project
configs is required - For either deploy command, your user
api
creds are needed
.env options
Usage
Exception Logging
This package listens for Laravel log events and pushes errors to CodebaseHQ. By default, exceptions fired from a local
environment are not sent to CodebaseHQ. This can be changed by setting CODEBASE_LOG_EXCEPTIONS
explicitly to true
in your local .env
file. You can control which exceptions don't get sent to CodebaseHQ by editing your app's App\Exceptions\Handler::$dontReport
variable.
Deploy notifications
DeployHQ has a "Deployments" tab, found within your repo, that lists deployments. You can add to this list using the codebasehq:deploy
command. It accepts the following options, which mimic those found in the API docs.
servers
required - List of servers which you are deploying to (multiple servers should be comma separated, e.g. app1.myapp.com, app2.myapp.com, app3.myapp.com).branch
- The branch which you are deploying. This defaults to the currently checked out branch.revision
- The reference of the revision/commit you are deploying. It defaults to the HEAD commit.deploy-env
- The environment you are pushing to.
Examples:
Notify tickets of deployments
This command is designed to be run as part of a deploy script and requires you using the CodebaseHQ feature of linking to tickets from commit messages (ex: [touch:12]). By piping the output from git log
for the commits you are deploying to php artisan codebasehq:deploy-tickets
, the package will scan the logs for ticket references and then update those tickets that they have been deployed. Here's some examples:
Here is an example of what will get appended to the ticket: