feat: 添加获取客户端IP和时间微调功能

Author: huangdijia

src/Functions.php

@@ -13,6 +13,7 @@
 
 use BackedEnum;
 use Carbon\Carbon;
+use Carbon\CarbonInterval;
 use Closure;
 use Countable;
 use DateTimeZone;
@@ -299,6 +300,16 @@ function fluent($value): Fluent
     return new Fluent($value);
 }
 
+/**
+ * Get client IP.
+ */
+function get_client_ip(): string
+{
+    /** @var RequestInterface $request */
+    $request = di(RequestInterface::class);
+    return $request->getHeaderLine('x-real-ip') ?: $request->server('remote_addr');
+}
+
 /**
  * @param string|Stringable $message
  */
@@ -349,6 +360,30 @@ function logs(string $name = 'hyperf', string $group = 'default'): LoggerInterfa
     return di(LoggerFactory::class)->get($name, $group);
 }
 
+/**
+ * Get the current date / time plus the given number of microseconds.
+ */
+function microseconds(int $microseconds): CarbonInterval
+{
+    return CarbonInterval::microseconds($microseconds);
+}
+
+/**
+ * Get the current date / time plus the given number of months.
+ */
+function months(int $months): CarbonInterval
+{
+    return CarbonInterval::months($months);
+}
+
+/**
+ * Get the current date / time plus the given number of milliseconds.
+ */
+function milliseconds(int $milliseconds): CarbonInterval
+{
+    return CarbonInterval::milliseconds($milliseconds);
+}
+
 /**
  * Create a new Carbon instance for the current time.
  *
@@ -624,6 +659,14 @@ function validator(array $data = [], array $rules = [], array $messages = [], ar
     return $factory->make($data, $rules, $messages, $customAttributes);
 }
 
+/**
+ * Get the current date / time plus the given number of weeks.
+ */
+function weeks(int $weeks): CarbonInterval
+{
+    return CarbonInterval::weeks($weeks);
+}
+
 /**
  * @param mixed $expr
  * @param mixed $value
@@ -636,13 +679,3 @@ function when($expr, $value = null, $default = null)
 
     return $result instanceof Closure ? $result($expr) : $result;
 }
-
-/**
- * Get client IP.
- */
-function get_client_ip(): string
-{
-    /** @var RequestInterface $request */
-    $request = di(RequestInterface::class);
-    return $request->getHeaderLine('x-real-ip') ?: $request->server('remote_addr');
-}