Servery 0.2.0

Author: nabeghe

README.md

@@ -14,7 +14,7 @@ Includes the following helpers:
 - [Matcher](https://github.com/nabeghe/matcher-php)<small> v1.0.0</small>
 - [Mem](https://github.com/nabeghe/mem-php) <small>v1.2.0</small>
 - [Reflecty](https://github.com/nabeghe/reflecty-php) <small>v0.3.0</small>
-- [Servery](https://github.com/nabeghe/servery-php) <small>v0.1.1</small>
+- [Servery](https://github.com/nabeghe/servery-php) <small>v0.2.0</small>
 - [Shortnum](https://github.com/nabeghe/shortnum-php) <small>v1.0.0</small>
 - [SimpleCipher](https://github.com/nabeghe/simple-cipher-php) <small>v1.0.0</small>
 - [Stringer](https://github.com/nabeghe/stringer-php) <small>v1.1.3</small>

src/Servery/Servery.php

@@ -2,9 +2,64 @@
 
 class Servery
 {
+    /**
+     * Localhost names and IPs.
+     */
+    const LOCAL_HOSTS = ['localhost', '127.0.0.1', '::1'];
+
+    /**
+     * Checks if the current environment is running locally.
+     *
+     * @return bool
+     */
+    public static function isLocalHost(): bool
+    {
+        $remote_addr = $_SERVER['REMOTE_ADDR'] ?? null;
+
+        if (empty($remote_addr) || in_array($remote_addr, static::LOCAL_HOSTS, true)) {
+            return true;
+        }
+
+        $server_name = $_SERVER['SERVER_NAME'] ?? '';
+        $http_host = $_SERVER['HTTP_HOST'] ?? '';
+
+        if (in_array(strtolower($server_name), static::LOCAL_HOSTS, true) || in_array(strtolower($http_host), static::LOCAL_HOSTS, true)) {
+            return true;
+        }
+
+        if (filter_var($remote_addr, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
+            $parts = explode('.', $remote_addr);
+
+            if ($parts[0] === '10') {
+                return true;
+            }
+
+            if ($parts[0] === '172' && $parts[1] >= 16 && $parts[1] <= 31) {
+                return true;
+            }
+
+            if ($parts[0] === '192' && $parts[1] === '168') {
+                return true;
+            }
+        }
+
+        if (strpos($remote_addr, '::1') === 0) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * @return string
+     */
     public static function getWebServer(): string
     {
-        return $_SERVER['SERVER_NAME'] ?? '';
+        if (!empty($_SERVER['SERVER_NAME']) && is_string($_SERVER['SERVER_NAME'])) {
+            return $_SERVER['SERVER_NAME'];
+        }
+
+        return 'localhost';
     }
 
     /**
@@ -149,8 +204,7 @@ public static function getDomain(): string
      */
     public static function isHttps(): bool
     {
-        return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off'
-            || $_SERVER['SERVER_PORT'] == 443);
+        return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off' || $_SERVER['SERVER_PORT'] == 443);
     }
 
     /**
@@ -163,6 +217,7 @@ public static function getUrlProtocol(): string
         if (static::isHttps()) {
             return 'https';
         }
+
         return 'http';
     }
 
@@ -174,9 +229,11 @@ public static function getUrlProtocol(): string
     public static function getServerProtocol(): string
     {
         $protocol = $_SERVER['SERVER_PROTOCOL'] ?? '';
+
         if (!in_array($protocol, ['HTTP/1.1', 'HTTP/2', 'HTTP/2.0', 'HTTP/3'], true)) {
             $protocol = 'HTTP/1.0';
         }
+
         return $protocol;
     }
 
@@ -233,8 +290,10 @@ public static function getRequrestedPath(): ?string
             $path = $_SERVER['SCRIPT_FILENAME'];
             $path = dirname($path);
             $path = rtrim($path, '/');
+
             return $path;
         }
+
         return null;
     }
 
@@ -246,9 +305,11 @@ public static function getRequrestedPath(): ?string
     public static function getHomePath(): string
     {
         $path = static::getRequrestedPath();
+
         if ($path === null) {
             $path = __DIR__.'/../../../..'; // from vendor/nabeghe/servery/src
         }
+
         return $path;
     }
 
@@ -260,18 +321,31 @@ public static function getHomePath(): string
     public static function getHomeUrl(): ?string
     {
         $path = static::getRequrestedPath();
+
         if ($path === null) {
             return null;
         }
+
         $home_url = static::getRootUrl().($path ? "/$path" : '');
+
         return $home_url;
     }
 
+    /**
+     * An alias for {@see UserAgent::$instance()}.
+     *
+     * @return UserAgent
+     */
     public static function getUserAgent(): UserAgent
     {
         return UserAgent::instance();
     }
 
+    /**
+     * An alias for {@see UserAgent::getCurrentReal()}.
+     *
+     * @return string
+     */
     public static function getUserAgentValue(): string
     {
         return UserAgent::getCurrentReal();