OpencachingDeutschland / oc-server3

htdocs/lib/clicompatbase.inc.php

Doc Comments +31 added lines

@@ -76,6 +76,12 @@ 
 // prepare EMail-From
 $emailheaders = 'From: "' . $emailaddr . '" <' . $emailaddr . '>';
 
+/**
+ * @param string $module
+ * @param integer $eventid
+ * @param integer $objectid2
+ * @param string $logtext
+ */
 function logentry($module, $eventid, $userid, $objectid1, $objectid2, $logtext, $details)
 {
     sql(
@@ -148,6 +154,9 @@ 
     return $start;
 }
 
+/**
+ * @return string
+ */
 function escape_javascript($text)
 {
     return str_replace('\'', '\\\'', str_replace('"', '&quot;', $text));
@@ -159,6 +168,9 @@ 
     sql_error();
 }
 
+/**
+ * @param string $sql
+ */
 function sqlValue($sql, $default)
 {
     $rs = sql($sql);
@@ -187,11 +199,21 @@ 
     }
 }
 
+/**
+ * @param string $name
+ * @param string $default
+ *
+ * @return string
+ */
 function getSysConfig($name, $default)
 {
     return sqlValue('SELECT `value` FROM `sysconfig` WHERE `name`=\'' . sql_escape($name) . '\'', $default);
 }
 
+/**
+ * @param string $name
+ * @param string $value
+ */
 function setSysConfig($name, $value)
 {
     if (sqlValue('SELECT COUNT(*) FROM sysconfig WHERE name=\'' . sql_escape($name) . '\'', 0) == 1) {
@@ -516,6 +538,9 @@ 
     die('sql_error');
 }
 
+/**
+ * @param string $warnmessage
+ */
 function sql_warn($warnmessage)
 {
     global $sql_errormail;
@@ -549,6 +574,9 @@ 
     return mysql_fetch_row($rs);
 }
 
+/**
+ * @param resource $rs
+ */
 function sql_fetch_column($rs)
 {
     $col = [];
@@ -758,6 +786,9 @@ 
     ];
 }
 
+/**
+ * @param string $filename
+ */
 function fetch_email_template($filename, $language, $domain)
 {
     global $opt, $rootpath;

htdocs/lib/common.inc.php

Doc Comments +22 added lines

@@ -323,6 +323,9 @@ 
 //set no_eval true to prevent this contents from php-parsing.
 //Important when replacing something that the user has posted
 //in HTML code and could contain \<\? php-Code \?\>
+/**
+ * @param string $name
+ */
 function tpl_set_var($name, $value, $no_eval = true)
 {
     global $vars, $no_eval_vars;
@@ -543,6 +546,9 @@ 
 }
 
 //redirect to another site to display, i.e. to view a cache after logging
+/**
+ * @param string $page
+ */
 function tpl_redirect($page)
 {
     global $absolute_server_URI;
@@ -562,6 +568,9 @@ 
 //process the template replacements
 //no_eval_replace - if true, variables will be replaced that are
 //                  marked as "no_eval"
+/**
+ * @param string $str
+ */
 function tpl_do_replace($str)
 {
     global $vars, $no_eval_vars;
@@ -589,6 +598,10 @@ 
     return $str;
 }
 
+/**
+ * @param string $tplnameError
+ * @param string $msg
+ */
 function tpl_errorMsg($tplnameError, $msg)
 {
     global $tplname;
@@ -617,6 +630,9 @@ 
     textdomain('messages');
 }
 
+/**
+ * @param string $sCode
+ */
 function tpl_do_translation($sCode)
 {
     global $opt, $style, $tplname;
@@ -645,6 +661,9 @@ 
     return $sResultCode;
 }
 
+/**
+ * @param string $sCode
+ */
 function gettext_do_html($sCode)
 {
     $sResultCode = '';
@@ -674,6 +693,9 @@ 
     return $sResultCode;
 }
 
+/**
+ * @return string
+ */
 function t($str)
 {
     global $translate;

htdocs/lib/sqldebugger.inc.php

Doc Comments +3 added lines

@@ -149,6 +149,9 @@
     <?php
 }
 
+/**
+ * @param string $sql
+ */
 function sqldbg_execute($sql, $bSlave)
 {
     global $dblink;

htdocs/lib2/db.inc.php

Doc Comments +60 added lines

@@ -341,6 +341,9 @@ 
     return $result;
 }
 
+/**
+ * @param string $sql
+ */
 function sqlf($sql)
 {
     global $db;
@@ -354,6 +357,9 @@ 
     return $result;
 }
 
+/**
+ * @param string $sql
+ */
 function sqlf_slave($sql)
 {
     global $db;
@@ -367,6 +373,9 @@ 
     return $result;
 }
 
+/**
+ * @param string $sql
+ */
 function sqll($sql)
 {
     global $db;
@@ -380,6 +389,10 @@ 
     return $result;
 }
 
+/**
+ * @param string $sql
+ * @param integer $default
+ */
 function sqlf_value($sql, $default)
 {
     global $db;
@@ -394,6 +407,10 @@ 
     return $result;
 }
 
+/**
+ * @param string $sql
+ * @param integer $default
+ */
 function sqll_value($sql, $default)
 {
     global $db;
@@ -474,6 +491,9 @@ 
     return sql_value_internal(true, $sql, $default, $args);
 }
 
+/**
+ * @param boolean $bQuerySlave
+ */
 function sql_value_internal($bQuerySlave, $sql, $default)
 {
     $args = func_get_args();
@@ -576,6 +596,9 @@ 
     return $retval;
 }
 
+/**
+ * @param resource $rs
+ */
 function sql_fetch_column($rs)
 {
     global $opt;
@@ -625,11 +648,17 @@ 
     return mysql_insert_id($db['dblink_slave']);
 }
 
+/**
+ * @param resource $rs
+ */
 function sql_num_rows($rs)
 {
     return mysql_num_rows($rs);
 }
 
+/**
+ * @param string $table
+ */
 function sql_temp_table($table)
 {
     global $db, $opt;
@@ -659,6 +688,9 @@ 
     $db['temptables'][$table] = $table;
 }
 
+/**
+ * @param string $table
+ */
 function sql_temp_table_slave($table)
 {
     global $db, $opt;
@@ -679,6 +711,9 @@ 
     $db['temptables_slave'][$table] = $table;
 }
 
+/**
+ * @param string $table
+ */
 function sql_drop_temp_table($table)
 {
     global $db, $opt;
@@ -715,6 +750,9 @@ 
     $db['temptables'][$newname] = $newname;
 }
 
+/**
+ * @param string $table
+ */
 function sql_drop_temp_table_slave($table)
 {
     global $db, $opt;
@@ -1079,6 +1117,9 @@ 
     }
 }
 
+/**
+ * @param string $warnmessage
+ */
 function sql_warn($warnmessage)
 {
     global $opt;
@@ -1105,6 +1146,9 @@ 
     }
 }
 
+/**
+ * @param resource $rs
+ */
 function sql_export_recordset($f, $rs, $table, $truncate = true)
 {
     fwrite($f, "SET NAMES 'utf8';\n");
@@ -1135,6 +1179,9 @@ 
     }
 }
 
+/**
+ * @param resource $f
+ */
 function sql_export_table($f, $table)
 {
     $primary = array();
@@ -1156,6 +1203,10 @@ 
     sql_free_result($rs);
 }
 
+/**
+ * @param string $filename
+ * @param string[] $tables
+ */
 function sql_export_tables_to_file($filename, $tables)
 {
     $f = fopen($filename, 'w');
@@ -1183,6 +1234,9 @@ 
     fclose($f);
 }
 
+/**
+ * @param resource $f
+ */
 function sql_export_structure($f, $table)
 {
     $rs = sql("SHOW CREATE TABLE `&1`", $table);
@@ -1198,6 +1252,9 @@ 
     fwrite($f, $sTableSql . " ;\n");
 }
 
+/**
+ * @param string $filename
+ */
 function sql_export_structure_to_file($filename, $table)
 {
     $f = fopen($filename, 'w');
@@ -1271,6 +1328,9 @@ 
 }
 
 // test if a function or procedure exists
+/**
+ * @param string $type
+ */
 function sql_fp_exists($type, $name)
 {
     global $opt;

htdocs/lib2/edithelper.inc.php

Doc Comments +3 added lines

@@ -58,6 +58,9 @@
 //
 // If $wrap is > 0, longer lines will be wrapped to new lines.
 
+/**
+ * @param integer $wrap
+ */
 function html2plaintext($text, $texthtml0, $wrap)
 {
     global $opt, $smiley;

htdocs/lib2/errorhandler.inc.php

Doc Comments +4 added lines

@@ -106,6 +106,10 @@
 // throttle admin error mails;
 // currently used only for SQL errors and warnings
 
+/**
+ * @param string $errortype
+ * @param string $message
+ */
 function admin_errormail($to, $errortype, $message, $headers)
 {
     global $opt;

htdocs/lib2/imagebmp.inc.php

Doc Comments +17 added lines

@@ -26,6 +26,9 @@ 
 *           Returns: if $file specified - true if OK
                      if $file not specified - image data
 */
+/**
+ * @param resource $img
+ */
 function imagebmp($img,$file="",$RLE=0)
 {
 
@@ -463,6 +466,9 @@ 
 
 
 
+/**
+ * @param integer $byte
+ */
 function RetBits($byte,$start,$len)
 {
 $bin=decbin8($byte);
@@ -474,6 +480,10 @@ 
 
 
 $CurrentBit=0;
+/**
+ * @param resource $f
+ * @param integer $count
+ */
 function freadbits($f,$count)
 {
  global $CurrentBit,$SMode;
@@ -505,6 +515,10 @@ 
         {
                 return chr($n & 255).chr(($n >> 8) & 255).chr(($n >> 16) & 255).chr(($n >> 24) & 255);
         }
+
+        /**
+         * @param integer $n
+         */
         function int_to_word($n)
         {
                 return chr($n & 255).chr(($n >> 8) & 255);
@@ -516,6 +530,9 @@ 
 return decbinx($d,8);
 };
 
+/**
+ * @param integer $n
+ */
 function decbinx($d,$n)
 {
 $bin=decbin($d);

Braces +90 added lines, -48 removed lines

@@ -36,7 +36,9 @@ 
 $IsTransparent=$Transparent!=-1;
 
 
-if($IsTransparent) $ColorCount--;
+if($IsTransparent) {
+    $ColorCount--;
+}
 
 if($ColorCount==0) {$ColorCount=0; $BitCount=24;};
 if(($ColorCount>0)and($ColorCount<=2)) {$ColorCount=2; $BitCount=1;};
@@ -49,7 +51,9 @@ 
 
                 $Zbytek=(4-($Width/(8/$BitCount))%4)%4;
 
-                if($BitCount<24) $palsize=pow(2,$BitCount)*4;
+                if($BitCount<24) {
+                    $palsize=pow(2,$BitCount)*4;
+                }
 
                 $size=(floor($Width/(8/$BitCount))+$Zbytek)*$Height+54;
                 $size+=$palsize;
@@ -76,11 +80,15 @@ 
 
                 $CC=$ColorCount;
                 $sl1=strlen($ret);
-                if($CC==0) $CC=256;
+                if($CC==0) {
+                    $CC=256;
+                }
                 if($BitCount<24)
                    {
                     $ColorTotal=imagecolorstotal($img);
-                     if($IsTransparent) $ColorTotal--;
+                     if($IsTransparent) {
+                         $ColorTotal--;
+                     }
 
                      for($p=0;$p<$ColorTotal;$p++)
                      {
@@ -122,12 +130,14 @@ 
   if((strlen($bWrite)<8)and(strlen($bWrite)!=0))
     {
      $sl=strlen($bWrite);
-     for($t=0;$t<8-$sl;$t++)
-      $sl.="0";
+     for($t=0;$t<8-$sl;$t++) {
+           $sl.="0";
+     }
      $retd.=inttobyte(bindec($bWrite));
     };
- for($z=0;$z<$Zbytek;$z++)
-   $retd.=inttobyte(0);
+ for($z=0;$z<$Zbytek;$z++) {
+    $retd.=inttobyte(0);
+ }
  };
 };
 
@@ -135,9 +145,10 @@ 
 {
  for($t=0;$t<strlen($retd);$t+=4)
   {
-   if($t!=0)
-   if(($t)%$Width==0)
+   if($t!=0) {
+      if(($t)%$Width==0)
     $ret.=chr(0).chr(0);
+   }
 
    if(($t+5)%$Width==0)
    {
@@ -148,15 +159,13 @@ 
     {
      $ret.=chr(0).chr(6).substr($retd,$t,6);
      $t+=2;
-    }
-    else
+    } else
     {
      $ret.=chr(0).chr(4).substr($retd,$t,4);
     };
   };
   $ret.=chr(0).chr(1);
-}
-else
+} else
 {
 $ret.=$retd;
 };
@@ -164,8 +173,9 @@ 
 
                 if($BitCount==24)
                 {
-                for($z=0;$z<$Zbytek;$z++)
-                 $Dopl.=chr(0);
+                for($z=0;$z<$Zbytek;$z++) {
+                                 $Dopl.=chr(0);
+                }
 
                 for($y=$Height-1;$y>=0;$y--)
                  {
@@ -185,8 +195,7 @@ 
     $r=$r and fwrite($f,$ret);
     $r=$r and fclose($f);
     return $r;
-   }
-  else
+   } else
   {
    echo $ret;
   };
@@ -259,17 +268,20 @@ 
        imagesetpixel($img,$x,$y,$Palette[$C]);
       };
     if($CurrentBit!=0) {freadbyte($f);};
-    for($g=0;$g<$Zbytek;$g++)
-     freadbyte($f);
+    for($g=0;$g<$Zbytek;$g++) {
+         freadbyte($f);
+    }
      };
 
  };
 };
 
 
-if($RLECompression==1) //$BI_RLE8
+if($RLECompression==1) {
+    //$BI_RLE8
 {
 $y=$Height;
+}
 
 $pocetb=0;
 
@@ -282,9 +294,15 @@ 
 
 $echoit=false;
 
-if($echoit)echo "Prefix: $prefix Suffix: $suffix<BR>";
-if(($prefix==0)and($suffix==1)) break;
-if(feof($f)) break;
+if($echoit) {
+    echo "Prefix: $prefix Suffix: $suffix<BR>";
+}
+if(($prefix==0)and($suffix==1)) {
+    break;
+}
+if(feof($f)) {
+    break;
+}
 
 while(!(($prefix==0)and($suffix==0)))
 {
@@ -298,14 +316,17 @@ 
  if($prefix>0)
   {
    $pocet=$prefix;
-   for($r=0;$r<$pocet;$r++)
-    $Data.=chr($suffix);
+   for($r=0;$r<$pocet;$r++) {
+       $Data.=chr($suffix);
+   }
   };
  $prefix=freadbyte($f);
  $suffix=freadbyte($f);
  $pocetb+=2;
- if($echoit) echo "Prefix: $prefix Suffix: $suffix<BR>";
-};
+ if($echoit) {
+     echo "Prefix: $prefix Suffix: $suffix<BR>";
+ }
+ };
 
 for($x=0;$x<strlen($Data);$x++)
  {
@@ -318,9 +339,11 @@ 
 };
 
 
-if($RLECompression==2) //$BI_RLE4
+if($RLECompression==2) {
+    //$BI_RLE4
 {
 $y=$Height;
+}
 $pocetb=0;
 
 /*while(!feof($f))
@@ -335,9 +358,15 @@ 
 
 $echoit=false;
 
-if($echoit)echo "Prefix: $prefix Suffix: $suffix<BR>";
-if(($prefix==0)and($suffix==1)) break;
-if(feof($f)) break;
+if($echoit) {
+    echo "Prefix: $prefix Suffix: $suffix<BR>";
+}
+if(($prefix==0)and($suffix==1)) {
+    break;
+}
+if(feof($f)) {
+    break;
+}
 
 while(!(($prefix==0)and($suffix==0)))
 {
@@ -346,9 +375,12 @@ 
    $pocet=$suffix;
 
    $CurrentBit=0;
-   for($h=0;$h<$pocet;$h++)
-    $Data.=chr(freadbits($f,4));
-   if($CurrentBit!=0) freadbits($f,4);
+   for($h=0;$h<$pocet;$h++) {
+       $Data.=chr(freadbits($f,4));
+   }
+   if($CurrentBit!=0) {
+       freadbits($f,4);
+   }
    $pocetb+=ceil(($pocet/2));
    if($pocetb%2==1) {freadbyte($f); $pocetb++;};
   };
@@ -361,8 +393,7 @@ 
     if($i%2==0)
      {
       $Data.=chr($suffix%16);
-     }
-     else
+     } else
      {
       $Data.=chr(floor($suffix/16));
      };
@@ -372,8 +403,10 @@ 
  $prefix=freadbyte($f);
  $suffix=freadbyte($f);
  $pocetb+=2;
- if($echoit) echo "Prefix: $prefix Suffix: $suffix<BR>";
-};
+ if($echoit) {
+     echo "Prefix: $prefix Suffix: $suffix<BR>";
+ }
+ };
 
 for($x=0;$x<strlen($Data);$x++)
  {
@@ -399,11 +432,14 @@ 
        $G=freadbyte($f);
        $R=freadbyte($f);
        $color=imagecolorexact($img,$R,$G,$B);
-       if($color==-1) $color=imagecolorallocate($img,$R,$G,$B);
+       if($color==-1) {
+           $color=imagecolorallocate($img,$R,$G,$B);
+       }
        imagesetpixel($img,$x,$y,$color);
       }
-    for($z=0;$z<$Zbytek;$z++)
-     freadbyte($f);
+    for($z=0;$z<$Zbytek;$z++) {
+         freadbyte($f);
+    }
    };
 };
 return $img;
@@ -483,8 +519,7 @@ 
  if($CurrentBit==8)
   {
    $CurrentBit=0;
-  }
- else
+  } else
   {
    fseek($f,ftell($f)-1);
   };
@@ -495,9 +530,15 @@ 
 
 function RGBToHex($Red,$Green,$Blue)
   {
-   $hRed=dechex($Red);if(strlen($hRed)==1) $hRed="0$hRed";
-   $hGreen=dechex($Green);if(strlen($hGreen)==1) $hGreen="0$hGreen";
-   $hBlue=dechex($Blue);if(strlen($hBlue)==1) $hBlue="0$hBlue";
+   $hRed=dechex($Red);if(strlen($hRed)==1) {
+       $hRed="0$hRed";
+   }
+   $hGreen=dechex($Green);if(strlen($hGreen)==1) {
+       $hGreen="0$hGreen";
+   }
+   $hBlue=dechex($Blue);if(strlen($hBlue)==1) {
+       $hBlue="0$hBlue";
+   }
    return($hRed.$hGreen.$hBlue);
   };
 
@@ -520,8 +561,9 @@ 
 {
 $bin=decbin($d);
 $sbin=strlen($bin);
-for($j=0;$j<$n-$sbin;$j++)
+for($j=0;$j<$n-$sbin;$j++) {
  $bin="0$bin";
+}
 return $bin;
 };
 

htdocs/lib2/logic/attribute.class.php

Doc Comments +4 added lines

@@ -23,6 +23,10 @@
         return self::getAttrbutesListArrayInternal($cacheId, false, $firstLetterUppercase);
     }
 
+    /**
+     * @param boolean $bOnlySelectable
+     * @param boolean $firstLetterUppercase
+     */
     public static function getAttrbutesListArrayInternal($cacheId, $bOnlySelectable, $firstLetterUppercase)
     {
         global $opt;

htdocs/lib2/logic/cache.class.php

Doc Comments +3 added lines, -3 removed lines

@@ -411,9 +411,9 @@
     }
 
     /**
-     * @param $cacheId
-     * @param $start
-     * @param $count
+     * @param integer $cacheId
+     * @param integer $start
+     * @param integer $count
      * @param bool $deleted
      * @param bool $protect_old_coords
      *