php字符串类

前言

本文将详细介绍如何使用php对字符串的各种操作，并提供整理的源码和通过示例代码进行说明。

示例

\app\common\utils\Str::random();

类

<?php
namespace app\common\utils;
use Overtrue\Pinyin\Pinyin;
/**
 * 字符串类
 * PHP版本：>=7.1
 * 插件：composer require overtrue/pinyin:4.1.0
 */
class Str
{
    protected static $snakeCache = [];
    protected static $camelCache = [];
    protected static $studlyCache = [];

    /**
     * 获取指定长度的随机字母数字组合的字符串
     *
     * @param  int $length
     * @param  int $type
     * @param  string $addChars
     * @return string
     */
    public static function random(int $length = 6, int $type = null, string $addChars = ''): string
    {
        $str = '';
        switch ($type) {
            case 0:
                $chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz' . $addChars;
                break;
            case 1:
                $chars = str_repeat('0123456789', 3);
                break;
            case 2:
                $chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' . $addChars;
                break;
            case 3:
                $chars = 'abcdefghijklmnopqrstuvwxyz' . $addChars;
                break;
            case 4:
                $chars = "们以我到他会作时要动国产的一是工就年阶义发成部民可出能方进在了不和有大这主中人上为来分生对于学下级地个用同行面说种过命度革而多子后自社加小机也经力线本电高量长党得实家定深法表着水理化争现所二起政三好十战无农使性前等反体合斗路图把结第里正新开论之物从当两些还天资事队批点育重其思与间内去因件日利相由压员气业代全组数果期导平各基或月毛然如应形想制心样干都向变关问比展那它最及外没看治提五解系林者米群头意只明四道马认次文通但条较克又公孔领军流入接席位情运器并飞原油放立题质指建区验活众很教决特此常石强极土少已根共直团统式转别造切九你取西持总料连任志观调七么山程百报更见必真保热委手改管处己将修支识病象几先老光专什六型具示复安带每东增则完风回南广劳轮科北打积车计给节做务被整联步类集号列温装即毫知轴研单色坚据速防史拉世设达尔场织历花受求传口断况采精金界品判参层止边清至万确究书" . $addChars;
                break;
            default:
                $chars = 'ABCDEFGHIJKMNPQRSTUVWXYZabcdefghijkmnpqrstuvwxyz23456789' . $addChars;
                break;
        }
        if ($length > 10) {
            $chars = $type == 1 ? str_repeat($chars, $length) : str_repeat($chars, 5);
        }
        if ($type != 4) {
            $chars = str_shuffle($chars);
            $str = substr($chars, 0, $length);
        } else {
            for ($i = 0; $i < $length; $i++) {
                $str .= mb_substr($chars, floor(mt_rand(0, mb_strlen($chars, 'utf-8') - 1)), 1);
            }
        }
        return $str;
    }

    /**
     * 字符串转小写
     *
     * @param  string $value
     * @return string
     */
    public static function lower(string $value): string
    {
        return mb_strtolower($value, 'UTF-8');
    }

    /**
     * 字符串转大写
     *
     * @param  string $value
     * @return string
     */
    public static function upper(string $value): string
    {
        return mb_strtoupper($value, 'UTF-8');
    }

    /**
     * 获取字符串的长度
     *
     * @param  string $value
     * @return int
     */
    public static function length(string $value): int
    {
        return mb_strlen($value);
    }

    /**
     * 截取字符串
     *
     * @param  string   $string
     * @param  int      $start
     * @param  int|null $length
     * @return string
     */
    public static function substr(string $string, int $start, int $length = null): string
    {
        return mb_substr($string, $start, $length, 'UTF-8');
    }

