includes/rcfeed/MachineReadableRCFeedFormatter.php

   1 <?php
   2
   3 /**
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along
  15  * with this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  17  * http://www.gnu.org/copyleft/gpl.html
  18  *
  19  * @file
  20  */
  21
  22 /**
  23  * Abstract class so there can be multiple formatters outputting the same data
  24  *
  25  * @since 1.23
  26  */
  27 abstract class MachineReadableRCFeedFormatter implements RCFeedFormatter {
  28
  29         /**
  30          * Take the packet and return the formatted string
  31          * @param array $packet
  32          * @return string
  33          */
  34         abstract protected function formatArray( array $packet );
  35
  36         /**
  37          * Generates a notification that can be easily interpreted by a machine.
  38          * @see RCFeedFormatter::getLine
  39          */
  40         public function getLine( array $feed, RecentChange $rc, $actionComment ) {
  41                 global $wgCanonicalServer, $wgServerName, $wgScriptPath;
  42                 $attrib = $rc->getAttributes();
  43
  44                 $packet = array(
  45                         // Usually, RC ID is exposed only for patrolling purposes,
  46                         // but there is no real reason not to expose it in other cases,
  47                         // and I can see how this may be potentially useful for clients.
  48                         'id' => $attrib['rc_id'],
  49                         'type' => RecentChange::parseFromRCType( $attrib['rc_type'] ),
  50                         'namespace' => $rc->getTitle()->getNamespace(),
  51                         'title' => $rc->getTitle()->getPrefixedText(),
  52                         'comment' => $attrib['rc_comment'],
  53                         'timestamp' => (int)wfTimestamp( TS_UNIX, $attrib['rc_timestamp'] ),
  54                         'user' => $attrib['rc_user_text'],
  55                         'bot' => (bool)$attrib['rc_bot'],
  56                 );
  57
  58                 if ( isset( $feed['channel'] ) ) {
  59                         $packet['channel'] = $feed['channel'];
  60                 }
  61
  62                 $type = $attrib['rc_type'];
  63                 if ( $type == RC_EDIT || $type == RC_NEW ) {
  64                         global $wgUseRCPatrol, $wgUseNPPatrol;
  65
  66                         $packet['minor'] = (bool)$attrib['rc_minor'];
  67                         if ( $wgUseRCPatrol || ( $type == RC_NEW && $wgUseNPPatrol ) ) {
  68                                 $packet['patrolled'] = (bool)$attrib['rc_patrolled'];
  69                         }
  70                 }
  71
  72                 switch ( $type ) {
  73                         case RC_EDIT:
  74                                 $packet['length'] = array(
  75                                         'old' => $attrib['rc_old_len'],
  76                                         'new' => $attrib['rc_new_len']
  77                                 );
  78                                 $packet['revision'] = array(
  79                                         'old' => $attrib['rc_last_oldid'],
  80                                         'new' => $attrib['rc_this_oldid']
  81                                 );
  82                                 break;
  83
  84                         case RC_NEW:
  85                                 $packet['length'] = array( 'old' => null, 'new' => $attrib['rc_new_len'] );
  86                                 $packet['revision'] = array( 'old' => null, 'new' => $attrib['rc_this_oldid'] );
  87                                 break;
  88
  89                         case RC_LOG:
  90                                 $packet['log_id'] = $attrib['rc_logid'];
  91                                 $packet['log_type'] = $attrib['rc_log_type'];
  92                                 $packet['log_action'] = $attrib['rc_log_action'];
  93                                 if ( $attrib['rc_params'] ) {
  94                                         wfSuppressWarnings();
  95                                         $params = unserialize( $attrib['rc_params'] );
  96                                         wfRestoreWarnings();
  97                                         if (
  98                                                 // If it's an actual serialised false...
  99                                                 $attrib['rc_params'] == serialize( false ) ||
 100                                                 // Or if we did not get false back when trying to unserialise
 101                                                 $params !== false
 102                                         ) {
 103                                                 // From ApiQueryLogEvents::addLogParams
 104                                                 $logParams = array();
 105                                                 // Keys like "4::paramname" can't be used for output so we change them to "paramname"
 106                                                 foreach ( $params as $key => $value ) {
 107                                                         if ( strpos( $key, ':' ) === false ) {
 108                                                                 $logParams[$key] = $value;
 109                                                                 continue;
 110                                                         }
 111                                                         $logParam = explode( ':', $key, 3 );
 112                                                         $logParams[$logParam[2]] = $value;
 113                                                 }
 114                                                 $packet['log_params'] = $logParams;
 115                                         } else {
 116                                                 $packet['log_params'] = explode( "\n", $attrib['rc_params'] );
 117                                         }
 118                                 }
 119                                 $packet['log_action_comment'] = $actionComment;
 120                                 break;
 121                 }
 122
 123                 $packet['server_url'] = $wgCanonicalServer;
 124                 $packet['server_name'] = $wgServerName;
 125
 126                 $packet['server_script_path'] = $wgScriptPath ?: '/';
 127                 $packet['wiki'] = wfWikiID();
 128
 129                 return $this->formatArray( $packet );
 130         }
 131 }