@@ -22,6 +22,10 @@ |
||
22 | 22 | * @author Chirag Shah <[email protected]> |
23 | 23 | */ |
24 | 24 | class Google_Utils { |
25 | + |
|
26 | + /** |
|
27 | + * @param string $data |
|
28 | + */ |
|
25 | 29 | public static function urlSafeB64Encode($data) { |
26 | 30 | $b64 = base64_encode($data); |
27 | 31 | $b64 = str_replace(array('+', '/', '\r', '\n', '='), |
@@ -135,6 +135,9 @@ discard block |
||
135 | 135 | } |
136 | 136 | } |
137 | 137 | |
138 | + /** |
|
139 | + * @param integer $name |
|
140 | + */ |
|
138 | 141 | Function CookieEncode($value, $name) |
139 | 142 | { |
140 | 143 | return($name ? str_replace("=", "%25", $value) : str_replace(";", "%3B", $value)); |
@@ -146,6 +149,10 @@ discard block |
||
146 | 149 | return($this->error=$error); |
147 | 150 | } |
148 | 151 | |
152 | + /** |
|
153 | + * @param string $error |
|
154 | + * @param integer $error_code |
|
155 | + */ |
|
149 | 156 | Function SetPHPError($error, &$php_error_message, $error_code = HTTP_CLIENT_ERROR_UNSPECIFIED_ERROR) |
150 | 157 | { |
151 | 158 | if(IsSet($php_error_message) |
@@ -154,6 +161,9 @@ discard block |
||
154 | 161 | return($this->SetError($error, $error_code)); |
155 | 162 | } |
156 | 163 | |
164 | + /** |
|
165 | + * @param string $error |
|
166 | + */ |
|
157 | 167 | Function SetDataAccessError($error,$check_connection=0) |
158 | 168 | { |
159 | 169 | $this->error=$error; |
@@ -264,6 +274,9 @@ discard block |
||
264 | 274 | return(1); |
265 | 275 | } |
266 | 276 | |
277 | + /** |
|
278 | + * @return string |
|
279 | + */ |
|
267 | 280 | Function ReadChunkSize() |
268 | 281 | { |
269 | 282 | if($this->remaining_chunk==0) |
@@ -289,6 +302,9 @@ discard block |
||
289 | 302 | return(""); |
290 | 303 | } |
291 | 304 | |
305 | + /** |
|
306 | + * @return string |
|
307 | + */ |
|
292 | 308 | Function ReadBytes($length) |
293 | 309 | { |
294 | 310 | if($this->use_curl) |
@@ -367,6 +383,9 @@ discard block |
||
367 | 383 | return(feof($this->connection)); |
368 | 384 | } |
369 | 385 | |
386 | + /** |
|
387 | + * @param string $server_type |
|
388 | + */ |
|
370 | 389 | Function Resolve($domain, &$ip, $server_type) |
371 | 390 | { |
372 | 391 | if(preg_match('/^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$/',$domain)) |
@@ -385,6 +404,9 @@ discard block |
||
385 | 404 | return(''); |
386 | 405 | } |
387 | 406 | |
407 | + /** |
|
408 | + * @param boolean $ssl |
|
409 | + */ |
|
388 | 410 | Function Connect($host_name, $host_port, $ssl, $server_type = 'HTTP') |
389 | 411 | { |
390 | 412 | $domain=$host_name; |
@@ -569,6 +591,9 @@ discard block |
||
569 | 591 | |
570 | 592 | /* Public methods */ |
571 | 593 | |
594 | + /** |
|
595 | + * @return string |
|
596 | + */ |
|
572 | 597 | Function GetRequestArguments($url, &$arguments) |
573 | 598 | { |
574 | 599 | $this->error = ''; |
@@ -767,6 +792,9 @@ discard block |
||
767 | 792 | return($this->Disconnect()); |
768 | 793 | } |
769 | 794 | |
795 | + /** |
|
796 | + * @param integer $secure |
|
797 | + */ |
|
770 | 798 | Function PickCookies(&$cookies,$secure) |
771 | 799 | { |
772 | 800 | if(IsSet($this->cookies[$secure])) |
@@ -1439,6 +1467,11 @@ discard block |
||
1439 | 1467 | return(""); |
1440 | 1468 | } |
1441 | 1469 | |
1470 | + /** |
|
1471 | + * @param string $name |
|
1472 | + * |
|
1473 | + * @return string |
|
1474 | + */ |
|
1442 | 1475 | Function SetCookie($name, $value, $expires="" , $path="/" , $domain="" , $secure=0, $verbatim=0) |
1443 | 1476 | { |
1444 | 1477 | if(strlen($this->error)) |
@@ -1677,6 +1710,9 @@ discard block |
||
1677 | 1710 | return(""); |
1678 | 1711 | } |
1679 | 1712 | |
1713 | + /** |
|
1714 | + * @param integer $proxy |
|
1715 | + */ |
|
1680 | 1716 | Function Authenticate(&$headers, $proxy, &$proxy_authorization, &$user, &$password, &$realm, &$workstation) |
1681 | 1717 | { |
1682 | 1718 | if($proxy) |
@@ -1937,6 +1973,9 @@ discard block |
||
1937 | 1973 | return(""); |
1938 | 1974 | } |
1939 | 1975 | |
1976 | + /** |
|
1977 | + * @param integer $length |
|
1978 | + */ |
|
1940 | 1979 | Function ReadReplyBody(&$body,$length) |
1941 | 1980 | { |
1942 | 1981 | $body=""; |
@@ -1979,6 +2018,9 @@ discard block |
||
1979 | 2018 | return(""); |
1980 | 2019 | } |
1981 | 2020 | |
2021 | + /** |
|
2022 | + * @return string |
|
2023 | + */ |
|
1982 | 2024 | Function ReadWholeReplyBody(&$body) |
1983 | 2025 | { |
1984 | 2026 | $body = ''; |
@@ -596,6 +596,9 @@ discard block |
||
596 | 596 | return(false); |
597 | 597 | } |
598 | 598 | |
599 | + /** |
|
600 | + * @param string $error |
|
601 | + */ |
|
599 | 602 | Function SetPHPError($error, &$php_error_message) |
600 | 603 | { |
601 | 604 | if(IsSet($php_error_message) |
@@ -604,6 +607,9 @@ discard block |
||
604 | 607 | return($this->SetError($error)); |
605 | 608 | } |
606 | 609 | |
610 | + /** |
|
611 | + * @param string $message |
|
612 | + */ |
|
607 | 613 | Function OutputDebug($message) |
608 | 614 | { |
609 | 615 | if($this->debug) |
@@ -655,6 +661,9 @@ discard block |
||
655 | 661 | return(true); |
656 | 662 | } |
657 | 663 | |
664 | + /** |
|
665 | + * @param string $error |
|
666 | + */ |
|
658 | 667 | Function GetRequestError(&$error) |
659 | 668 | { |
660 | 669 | $error = (IsSet($_GET['error']) ? $_GET['error'] : null); |
@@ -849,6 +858,11 @@ discard block |
||
849 | 858 | return $array; |
850 | 859 | } |
851 | 860 | |
861 | + /** |
|
862 | + * @param string $function |
|
863 | + * @param string $data |
|
864 | + * @param string $key |
|
865 | + */ |
|
852 | 866 | Function HMAC($function, $data, $key) |
853 | 867 | { |
854 | 868 | switch($function) |
@@ -1146,6 +1160,10 @@ discard block |
||
1146 | 1160 | <do> |
1147 | 1161 | {/metadocument} |
1148 | 1162 | */ |
1163 | + /** |
|
1164 | + * @param string $url |
|
1165 | + * @param string $method |
|
1166 | + */ |
|
1149 | 1167 | Function CallAPI($url, $method, $parameters, $options, &$response) |
1150 | 1168 | { |
1151 | 1169 | if(!IsSet($options['Resource'])) |
@@ -1735,6 +1753,9 @@ discard block |
||
1735 | 1753 | <do> |
1736 | 1754 | {/metadocument} |
1737 | 1755 | */ |
1756 | + /** |
|
1757 | + * @param boolean $success |
|
1758 | + */ |
|
1738 | 1759 | Function Finalize($success) |
1739 | 1760 | { |
1740 | 1761 | return($success); |
@@ -107,7 +107,7 @@ discard block |
||
107 | 107 | * Generates a random OAuth nonce. |
108 | 108 | * If 'force_nonce' is true a nonce is not generated and the value in the configuration will be retained. |
109 | 109 | * |
110 | - * @param string $length how many characters the nonce should be before MD5 hashing. default 12 |
|
110 | + * @param integer $length how many characters the nonce should be before MD5 hashing. default 12 |
|
111 | 111 | * @param string $include_time whether to include time at the beginning of the nonce. default true |
112 | 112 | * @return void |
113 | 113 | */ |
@@ -502,7 +502,7 @@ discard block |
||
502 | 502 | * |
503 | 503 | * @param object $ch curl handle |
504 | 504 | * @param string $header the response headers |
505 | - * @return the string length of the header |
|
505 | + * @return integer string length of the header |
|
506 | 506 | */ |
507 | 507 | private function curlHeader($ch, $header) { |
508 | 508 | $this->response['raw'] .= $header; |
@@ -212,7 +212,7 @@ discard block |
||
212 | 212 | * Asks the user for input and returns the line they enter |
213 | 213 | * |
214 | 214 | * @param string $prompt the text to display to the user |
215 | - * @return the text entered by the user |
|
215 | + * @return string text entered by the user |
|
216 | 216 | */ |
217 | 217 | public static function read_input($prompt) { |
218 | 218 | echo $prompt; |
@@ -267,7 +267,7 @@ discard block |
||
267 | 267 | * |
268 | 268 | * @param string $haystack the string to check inside of |
269 | 269 | * @param string $needle the string to check $haystack ends with |
270 | - * @return true if $haystack ends with $needle, false otherwise |
|
270 | + * @return boolean if $haystack ends with $needle, false otherwise |
|
271 | 271 | */ |
272 | 272 | public static function endswith($haystack, $needle) { |
273 | 273 | $haylen = strlen($haystack); |
@@ -26,7 +26,7 @@ |
||
26 | 26 | * @param \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty $data |
27 | 27 | * @param string $variable the stream of the variable |
28 | 28 | * |
29 | - * @return mixed |
|
29 | + * @return string|null |
|
30 | 30 | * @throws \SmartyException |
31 | 31 | */ |
32 | 32 | public function getStreamVariable(Smarty_Internal_Data $data, $variable) |
@@ -115,7 +115,7 @@ |
||
115 | 115 | * @param string $file |
116 | 116 | * @param \Smarty $smarty |
117 | 117 | * |
118 | - * @return bool|string full filepath or false |
|
118 | + * @return string|false full filepath or false |
|
119 | 119 | * |
120 | 120 | */ |
121 | 121 | public function getIncludePath($dirs, $file, Smarty $smarty) |
@@ -76,7 +76,7 @@ |
||
76 | 76 | * |
77 | 77 | * @param \Smarty_Template_Cached $cached |
78 | 78 | * @param \Smarty_Internal_Template $_template |
79 | - * @param $no_output_filter |
|
79 | + * @param boolean $no_output_filter |
|
80 | 80 | * |
81 | 81 | * @throws \Exception |
82 | 82 | */ |
@@ -79,7 +79,7 @@ |
||
79 | 79 | * @param mixed $_content template source |
80 | 80 | * @param bool $isTemplateSource |
81 | 81 | * |
82 | - * @return bool true if compiling succeeded, false if it failed |
|
82 | + * @return string true if compiling succeeded, false if it failed |
|
83 | 83 | * @throws \SmartyCompilerException |
84 | 84 | */ |
85 | 85 | protected function doCompile($_content, $isTemplateSource = false) |