feat: add more str and url helper methods, add more tests

Author: inhere

src/Str/Traits/StringCaseHelperTrait.php

@@ -286,7 +286,7 @@ public static function nameChange(string $str, bool $toCamelCase = true): string
 
         // 默认 ：下划线式 =>驼峰式
         if ($toCamelCase) {
-            if (strpos($str, '_') === false) {
+            if (!str_contains($str, '_')) {
                 return $str;
             }
 
@@ -304,6 +304,17 @@ public static function nameChange(string $str, bool $toCamelCase = true): string
         return strtolower(preg_replace('/((?<=[a-z])(?=[A-Z]))/', '_', $str));
     }
 
+    /**
+     * @param string $str
+     * @param string $dstCase
+     *
+     * @return string
+     */
+    public static function changeCase(string $str, string $dstCase = 'auto'): string
+    {
+        return $str;
+    }
+
     /**
      * Convert \n and \r\n and \r to <br />
      *

src/Str/Traits/StringCheckHelperTrait.php

@@ -255,14 +255,25 @@ public static function strrpos(string $str, string $find, int $offset = 0, strin
     }
 
     /**
+     * Assert is start withs one
+     *
      * @param string $str
-     * @param string $needle
+     * @param string|array $needle
      *
      * @return bool
      */
-    public static function isStartWiths(string $str, string $needle): bool
+    public static function isStartWiths(string $str, $needle): bool
     {
-        return self::hasPrefix($str, $needle);
+        if (is_array($needle)) {
+            foreach ($needle as $sub) {
+                if (str_starts_with($str, $sub)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+
+        return str_starts_with($str, $needle);
     }
 
     /**
@@ -276,6 +287,17 @@ public static function hasPrefix(string $str, string $needle): bool
         return str_starts_with($str, $needle);
     }
 
+    /**
+     * @param string $str
+     * @param string[] $needles
+     *
+     * @return bool
+     */
+    public static function hasPrefixes(string $str, array $needles): bool
+    {
+        return self::isStartWiths($str, $needles);
+    }
+
     /**
      * @param string $str
      * @param string $needle

src/Str/Traits/StringConvertTrait.php

@@ -10,7 +10,6 @@
 namespace Toolkit\Stdlib\Str\Traits;
 
 use Toolkit\Stdlib\Helper\DataHelper;
-use Toolkit\Stdlib\Str;
 use function array_map;
 use function array_values;
 use function count;
@@ -136,6 +135,20 @@ public static function split2Array(string $str, string $delimiter = ',', int $li
         return self::splitTrimFiltered($str, $delimiter, $limit);
     }
 
+    /**
+     * Like explode, but will trim each item and filter empty item.
+     *
+     * @param string $str
+     * @param string $delimiter
+     * @param int    $limit
+     *
+     * @return array
+     */
+    public static function toTrimFilteredArray(string $str, string $delimiter = ',', int $limit = 0): array
+    {
+        return self::splitTrimFiltered($str, $delimiter, $limit);
+    }
+
     /**
      * Like explode, but will trim each item and filter empty item.
      *
@@ -160,6 +173,20 @@ public static function splitTrimFiltered(string $str, string $delimiter = ',', i
         return array_values(array_filter(array_map('trim', $list), 'strlen'));
     }
 
+    /**
+     * Like explode, but will trim each item.
+     *
+     * @param string $str
+     * @param string $delimiter
+     * @param int $limit
+     *
+     * @return array
+     */
+    public static function toTrimmedArray(string $str, string $delimiter = ',', int $limit = 0): array
+    {
+        return self::splitTrimmed($str, $delimiter, $limit);
+    }
+
     /**
      * Like explode, but will trim each item.
      *
@@ -181,6 +208,28 @@ public static function splitTrimmed(string $str, string $delimiter = ',', int $l
         return array_map('trim', $list);
     }
 
+    /**
+     * @param string $str
+     * @param string $delimiter
+     *
+     * @return array
+     */
+    public static function toTypedArray(string $str, string $delimiter = ','): array
+    {
+        return self::splitTypedList($str, $delimiter);
+    }
+
+    /**
+     * @param string $str
+     * @param string $delimiter
+     *
+     * @return array
+     */
+    public static function toTypedList(string $str, string $delimiter = ','): array
+    {
+        return self::splitTypedList($str, $delimiter);
+    }
+
     /**
      * @param string $str
      * @param string $delimiter

src/Str/UrlHelper.php

@@ -10,6 +10,7 @@
 namespace Toolkit\Stdlib\Str;
 
 use InvalidArgumentException;
+use function implode;
 use function preg_match;
 use function http_build_query;
 use function curl_init;
@@ -47,7 +48,7 @@ class UrlHelper
      */
     public static function isRelative(string $url): bool
     {
-        return false === strpos($url, '//') && strpos($url, '://') === false;
+        return !str_contains($url, '//') && !str_contains($url, '://');
     }
 
     /**
@@ -69,7 +70,7 @@ public static function isUrl(string $str): bool
      */
     public static function isGitUrl(string $str): bool
     {
-        if (strpos($str, 'git@') === 0) {
+        if (str_starts_with($str, 'git@')) {
             $str = 'ssh://' . $str;
         }
 
@@ -99,12 +100,23 @@ public static function isFullUrl(string $url): bool
     }
 
     /**
-     * @param string       $baseUrl
-     * @param array|object $data
+     * @param string $baseUri
+     * @param string ...$paths
      *
      * @return string
      */
-    public static function build(string $baseUrl, $data = null): string
+    public static function joinPath(string $baseUri, string ...$paths): string
+    {
+        return $baseUri . ($paths ? '/' . implode('/', $paths) : '');
+    }
+
+    /**
+     * @param string $baseUrl
+     * @param array $data
+     *
+     * @return string
+     */
+    public static function build(string $baseUrl, array $data = []): string
     {
         if ($data && ($param = http_build_query($data))) {
             if ($baseUrl) {
@@ -154,7 +166,7 @@ public static function canAccessed(string $url): bool
     }
 
     // Build arrays of values we need to decode before parsing
-    protected static $entities = [
+    protected static array $entities = [
         '%21',
         '%2A',
         '%27',
@@ -174,7 +186,7 @@ public static function canAccessed(string $url): bool
         '%5D'
     ];
 
-    protected static $replacements = [
+    protected static array $replacements = [
         '!',
         '*',
         "'",

test/BaseLibTestCase.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace Toolkit\StdlibTest;
+
+use PHPUnit\Framework\TestCase;
+
+/**
+ * class BaseLibTestCase
+ */
+abstract class BaseLibTestCase extends TestCase
+{
+
+}

test/Str/UrlHelperTest.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+namespace Toolkit\StdlibTest\Str;
+
+use Toolkit\Stdlib\Str\UrlHelper;
+use Toolkit\StdlibTest\BaseLibTestCase;
+
+/**
+ * class UrlHelperTest
+ */
+class UrlHelperTest extends BaseLibTestCase
+{
+    public function testJoinPath(): void
+    {
+        $this->assertEquals('a', UrlHelper::joinPath('a'));
+        $this->assertEquals('a/b/cd', UrlHelper::joinPath('a', 'b', 'cd'));
+    }
+}