221 lines
		
	
	
		
			6.3 KiB
		
	
	
	
		
			PHP
		
	
	
	
			
		
		
	
	
			221 lines
		
	
	
		
			6.3 KiB
		
	
	
	
		
			PHP
		
	
	
	
| <?php
 | |
| 
 | |
| /*
 | |
|  * This file is part of the Monolog package.
 | |
|  *
 | |
|  * (c) Jordi Boggiano <j.boggiano@seld.be>
 | |
|  *
 | |
|  * For the full copyright and license information, please view the LICENSE
 | |
|  * file that was distributed with this source code.
 | |
|  */
 | |
| 
 | |
| namespace Monolog\Handler;
 | |
| 
 | |
| use Monolog\Formatter\FormatterInterface;
 | |
| use Monolog\Logger;
 | |
| use Monolog\Handler\Slack\SlackRecord;
 | |
| 
 | |
| /**
 | |
|  * Sends notifications through Slack API
 | |
|  *
 | |
|  * @author Greg Kedzierski <greg@gregkedzierski.com>
 | |
|  * @see    https://api.slack.com/
 | |
|  */
 | |
| class SlackHandler extends SocketHandler
 | |
| {
 | |
|     /**
 | |
|      * Slack API token
 | |
|      * @var string
 | |
|      */
 | |
|     private $token;
 | |
| 
 | |
|     /**
 | |
|      * Instance of the SlackRecord util class preparing data for Slack API.
 | |
|      * @var SlackRecord
 | |
|      */
 | |
|     private $slackRecord;
 | |
| 
 | |
|     /**
 | |
|      * @param  string                    $token                  Slack API token
 | |
|      * @param  string                    $channel                Slack channel (encoded ID or name)
 | |
|      * @param  string|null               $username               Name of a bot
 | |
|      * @param  bool                      $useAttachment          Whether the message should be added to Slack as attachment (plain text otherwise)
 | |
|      * @param  string|null               $iconEmoji              The emoji name to use (or null)
 | |
|      * @param  int                       $level                  The minimum logging level at which this handler will be triggered
 | |
|      * @param  bool                      $bubble                 Whether the messages that are handled can bubble up the stack or not
 | |
|      * @param  bool                      $useShortAttachment     Whether the the context/extra messages added to Slack as attachments are in a short style
 | |
|      * @param  bool                      $includeContextAndExtra Whether the attachment should include context and extra data
 | |
|      * @param  array                     $excludeFields          Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2']
 | |
|      * @throws MissingExtensionException If no OpenSSL PHP extension configured
 | |
|      */
 | |
|     public function __construct($token, $channel, $username = null, $useAttachment = true, $iconEmoji = null, $level = Logger::CRITICAL, $bubble = true, $useShortAttachment = false, $includeContextAndExtra = false, array $excludeFields = array())
 | |
|     {
 | |
|         if (!extension_loaded('openssl')) {
 | |
|             throw new MissingExtensionException('The OpenSSL PHP extension is required to use the SlackHandler');
 | |
|         }
 | |
| 
 | |
|         parent::__construct('ssl://slack.com:443', $level, $bubble);
 | |
| 
 | |
|         $this->slackRecord = new SlackRecord(
 | |
|             $channel,
 | |
|             $username,
 | |
|             $useAttachment,
 | |
|             $iconEmoji,
 | |
|             $useShortAttachment,
 | |
|             $includeContextAndExtra,
 | |
|             $excludeFields,
 | |
|             $this->formatter
 | |
|         );
 | |
| 
 | |
|         $this->token = $token;
 | |
|     }
 | |
| 
 | |
|     public function getSlackRecord()
 | |
|     {
 | |
|         return $this->slackRecord;
 | |
|     }
 | |
| 
 | |
|     public function getToken()
 | |
|     {
 | |
|         return $this->token;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      *
 | |
|      * @param  array  $record
 | |
|      * @return string
 | |
|      */
 | |
|     protected function generateDataStream($record)
 | |
|     {
 | |
|         $content = $this->buildContent($record);
 | |
| 
 | |
|         return $this->buildHeader($content) . $content;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Builds the body of API call
 | |
|      *
 | |
|      * @param  array  $record
 | |
|      * @return string
 | |
|      */
 | |
|     private function buildContent($record)
 | |
|     {
 | |
|         $dataArray = $this->prepareContentData($record);
 | |
| 
 | |
|         return http_build_query($dataArray);
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Prepares content data
 | |
|      *
 | |
|      * @param  array $record
 | |
|      * @return array
 | |
|      */
 | |
|     protected function prepareContentData($record)
 | |
|     {
 | |
|         $dataArray = $this->slackRecord->getSlackData($record);
 | |
|         $dataArray['token'] = $this->token;
 | |
| 
 | |
|         if (!empty($dataArray['attachments'])) {
 | |
|             $dataArray['attachments'] = json_encode($dataArray['attachments']);
 | |
|         }
 | |
| 
 | |
|         return $dataArray;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Builds the header of the API Call
 | |
|      *
 | |
|      * @param  string $content
 | |
|      * @return string
 | |
|      */
 | |
|     private function buildHeader($content)
 | |
|     {
 | |
|         $header = "POST /api/chat.postMessage HTTP/1.1\r\n";
 | |
|         $header .= "Host: slack.com\r\n";
 | |
|         $header .= "Content-Type: application/x-www-form-urlencoded\r\n";
 | |
|         $header .= "Content-Length: " . strlen($content) . "\r\n";
 | |
|         $header .= "\r\n";
 | |
| 
 | |
|         return $header;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      *
 | |
|      * @param array $record
 | |
|      */
 | |
|     protected function write(array $record)
 | |
|     {
 | |
|         parent::write($record);
 | |
|         $this->finalizeWrite();
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Finalizes the request by reading some bytes and then closing the socket
 | |
|      *
 | |
|      * If we do not read some but close the socket too early, slack sometimes
 | |
|      * drops the request entirely.
 | |
|      */
 | |
|     protected function finalizeWrite()
 | |
|     {
 | |
|         $res = $this->getResource();
 | |
|         if (is_resource($res)) {
 | |
|             @fread($res, 2048);
 | |
|         }
 | |
|         $this->closeSocket();
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Returned a Slack message attachment color associated with
 | |
|      * provided level.
 | |
|      *
 | |
|      * @param  int    $level
 | |
|      * @return string
 | |
|      * @deprecated Use underlying SlackRecord instead
 | |
|      */
 | |
|     protected function getAttachmentColor($level)
 | |
|     {
 | |
|         trigger_error(
 | |
|             'SlackHandler::getAttachmentColor() is deprecated. Use underlying SlackRecord instead.',
 | |
|             E_USER_DEPRECATED
 | |
|         );
 | |
| 
 | |
|         return $this->slackRecord->getAttachmentColor($level);
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Stringifies an array of key/value pairs to be used in attachment fields
 | |
|      *
 | |
|      * @param  array  $fields
 | |
|      * @return string
 | |
|      * @deprecated Use underlying SlackRecord instead
 | |
|      */
 | |
|     protected function stringify($fields)
 | |
|     {
 | |
|         trigger_error(
 | |
|             'SlackHandler::stringify() is deprecated. Use underlying SlackRecord instead.',
 | |
|             E_USER_DEPRECATED
 | |
|         );
 | |
| 
 | |
|         return $this->slackRecord->stringify($fields);
 | |
|     }
 | |
| 
 | |
|     public function setFormatter(FormatterInterface $formatter)
 | |
|     {
 | |
|         parent::setFormatter($formatter);
 | |
|         $this->slackRecord->setFormatter($formatter);
 | |
| 
 | |
|         return $this;
 | |
|     }
 | |
| 
 | |
|     public function getFormatter()
 | |
|     {
 | |
|         $formatter = parent::getFormatter();
 | |
|         $this->slackRecord->setFormatter($formatter);
 | |
| 
 | |
|         return $formatter;
 | |
|     }
 | |
| }
 |