Download the PHP package greeny/nette-slack-logger without Composer
On this page you can find all versions of the php package greeny/nette-slack-logger. 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 nette-slack-logger
nette-slack-logger
Log your errors directly into Slack room
Installation
composer require greeny/nette-slack-logger
And register extension to your config.neon:
By default the logger is just turned off, since you probably do not want to log errors from dev environment. If you want to enable it, add following lines to config.local.neon at your production server:
Of course replace slackUrl with payload URL from your incomming webhook from Slack.
You can leave logUrl empty, but if you have your logs accessible through web (of course e.g. protected by HTTP auth or available only from company IPs),
you can define this URL here. __FILE__ will be replaced by filename of file with exception.
You can also define request timeout in key timeout.
Configuration
You can also futher configure your logger:
messageFactory holds FQN of class, which is implementing greeny\NetteSlackLogger\IMessageFactory. This class is used for creating messages for Slack.
You can omit it, if you want to use default provided one. If you create custom message factory, it receives default parameters as first argument and logUrl as second one.
Defaults are self-explaining, but here is description of them:
channel- the channel you want your messages to arrive (overrides settings in webhook in slack administration)icon- the icon you want your bot to have (overrides settings in webhook in slack administration)name- the name you want your bot to have (overrides settings in webhook in slack administration)title- the title you want your message to havetext- the text you want your message to have (you will probably never use this, but it is here for consistency purposes)color- the color you want your message to have (accepts#RRGGBBand maybe some other things, not sure about it)
Handlers
You can also set custom handlers for logger. Just get your logger instance through DI or by calling Tracy\Debugger::getLogger() and use method addHandler to add your custom handler.
Handler is a callable, which receives greeny\NetteSlackLogger\MessageSendEvent as only argument. It has set of usefull methods:
getMessage()- returns the message being sentgetValue()- returns value being loggedgetPriority()- returns the priority of this log actiongetLogFile()- returns file to which value was logged (or NULL if nothing got logged)cancel()- cancels sending of messageisCancelled()- returns if sending is cancelled or not
getMessage() method returns instance of greeny\NetteSlackLogger\IMessage, which has getters and setters for same properties, which you define in defaults section (see Configuration)
You can alter your message here, since handlers are called before message is sent. If you cancel message, it still gets logged into that file.
