osCommerce / oscommerce2

catalog/includes/OSC/OM/Registry.php

Doc Comments +6 added lines

@@ -12,6 +12,9 @@ 
 {
     private static $data = [];
 
+    /**
+     * @param string $key
+     */
     public static function get($key)
     {
         if (!static::exists($key)) {
@@ -23,6 +26,9 @@ 
         return static::$data[$key];
     }
 
+    /**
+     * @param string $key
+     */
     public static function set($key, $value, $force = false)
     {
         if (!is_object($value)) {

catalog/includes/classes/category_tree.php

Doc Comments +10 added lines

@@ -54,6 +54,9 @@ 
       }
     }
 
+    /**
+     * @param integer $parent_id
+     */
     protected function _buildBranch($parent_id, $level = 0) {
       $result = ((($level === 0) && ($this->parent_group_apply_to_root === true)) || ($level > 0)) ? $this->parent_group_start_string : null;
 
@@ -278,6 +281,10 @@ 
       $this->parent_end_string = $parent_end_string;
     }
 
+    /**
+     * @param string $parent_group_start_string
+     * @param string $parent_group_end_string
+     */
     function setParentGroupString($parent_group_start_string, $parent_group_end_string, $apply_to_root = false) {
       $this->parent_group_start_string = $parent_group_start_string;
       $this->parent_group_end_string = $parent_group_end_string;
@@ -301,6 +308,9 @@ 
       }
     }
 
+    /**
+     * @param string $spacer_string
+     */
     function setSpacerString($spacer_string, $spacer_multiplier = 2) {
       $this->spacer_string = $spacer_string;
       $this->spacer_multiplier = $spacer_multiplier;

catalog/includes/OSC/OM/FileSystem.php

Doc Comments +3 added lines

@@ -71,6 +71,9 @@
         return $result;
     }
 
+    /**
+     * @param string $pathname
+     */
     public static function displayPath($pathname)
     {
         return str_replace(['/', '\\'], DIRECTORY_SEPARATOR, $pathname);

catalog/includes/OSC/OM/Cache.php

Doc Comments +6 added lines

@@ -50,6 +50,9 @@ 
         return false;
     }
 
+    /**
+     * @param integer $expire
+     */
     public function exists($expire = null)
     {
         $filename = static::$path . $this->key . '.cache';
@@ -139,6 +142,9 @@ 
         return static::$path;
     }
 
+    /**
+     * @param string $key
+     */
     public static function clear($key)
     {
         if (!static::hasSafeName($key)) {

catalog/includes/OSC/OM/HTTP.php

Doc Comments +1 added lines

@@ -37,6 +37,7 @@
 
     /**
      * @param array $parameters url, headers, parameters, method, verify_ssl, cafile, certificate, proxy
+     * @return string
      */
 
     public static function getResponse(array $parameters)

catalog/includes/OSC/OM/Hash.php

Doc Comments +13 added lines

@@ -12,6 +12,9 @@ 
 
 class Hash
 {
+    /**
+     * @param string $plain
+     */
     public static function encrypt($plain, $algo = null)
     {
         if (!isset($algo) || ($algo == 'default') || ($algo == 'bcrypt')) {
@@ -53,6 +56,9 @@ 
         return false;
     }
 
+    /**
+     * @param string $plain
+     */
     public static function verify($plain, $hash)
     {
         $result = false;
@@ -128,6 +134,10 @@ 
         return '';
     }
 
+    /**
+     * @param integer $min
+     * @param integer $max
+     */
     public static function getRandomInt($min = null, $max = null, $secure = true)
     {
         if (!isset($min)) {
@@ -151,6 +161,9 @@ 
         return $result;
     }
 
+    /**
+     * @param integer $length
+     */
     public static function getRandomString($length, $type = 'mixed')
     {
         if (!in_array($type, [

catalog/includes/third_party/PasswordHash.php

Doc Comments +19 added lines

@@ -35,6 +35,10 @@ 
 	var $portable_hashes;
 	var $random_state;
 
+	/**
+	 * @param integer $iteration_count_log2
+	 * @param boolean $portable_hashes
+	 */
 	function __construct($iteration_count_log2, $portable_hashes)
 	{
 		$this->itoa64 = './0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
@@ -50,6 +54,9 @@ 
 			$this->random_state .= getmypid();
 	}
 
+	/**
+	 * @param integer $count
+	 */
 	function get_random_bytes($count)
 	{
 		$output = '';
@@ -84,6 +91,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param integer $count
+	 */
 	function encode64($input, $count)
 	{
 		$output = '';
@@ -107,6 +117,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_private($input)
 	{
 		$output = '$P$';
@@ -155,6 +168,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_extended($input)
 	{
 		$count_log2 = min($this->iteration_count_log2 + 8, 24);
@@ -173,6 +189,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_blowfish($input)
 	{
 		# This one needs to use a different order of characters and a

catalog/admin/includes/functions/general.php

Doc Comments +20 added lines

@@ -221,6 +221,9 @@ 
     return $image;
   }
 
+  /**
+   * @param integer $len
+   */
   function tep_break_string($string, $len, $break_char = '-') {
     $l = 0;
     $output = '';
@@ -333,6 +336,11 @@ 
     return $geo_zone_id;
   }
 
+  /**
+   * @param boolean $html
+   * @param string $boln
+   * @param string $eoln
+   */
   function tep_address_format($address_format_id, $address, $html, $boln, $eoln) {
     $Qaddress = Registry::get('Db')->get('address_format', 'address_format', ['address_format_id' => (int)$address_format_id]);
 
@@ -429,6 +437,9 @@ 
     return $def_state;
   }
 
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     $uprid = $prid;
     if ( (is_array($params)) && (!strstr($prid, '{')) ) {
@@ -729,6 +740,9 @@ 
 
 ////
 // Sets the status of a banner
+  /**
+   * @param integer $status
+   */
   function tep_set_banner_status($banners_id, $status) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -803,6 +817,9 @@ 
 
 ////
 // Sets the status of a product on special
+  /**
+   * @param integer $status
+   */
   function tep_set_specials_status($specials_id, $status) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -1252,6 +1269,9 @@ 
 
 ////
 // Wrapper function for round() for php3 compatibility
+  /**
+   * @return double
+   */
   function tep_round($value, $precision) {
     return round($value, $precision);
   }

catalog/includes/functions/general.php

Doc Comments +14 added lines

@@ -79,6 +79,9 @@ 
 
 ////
 // Break a word in a string if it is longer than a specified length ($len)
+  /**
+   * @param integer $len
+   */
   function tep_break_string($string, $len, $break_char = '-') {
     $l = 0;
     $output = '';
@@ -246,6 +249,9 @@ 
 
 ////
 // Wrapper function for round()
+  /**
+   * @return double
+   */
   function tep_round($number, $precision) {
     if (strpos($number, '.') && (strlen(substr($number, strpos($number, '.')+1)) > $precision)) {
       $number = substr($number, 0, strpos($number, '.') + 1 + $precision + 1);
@@ -425,6 +431,11 @@ 
 ////
 // Return a formatted address
 // TABLES: address_format
+  /**
+   * @param boolean $html
+   * @param string $boln
+   * @param string $eoln
+   */
   function tep_address_format($address_format_id, $address, $html, $boln, $eoln) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -918,6 +929,9 @@ 
 
 ////
 // Return a product ID with attributes
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     if (is_numeric($prid)) {
       $uprid = (int)$prid;