    /**
     * 驼峰转下划线
     *
     * @param  string $value
     * @param  string $delimiter
     * @return string
     */
    public static function snake(string $value, string $delimiter = '_'): string
    {
        $key = $value;

        if (isset(static::$snakeCache[$key][$delimiter])) {
            return static::$snakeCache[$key][$delimiter];
        }

        if (!ctype_lower($value)) {
            $value = preg_replace('/\s+/u', '', ucwords($value));

            $value = static::lower(preg_replace('/(.)(?=[A-Z])/u', '$1' . $delimiter, $value));
        }

        return static::$snakeCache[$key][$delimiter] = $value;
    }

    /**
     * 下划线转驼峰(首字母小写)
     *
     * @param  string $value
     * @return string
     */
    public static function camel(string $value): string
    {
        if (isset(static::$camelCache[$value])) {
            return static::$camelCache[$value];
        }

        return static::$camelCache[$value] = lcfirst(static::studly($value));
    }

    /**
     * 下划线转驼峰(首字母大写)
     *
     * @param  string $value
     * @return string
     */
    public static function studly(string $value): string
    {
        $key = $value;

        if (isset(static::$studlyCache[$key])) {
            return static::$studlyCache[$key];
        }

        $value = ucwords(str_replace(['-', '_'], ' ', $value));

        return static::$studlyCache[$key] = str_replace(' ', '', $value);
    }

    /**
     * 转为首字母大写的标题格式
     *
     * @param  string $value
     * @return string
     */
    public static function title(string $value): string
    {
        return mb_convert_case($value, MB_CASE_TITLE, 'UTF-8');
    }

    /**
     * 姓名拆分成姓和名
     * @param $full_name
     * @return array
     */
    public static function splitName($full_name) {
        $hyphenated = array('欧阳','太史','端木','上官','司马','东方','独孤','南宫','万俟','闻人','夏侯','诸葛','尉迟','公羊','赫连','澹台','皇甫',
            '宗政','濮阳','公冶','太叔','申屠','公孙','慕容','仲孙','钟离','长孙','宇文','城池','司徒','鲜于','司空','汝嫣','闾丘','子车','亓官',
            '司寇','巫马','公西','颛孙','壤驷','公良','漆雕','乐正','宰父','谷梁','拓跋','夹谷','轩辕','令狐','段干','百里','呼延','东郭','南门',
            '羊舌','微生','公户','公玉','公仪','梁丘','公仲','公上','公门','公山','公坚','左丘','公伯','西门','公祖','第五','公乘','贯丘','公皙',
            '南荣','东里','东宫','仲长','子书','子桑','即墨','达奚','褚师');
        $vLength = mb_strlen($full_name, 'utf-8');
        $surname = '';
        $name = '';
        if($vLength > 2){
            $preTwoWords = mb_substr($full_name, 0, 2, 'utf-8');
            if(in_array($preTwoWords, $hyphenated)){
                $surname = $preTwoWords;
                $name = mb_substr($full_name, 2, 10, 'utf-8');
            }else{
                $surname = mb_substr($full_name, 0, 1, 'utf-8');
                $name = mb_substr($full_name, 1, 10, 'utf-8');
            }
        }else if($vLength == 2){
            $surname = mb_substr($full_name ,0, 1, 'utf-8');
            $name = mb_substr($full_name, 1, 10, 'utf-8');
        }else{
            $surname = $full_name;
        }
        return compact('surname', 'name');
    }

    /**
     * 完整地址拆分
     * @param $address
     * @return array
     */
    public static function splitAddress($address)
    {
        preg_match('/(.*?(省|自治区|北京市|天津市|上海市|重庆市|澳门特别行政区|香港特别行政区))/', $address, $matches);
        if (count($matches) > 1) {
            $province = $matches[count($matches) - 2];
            $address = preg_replace('/(.*?(省|自治区|北京市|天津市|上海市|重庆市|澳门特别行政区|香港特别行政区))/','', $address, 1);
        }
        preg_match('/(.*?(市|自治州|地区|区划|县))/', $address, $matches);
        if (count($matches) > 1) {
            $city = $matches[count($matches) - 2];
            $address = str_replace($city, '', $address);
        }
        preg_match('/(.*?(区|县|镇|乡|街道))/', $address, $matches);
        if (count($matches) > 1) {
            $area = $matches[count($matches) - 2];
            $address = str_replace($area, '', $address);
        }
        return [
            'province' => isset($province) ? $province : '',
            'city' => isset($city) ? $city : '',
            'district' => isset($area) ? $area : '',
            "address" => $address
        ];
    }

    /**
     * 字符串私密
     * @param $str
     * @param $start
     * @param $length
     * @return array|string|string[]
     */
    public static function privacy($str,$start=0,$length=0)
    {
        $str_len = self::length($str);
        $hide = '';
        if ($start==0 && $length ==0) {
            for ($i=0;$i<self::length($str);$i++) $hide.='*';
        }
        else if ($start && $length ==0) {
            $hide = self::substr($str,0,$start);
            for ($i=0;$i<self::length(self::substr($str,$start,$str_len-self::length($hide)));$i++) $hide.= '*';
        }
        else {
            for ($i=0;$i<self::length(self::substr($str,$start,$length));$i++) $hide.= '*';
            $hide = substr_replace($str,$hide,$start,$length);
        }
        return $hide;
    }

    /**
     * 字符串第一个字首字母
     * @param $str
     * @param $default
     * @return mixed|string
     */
    public static function firstLetter($str,$default = '#')
    {
        $pinyin = new Pinyin();
        $first_str = mb_substr($str,0,1, 'UTF-8');
        $first = $pinyin->abbr($first_str);
        if (!$first && preg_match("/^[A-Za-z]/",$first_str)) {
            $first = $first_str;
        }
        $initial = strtoupper($first);
        return $initial ?: $default;
    }

    /**
     * 字符串前/后填补
     * @param $str
     * @param $pad_length
     * @param $pad_string
     * @param $pad_type
     * @return string
     */
    public static function pad($str,$pad_length = 2,$pad_string = "0",$pad_type = STR_PAD_LEFT)
    {
        return str_pad($str,$pad_length,$pad_string,$pad_type);
    }

    /**
     * 过滤字符串中所有空格
     * @param $str
     * @return array|string|string[]
     */
    public static function trimall($str)
    {
        $match = array(" ","　","\t","\n","\r");
        return str_replace($match,'',$str);
    }

    /**
     * 生成订单编号
     * @param $pre
     * @return string
     */
    public static function orderSn($pre = 'Y')
    {
        return $pre.date('YmdHis') . substr(implode(NULL, array_map('ord', str_split(substr(uniqid(), 7, 13), 1))), 0, 8);
    }

    /**
     * 密码加密
     * @param $str
     * @param $salt
     * @return string
     */
    public static function encrypt($str,$salt='')
    {
        $salt  = $salt=='' ?  'ENCRYPT_COM' : $salt;
        return md5(md5($str) . $salt);
    }

    /**
     * 随机数字
     * @param $length
     * @return string
     */
    public static function number($length = 4)
    {
        return substr(str_shuffle('123456789123456789123456789123456789'),1,$length);
    }

    /**
     * 唯一值
     * @return string
     */
    public static function guid()
    {
        $str = md5(uniqid(md5(microtime(true)),true));
        $str = md5(sha1($str));
        return $str;
    }

    /**
     * 字符串编码转成UTF-8
     * @param $str
     * @return array|false|mixed|string|string[]|null
     */
    public static function toUtf8($str)
    {
        $from_chr = mb_detect_encoding ( $str, array (
            'UTF-8',
            'ASCII',
            'EUC-CN',
            'CP936',
            'BIG-5',
            'GB2312',
            'GBK'
        ) );
        if ($from_chr != "UTF-8") {
            $str = mb_convert_encoding ( $str, 'UTF-8', array (
                'UTF-8',
                'ASCII',
                'EUC-CN',
                'CP936',
                'BIG-5',
                'GB2312',
                'GBK'
            ) );
        }
        return $str;
    }

}