Merge pull request #261 from raicabogdan/5.9.x

Update filter api documentation

Author: niden

docs/api/phalcon_filter.md

@@ -55,6 +55,32 @@ Exceptions thrown in Phalcon\Filter will use this class
 
 Lazy loads, stores and exposes sanitizer objects
 
+@method int          absint(mixed $input)
+@method string       alnum(mixed $input)
+@method string       alpha(mixed $input)
+@method bool         bool(mixed $input)
+@method string       email(string $input)
+@method float        float(mixed $input)
+@method int          int(string $input)
+@method string|false ip(string $input, int $filter = FILTER_FLAG_NONE)
+@method string       lower(string $input)
+@method string       lowerfirst(string $input)
+@method mixed        regex(mixed $input, mixed $pattern, mixed $replace)
+@method mixed        remove(mixed $input, mixed $replace)
+@method mixed        replace(mixed $input, mixed $source, mixed $target)
+@method string       special(string $input)
+@method string       specialfull(string $input)
+@method string       string(string $input)
+@method string       stringlegacy(mixed $input)
+@method string       striptags(string $input)
+@method string       trim(string $input)
+@method string       upper(string $input)
+@method string       upperFirst(string $input)
+@method null         upperWords(string $input): strin
+@method null         url(string $input): strin
+
+@property array $mapper
+@property array $services
 
 
 ### Constants
@@ -66,7 +92,7 @@ const FILTER_BOOL = bool;
 const FILTER_EMAIL = email;
 const FILTER_FLOAT = float;
 const FILTER_INT = int;
-const FILTER_IP = 'ip';
+const FILTER_IP = ip;
 const FILTER_LOWER = lower;
 const FILTER_LOWERFIRST = lowerfirst;
 const FILTER_REGEX = regex;
@@ -448,7 +474,7 @@ public function __invoke( mixed $input );
 
 
 
-## Filter\Sanitize\Ip
+## Filter\Sanitize\Ip 
 
 [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Filter/Sanitize/Ip.zep)
 
@@ -458,28 +484,29 @@ public function __invoke( mixed $input );
     - `Phalcon\Filter\Sanitize`
 
 -   __Uses__
-
+    
 
 -   __Extends__
-
+    
 
 -   __Implements__
+    
 
+Phalcon\Filter\Sanitize\IP
 
-Phalcon\Filter\Sanitize\Ip
-
-Sanitizes a value to an IP address or CIDR IP range
+Sanitizes a value to an ip address or CIDR range
 
 
 ### Methods
 
 ```php
-public function __invoke(string input, int filter = 0);
+public function __invoke( string $input, int $filter = int ): string | false;
 ```
 
 
 
 
+
 ## Filter\Sanitize\Lower 
 
 [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Filter/Sanitize/Lower.zep)

docs/api/phalcon_http.md

@@ -720,7 +720,7 @@ private $strictHostCheck = false;
 /**
  * @var array
  */
-private $trustedProxies = [];
+private $trustedProxies;
 
 ```
 
@@ -777,11 +777,11 @@ _SERVER["HTTP_ACCEPT_LANGUAGE"]
 
 
 ```php
-public function getClientAddress( bool $trustForwardedHeader = bool ): string | bool;
+public function getClientAddress( bool $trustForwardedHeader = bool ): string | false;
 ```
-Gets most possible client IPv4 Address. This method searches in
+Gets most possible client IP Address. This method searches in
 `$_SERVER["REMOTE_ADDR"]` and optionally in
-`$_SERVER["HTTP_X_FORWARDED_FOR"]`
+`$_SERVER["HTTP_X_FORWARDED_FOR"]` and returns the first non-private or non-reserved IP address
 
 
 ```php
@@ -837,7 +837,7 @@ Retrieves a query/get value always sanitized with the preset filters
 ```php
 public function getHTTPReferer(): string;
 ```
-Gets web page that refers active request. ie: https://www.google.com
+Gets web page that refers active request. ie: http://www.google.com
 
 
 ```php
@@ -1253,21 +1253,15 @@ of host name or not
 
 
 ```php
-final protected function getBestQuality( array $qualityParts, string $name ): string;
-```
-Process a request header and return the one with best quality
-
-
-```php
-protected function setTrustedProxies(array $trustedProxies): RequestInterface;
+public function setTrustedProxies( array $trustedProxies ): RequestInterface;
 ```
-Set trusted proxy list.
+Set trusted proxy
 
 
 ```php
-protected function isIpAddressInCIDR(string $ip, string $cidr): bool;
+final protected function getBestQuality( array $qualityParts, string $name ): string;
 ```
-Check if an IP address exists in CIDR range.
+Process a request header and return the one with best quality
 
 
 ```php
@@ -1289,6 +1283,12 @@ final protected function hasFileHelper( mixed $data, bool $onlySuccessful ): lon
 Recursively counts file in an array of files
 
 
+```php
+protected function isIpAddressInCIDR( string $ip, string $cidr ): bool;
+```
+Check if an IP address exists in CIDR range
+
+
 ```php
 protected function resolveAuthorizationHeaders(): array;
 ```
@@ -1659,7 +1659,7 @@ $_SERVER["PHP_AUTH_DIGEST"]
 ```php
 public function getHTTPReferer(): string;
 ```
-Gets web page that refers active request. ie: https://www.google.com
+Gets web page that refers active request. ie: http://www.google.com
 
 
 ```php