Download the PHP package fivelab/diagnostic without Composer
On this page you can find all versions of the php package fivelab/diagnostic. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package diagnostic
Russia has become a terrorist state.
Diagnostic
The library for diagnostic application.
Why?
This library helps for developers and devops for setup any applications.
If developer correct configure all diagnostics (paths, services, etc...) the devops before run the instance with our application only run diagnostic and can sees all problems (if it exist).
Primary problem:
The developer can add any parameter or service to application. As an example - add redis service for use in runtime. And lost provide this information before release application. The devops (or developer) release new version application and the system not have any problems. But, we have a major issue because the redis only used in runtime and not processed in deploy process.
Devops add this instance to load balancer (if exist), and in next times the application not correct work ;(
Solution:
Before add the instance to load balancer (or processed scope), devops run diagnostic and can see all major problems.
Restrictions
If you want work with this mechanism you MUST add diagnostic check to all end points. As an example:
- Are you use cache? You MUST add check for verify access to cache directory.
- Are you use logs? You MUST add check for verify access to logs directory.
- Are you use DB? You MUST add check for connect to Database.
- Are you use Redis? You MUST add check for connect to Redis.
- Are you use any client for connect via HTTP? You MUST add check for connect to this endpoint.
- etc...
Attention: the devops (infrastructure team, release manager, developer) is not magic person and cannot see all required services by sky stars.
Configure and Run
For easy configure the diagnostic, you can use \FiveLab\Component\Diagnostic\Check\Definition\DefinitionCollectionBuilder
:
Integrate with applications
Dependency Injection
You can easy integrate this library to Symfony application, or application with DependencyInjection support.
For integrate, you can add the compiler pass to your container builder:
Add add check services:
The tag diagnostic.check
support next attributes:
- key - the unique key of check (default is service name).
- group - the group of this check (default is null).
- error_on_failure - if false, system not return error code from process (ignore failures, default is true).
Console commands
We provide console commands for easy integrate to any applications:
\FiveLab\Component\Diagnostic\Command\RunDiagnosticCommand
- command for run diagnostic.\FiveLab\Component\Diagnostic\Command\ListChecksCommand
- command for list all available checks.\FiveLab\Component\Diagnostic\Command\ListGroupsCommand
- command for list all available groups.
Development
For easy development you can use the Docker
and Docker compose
.
After success run and attach to container you must install vendors:
Before create the PR or merge into develop, please run next commands for validate code: