Download the PHP package cbednarski/pulse without Composer
On this page you can find all versions of the php package cbednarski/pulse. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package pulse
Pulse
Pulse allows you to easily write healthchecks for your application and display a simple, aggregated report so you can quickly diagnose whether and why your app is having trouble (or whether you can blame someone else). You can also monitor your healthchecks with nagios, zabbix, etc.
[
]
(https://travis-ci.org/cbednarski/pulse)
Wait, what's a healthcheck?
Healthchecks are a great way to test system health and connectivity to other services. For example, you can verify connectivity to memcache or mysql, that your app can read / write to certain files, or that your API key for a third-party service is still working.
Installation
You can install this into your project using composer. Create a composer.json file in the root of your project and add the following:
Run composer install, include vendor/autoload.php, and you're off to the races!
Example Usage
Critical Checks
Healthchecks are critical by default, which means that the healthcheck page will return a 503 status code. Use these to see when there is a critical failure in your system. Critical checks must return boolean true or false. Add them with add(), or more explicitly with addCritical().
Here's an example implementation of healthcheck.php that checks connectivity to memcache:
Warnings
For non-critical checks you can use a warning and you'll get status 200 even if these fail. Use these to see when your app is experiencing service degredation but is still available. Warning checks must return boolean true or false.
Information
If you want to pass back non-boolean, informational data, you can use addInfo().
Response Specification
Pulse can be run via command-line, accessed via the browser, or used with tools like CURL.
Pulse automatically detects whether you're running from a browser, commandline, or CURLy interface and responds with color-blind-friendly html, json, or plaintext as appropriate.
Status Codes
Pulse responds with 200 status codes when all tests pass. If a test fails, pulse responds with 503. You can see these via curl:
$ curl -i http://example.com/healthcheck.phpJSON Format
To enable json-y goodness, you'll need to send Accept: application/json. E.g:
$ curl -H "Accept: application/json" http://example.com/healthcheck.phpExamples
You can see some very basic example healthchecks in healthcheck-sample.php. If you have php 5.4 or above, running make dev will load this so you can see it in action and play around with it.
Does Pulse Work With X?
Yep. Pulse is designed to be self-contained and is very simple, so it doesn't require you to use any particular framework. You are free to include other things like yml parsers, etc. if you choose, but we recommend NOT including a full framework stack on top of it. If the framework fails to load for some reason, your healthchecks won't be displayed, meaning they're not useful for diagnosing whatever problem you've encountered.
Won't This Expose Information About My App?
Potentially. You probably don't want to display the healthcheck results to the public. Instead, you could whitelist certain IPs.
