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; | ||
|  |     } | ||
|  | } |