lib/action.php

   1 <?php
   2 /*
   3  * Laconica - a distributed open-source microblogging tool
   4  * Copyright (C) 2008, Controlez-Vous, 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('LACONICA')) { exit(1); }
  21
  22 class Action { // lawsuit
  23
  24         var $args;
  25
  26         function Action() {
  27         }
  28
  29         # For initializing members of the class
  30
  31         function init($argarray) {
  32                 $this->args =& common_copy_args($argarray);
  33                 return true;
  34         }
  35
  36         # For comparison with If-Last-Modified
  37         # If not applicable, return NULL
  38
  39         function last_modified() {
  40                 return NULL;
  41         }
  42
  43         function is_readonly() {
  44                 return false;
  45         }
  46
  47         function arg($key, $def=NULL) {
  48                 if (array_key_exists($key, $this->args)) {
  49                         return $this->args[$key];
  50                 } else {
  51                         return $def;
  52                 }
  53         }
  54
  55         function trimmed($key, $def=NULL) {
  56                 $arg = $this->arg($key, $def);
  57                 return (is_string($arg)) ? trim($arg) : $arg;
  58         }
  59
  60         # Note: argarray ignored, since it's now passed in in init()
  61
  62         function handle($argarray=NULL) {
  63
  64                 $lm = $this->last_modified();
  65
  66                 if ($lm) {
  67                         header('Last-Modified: ' . date(DATE_RFC822, $lm));
  68                         $if_modified_since = $_SERVER['HTTP_IF_MODIFIED_SINCE'];
  69                         if ($if_modified_since) {
  70                                 $ims = strtotime($if_modified_since);
  71                                 if ($lm <= $ims) {
  72                                         $if_none_match = $_SERVER['HTTP_IF_NONE_MATCH'];
  73                                         if ($if_none_match) {
  74                                                 header('304 Not Modified');
  75                                                 # Better way to do this?
  76                                                 exit(0);
  77                                         }
  78                                 }
  79                         }
  80                 }
  81         }
  82
  83         function boolean($key, $def=false) {
  84                 $arg = strtolower($this->trimmed($key));
  85
  86                 if (is_null($arg)) {
  87                         return $def;
  88                 } else if (in_array($arg, array('true', 'yes', '1'))) {
  89                         return true;
  90                 } else if (in_array($arg, array('false', 'no', '0'))) {
  91                         return false;
  92                 } else {
  93                         return $def;
  94                 }
  95         }
  96
  97         function server_error($msg, $code=500) {
  98                 $action = $this->trimmed('action');
  99                 common_debug("Server error '$code' on '$action': $msg", __FILE__);
 100                 common_server_error($msg, $code);
 101         }
 102
 103         function client_error($msg, $code=400) {
 104                 $action = $this->trimmed('action');
 105                 common_debug("User error '$code' on '$action': $msg", __FILE__);
 106                 common_user_error($msg, $code);
 107         }
 108
 109         function self_url() {
 110                 $action = $this->trimmed('action');
 111                 $args = $this->args;
 112                 unset($args['action']);
 113                 foreach (array_keys($_COOKIE) as $cookie) {
 114                         unset($args[$cookie]);
 115                 }
 116                 return common_local_url($action, $args);
 117         }
 118
 119         function nav_menu($menu) {
 120         $action = $this->trimmed('action');
 121         common_element_start('ul', array('id' => 'nav_views'));
 122         foreach ($menu as $menuaction => $menudesc) {
 123             common_menu_item(common_local_url($menuaction, isset($menudesc[2]) ? $menudesc[2] : NULL),
 124                                                          $menudesc[0],
 125                                                          $menudesc[1],
 126                                                          $action == $menuaction);
 127         }
 128         common_element_end('ul');
 129         }
 130 }