classes/File_redirection.php

   1 <?php
   2 /*
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2008, 2009, StatusNet, Inc.
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU Affero General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.     See the
  14  * GNU Affero General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Affero General Public License
  17  * along with this program.     If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 if (!defined('GNUSOCIAL')) { exit(1); }
  21
  22 /**
  23  * Table Definition for file_redirection
  24  */
  25
  26 class File_redirection extends Managed_DataObject
  27 {
  28     ###START_AUTOCODE
  29     /* the code below is auto generated do not remove the above tag */
  30
  31     public $__table = 'file_redirection';                // table name
  32     public $urlhash;                         // varchar(64) primary_key not_null
  33     public $url;                             // text
  34     public $file_id;                         // int(4)
  35     public $redirections;                    // int(4)
  36     public $httpcode;                        // int(4)
  37     public $modified;                        // datetime()   not_null default_CURRENT_TIMESTAMP
  38
  39     /* the code above is auto generated do not remove the tag below */
  40     ###END_AUTOCODE
  41
  42     protected $file; /* Cache the associated file sometimes */
  43
  44     public static function schemaDef()
  45     {
  46         return array(
  47             'fields' => array(
  48                 'urlhash' => array('type' => 'varchar', 'length' => 64, 'not null' => true, 'description' => 'sha256 hash of the URL'),
  49                 'url' => array('type' => 'text', 'description' => 'short URL (or any other kind of redirect) for file (id)'),
  50                 'file_id' => array('type' => 'int', 'description' => 'short URL for what URL/file'),
  51                 'redirections' => array('type' => 'int', 'description' => 'redirect count'),
  52                 'httpcode' => array('type' => 'int', 'description' => 'HTTP status code (20x, 30x, etc.)'),
  53                 'modified' => array('type' => 'datetime', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was modified'),
  54             ),
  55             'primary key' => array('urlhash'),
  56             'foreign keys' => array(
  57                 'file_redirection_file_id_fkey' => array('file' => array('file_id' => 'id')),
  58             ),
  59         );
  60     }
  61
  62     static public function getByUrl($url)
  63     {
  64         return self::getByPK(array('urlhash' => File::hashurl($url)));
  65     }
  66
  67     static function _commonHttp($url, $redirs) {
  68         $request = new HTTPClient($url);
  69         $request->setConfig(array(
  70             'connect_timeout' => 10, // # seconds to wait
  71             'max_redirs' => $redirs, // # max number of http redirections to follow
  72             'follow_redirects' => false, // We follow redirects ourselves in lib/httpclient.php
  73             'store_body' => false, // We won't need body content here.
  74         ));
  75         return $request;
  76     }
  77
  78     /**
  79      * Check if this URL is a redirect and return redir info.
  80      *
  81      * Most code should call File_redirection::where instead, to check if we
  82      * already know that redirection and avoid extra hits to the web.
  83      *
  84      * The URL is hit and any redirects are followed, up to 10 levels or until
  85      * a protected URL is reached.
  86      *
  87      * @param string $in_url
  88      * @return mixed one of:
  89      *         string - target URL, if this is a direct link or can't be followed
  90      *         array - redirect info if this is an *unknown* redirect:
  91      *              associative array with the following elements:
  92      *                code: HTTP status code
  93      *                redirects: count of redirects followed
  94      *                url: URL string of final target
  95      *                type (optional): MIME type from Content-Type header
  96      *                size (optional): byte size from Content-Length header
  97      *                time (optional): timestamp from Last-Modified header
  98      */
  99     static function lookupWhere($short_url, $redirs = 10, $protected = false) {
 100         if ($redirs < 0) return false;
 101
 102         if(strpos($short_url,'://') === false){
 103             return $short_url;
 104         }
 105         try {
 106             $request = self::_commonHttp($short_url, $redirs);
 107             // Don't include body in output
 108             $request->setMethod(HTTP_Request2::METHOD_HEAD);
 109             $response = $request->send();
 110
 111             if (405 == $response->getStatus() || 204 == $response->getStatus()) {
 112                 // HTTP 405 Unsupported Method
 113                 // Server doesn't support HEAD method? Can this really happen?
 114                 // We'll try again as a GET and ignore the response data.
 115                 //
 116                 // HTTP 204 No Content
 117                 // YFrog sends 204 responses back for our HEAD checks, which
 118                 // seems like it may be a logic error in their servers. If
 119                 // we get a 204 back, re-run it as a GET... if there's really
 120                 // no content it'll be cheap. :)
 121                 $request = self::_commonHttp($short_url, $redirs);
 122                 $response = $request->send();
 123             } elseif (400 == $response->getStatus()) {
 124                 throw new Exception('Got error 400 on HEAD request, will not go further.');
 125             }
 126         } catch (Exception $e) {
 127             // Invalid URL or failure to reach server
 128             common_log(LOG_ERR, "Error while following redirects for $short_url: " . $e->getMessage());
 129             return $short_url;
 130         }
 131
 132                 // if last url after all redirections is protected,
 133                 // use the url before it in the redirection chain
 134         if ($response->getRedirectCount() && File::isProtected($response->getEffectiveUrl())) {
 135                         $return_url = $response->redirUrls[$response->getRedirectCount()-1];
 136         } else {
 137                         $return_url = $response->getEffectiveUrl();
 138         }
 139
 140         $ret = array('code' => $response->getStatus()
 141                 , 'redirects' => $response->getRedirectCount()
 142                 , 'url' => $return_url);
 143
 144         $type = $response->getHeader('Content-Type');
 145         if ($type) $ret['type'] = $type;
 146         if ($protected) $ret['protected'] = true;
 147         $size = $response->getHeader('Content-Length'); // @fixme bytes?
 148         if ($size) $ret['size'] = $size;
 149         $time = $response->getHeader('Last-Modified');
 150         if ($time) $ret['time'] = strtotime($time);
 151         return $ret;
 152     }
 153
 154     /**
 155      * Check if this URL is a redirect and return redir info.
 156      * If a File record is present for this URL, it is not considered a redirect.
 157      * If a File_redirection record is present for this URL, the recorded target is returned.
 158      *
 159      * If no File or File_redirect record is present, the URL is hit and any
 160      * redirects are followed, up to 10 levels or until a protected URL is
 161      * reached.
 162      *
 163      * @param string $in_url
 164      * @param boolean $discover true to attempt dereferencing the redirect if we don't know it already
 165      * @return File_redirection
 166      */
 167     static function where($in_url, $discover=true) {
 168         $redir = new File_redirection();
 169         $redir->url = $in_url;
 170         $redir->urlhash = File::hashurl($redir->url);
 171         $redir->redirections = 0;
 172
 173         try {
 174             $r = File_redirection::getByUrl($in_url);
 175
 176             try {
 177                 $f = File::getByID($r->file_id);
 178                 $r->file = $f;
 179                 $r->redir_url = $f->url;
 180             } catch (NoResultException $e) {
 181                 // Invalid entry, delete and run again
 182                 common_log(LOG_ERR, "Could not find File with id=".$r->file_id." referenced in File_redirection, deleting File redirection entry and and trying again...");
 183                 $r->delete();
 184                 return self::where($in_url);
 185             }
 186
 187             // File_redirecion and File record found, return both
 188             return $r;
 189
 190         } catch (NoResultException $e) {
 191             // File_redirecion record not found, but this might be a direct link to a file
 192             try {
 193                 $f = File::getByUrl($in_url);
 194                 $redir->file_id = $f->id;
 195                 $redir->file = $f;
 196                 return $redir;
 197             } catch (NoResultException $e) {
 198                 // nope, this was not a direct link to a file either, let's keep going
 199             }
 200         }
 201
 202         if ($discover) {
 203             // try to follow redirects and get the final url
 204             $redir_info = File_redirection::lookupWhere($in_url);
 205             if(is_string($redir_info)) {
 206                 $redir_info = array('url' => $redir_info);
 207             }
 208
 209             // the last url in the redirection chain can actually be a redirect!
 210             // this is the case with local /attachment/{file_id} links
 211             // in that case we have the file id already
 212             try {
 213                 $r = File_redirection::getByUrl($redir_info['url']);
 214
 215                 $f = File::getKV('id',$r->file_id);
 216
 217                 if($f instanceof File) {
 218                     $redir->file = $f;
 219                     $redir->redir_url = $f->url;
 220                 } else {
 221                     // Invalid entry in File_redirection, delete and run again
 222                     common_log(LOG_ERR, "Could not find File with id=".$r->file_id." referenced in File_redirection, deleting File_redirection entry and trying again...");
 223                     $r->delete();
 224                     return self::where($in_url);
 225                 }
 226             } catch (NoResultException $e) {
 227                 // save the file now when we know that we don't have it in File_redirection
 228                 try {
 229                     $redir->file = File::saveNew($redir_info,$redir_info['url']);
 230                 } catch (ServerException $e) {
 231                     common_log(LOG_ERR, $e);
 232                 }
 233             }
 234
 235             // If this is a redirection and we have a file to redirect to, save it
 236             // (if it doesn't exist in File_redirection already)
 237             if($redir->file instanceof File && $redir_info['url'] != $in_url) {
 238                 try {
 239                     $file_redir = File_redirection::getByUrl($in_url);
 240                 } catch (NoResultException $e) {
 241                     $file_redir = new File_redirection();
 242                     $file_redir->urlhash = File::hashurl($in_url);
 243                     $file_redir->url = $in_url;
 244                     $file_redir->file_id = $redir->file->getID();
 245                     $file_redir->insert();
 246                     $file_redir->redir_url = $redir->file->url;
 247                 }
 248
 249                 $file_redir->file = $redir->file;
 250                 return $file_redir;
 251             }
 252         }
 253
 254         return $redir;
 255     }
 256
 257     /**
 258      * Shorten a URL with the current user's configured shortening
 259      * options, if applicable.
 260      *
 261      * If it cannot be shortened or the "short" URL is longer than the
 262      * original, the original is returned.
 263      *
 264      * If the referenced item has not been seen before, embedding data
 265      * may be saved.
 266      *
 267      * @param string $long_url
 268      * @param User $user whose shortening options to use; defaults to the current web session user
 269      * @return string
 270      */
 271     static function makeShort($long_url, $user=null)
 272     {
 273         $canon = File_redirection::_canonUrl($long_url);
 274
 275         $short_url = File_redirection::_userMakeShort($canon, $user);
 276
 277         // Did we get one? Is it shorter?
 278
 279         return !empty($short_url) ? $short_url : $long_url;
 280     }
 281
 282     /**
 283      * Shorten a URL with the current user's configured shortening
 284      * options, if applicable.
 285      *
 286      * If it cannot be shortened or the "short" URL is longer than the
 287      * original, the original is returned.
 288      *
 289      * If the referenced item has not been seen before, embedding data
 290      * may be saved.
 291      *
 292      * @param string $long_url
 293      * @return string
 294      */
 295
 296     static function forceShort($long_url, $user)
 297     {
 298         $canon = File_redirection::_canonUrl($long_url);
 299
 300         $short_url = File_redirection::_userMakeShort($canon, $user, true);
 301
 302         // Did we get one? Is it shorter?
 303         return !empty($short_url) ? $short_url : $long_url;
 304     }
 305
 306     static function _userMakeShort($long_url, User $user=null, $force = false) {
 307         $short_url = common_shorten_url($long_url, $user, $force);
 308         if (!empty($short_url) && $short_url != $long_url) {
 309             $short_url = (string)$short_url;
 310             // store it
 311             try {
 312                 $file = File::getByUrl($long_url);
 313             } catch (NoResultException $e) {
 314                 // Check if the target URL is itself a redirect...
 315                 // This should already have happened in processNew in common_shorten_url()
 316                 $redir = File_redirection::where($long_url);
 317                 $file = $redir->file;
 318             }
 319             // Now we definitely have a File object in $file
 320             try {
 321                 $file_redir = File_redirection::getByUrl($short_url);
 322             } catch (NoResultException $e) {
 323                 $file_redir = new File_redirection();
 324                 $file_redir->urlhash = File::hashurl($short_url);
 325                 $file_redir->url = $short_url;
 326                 $file_redir->file_id = $file->getID();
 327                 $file_redir->insert();
 328             }
 329             return $short_url;
 330         }
 331         return null;
 332     }
 333
 334     /**
 335      * Basic attempt to canonicalize a URL, cleaning up some standard variants
 336      * such as funny syntax or a missing path. Used internally when cleaning
 337      * up URLs for storage and following redirect chains.
 338      *
 339      * Note that despite being on File_redirect, this function DOES NOT perform
 340      * any dereferencing of redirects.
 341      *
 342      * @param string $in_url input URL
 343      * @param string $default_scheme if given a bare link; defaults to 'http://'
 344      * @return string
 345      */
 346     static function _canonUrl($in_url, $default_scheme = 'http://') {
 347         if (empty($in_url)) return false;
 348         $out_url = $in_url;
 349         $p = parse_url($out_url);
 350         if (empty($p['host']) || empty($p['scheme'])) {
 351             list($scheme) = explode(':', $in_url, 2);
 352             switch (strtolower($scheme)) {
 353             case 'fax':
 354             case 'tel':
 355                 $out_url = str_replace('.-()', '', $out_url);
 356                 break;
 357
 358             // non-HTTP schemes, so no redirects
 359             case 'bitcoin':
 360             case 'mailto':
 361             case 'aim':
 362             case 'jabber':
 363             case 'xmpp':
 364                 // don't touch anything
 365                 break;
 366
 367             // URLs without domain name, so no redirects
 368             case 'magnet':
 369                 // don't touch anything
 370                 break;
 371
 372             // URLs with coordinates, not browsable domain names
 373             case 'geo':
 374                 // don't touch anything
 375                 break;
 376
 377             default:
 378                 $out_url = $default_scheme . ltrim($out_url, '/');
 379                 $p = parse_url($out_url);
 380                 if (empty($p['scheme'])) return false;
 381                 break;
 382             }
 383         }
 384
 385         if (('ftp' == $p['scheme']) || ('ftps' == $p['scheme']) || ('http' == $p['scheme']) || ('https' == $p['scheme'])) {
 386             if (empty($p['host'])) return false;
 387             if (empty($p['path'])) {
 388                 $out_url .= '/';
 389             }
 390         }
 391
 392         return $out_url;
 393     }
 394
 395     static function saveNew($data, $file_id, $url) {
 396         $file_redir = new File_redirection;
 397         $file_redir->urlhash = File::hashurl($url);
 398         $file_redir->url = $url;
 399         $file_redir->file_id = $file_id;
 400         $file_redir->redirections = intval($data['redirects']);
 401         $file_redir->httpcode = intval($data['code']);
 402         $file_redir->insert();
 403     }
 404
 405     static public function beforeSchemaUpdate()
 406     {
 407         $table = strtolower(get_called_class());
 408         $schema = Schema::get();
 409         $schemadef = $schema->getTableDef($table);
 410
 411         // 2015-02-19 We have to upgrade our table definitions to have the urlhash field populated
 412         if (isset($schemadef['fields']['urlhash']) && in_array('urlhash', $schemadef['primary key'])) {
 413             // We already have the urlhash field, so no need to migrate it.
 414             return;
 415         }
 416         echo "\nFound old $table table, upgrading it to contain 'urlhash' field...";
 417         // We have to create a urlhash that is _not_ the primary key,
 418         // transfer data and THEN run checkSchema
 419         $schemadef['fields']['urlhash'] = array (
 420                                               'type' => 'varchar',
 421                                               'length' => 64,
 422                                               'not null' => true,
 423                                               'description' => 'sha256 hash of the URL',
 424                                             );
 425         $schemadef['fields']['url'] = array (
 426                                               'type' => 'text',
 427                                               'description' => 'short URL (or any other kind of redirect) for file (id)',
 428                                             );
 429         unset($schemadef['primary key']);
 430         $schema->ensureTable($table, $schemadef);
 431         echo "DONE.\n";
 432
 433         $classname = ucfirst($table);
 434         $tablefix = new $classname;
 435         // urlhash is hash('sha256', $url) in the File table
 436         echo "Updating urlhash fields in $table table...";
 437         // Maybe very MySQL specific :(
 438         $tablefix->query(sprintf('UPDATE %1$s SET %2$s=%3$s;',
 439                             $schema->quoteIdentifier($table),
 440                             'urlhash',
 441                             // The line below is "result of sha256 on column `url`"
 442                             'SHA2(url, 256)'));
 443         echo "DONE.\n";
 444         echo "Resuming core schema upgrade...";
 445     }
 446
 447     public function getFile() {
 448         if (!$this->file instanceof File) {
 449             $this->file = File::getByID($this->file_id);
 450         }
 451
 452         return $this->file;
 453     }
 454 }