class.util.string.php

Go to the documentation of this file.

<?php
/*
 *
 *  * Copyright (c) 2022-2025 Bearsampp
 *  * License: GNU General Public License version 3 or later; see LICENSE.txt
 *  * Website: https://bearsampp.com
 *  * Github: https://github.com/Bearsampp
 *
 */

class UtilString
{
    public static function contains($string, $search)
    {
        if (!empty($string) && !empty($search)) {
            return stripos($string, $search) !== false;
        }
 
        return false;
    }

    public static function startWith($string, $search)
    {
        if ($string === null || $string === '') {
            return false;
        }
 
        return (substr($string, 0, strlen($search)) === $search);
    }

    public static function endWith($string, $search)
    {
        $length = strlen($search);
        $start  = $length * -1;
 
        return (substr($string, $start) === $search);
    }

    public static function isAlphanumeric($string)
    {
        return ctype_alnum($string);
    }

    public static function random($length = 32, $withNumeric = true)
    {
        $characters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
        if ($withNumeric) {
            $characters .= '0123456789';
        }
 
        $charactersLength = strlen($characters);
        $randomString     = '';
 
        try {
            for ($i = 0; $i < $length; $i++) {
                $randomString .= $characters[random_int(0, $charactersLength - 1)];
            }
        } catch (Exception $e) {
            Log::error('Failed to generate cryptographically secure random string: ' . $e->getMessage());
            throw $e;
        }
 
        return $randomString;
    }

    public static function generateSecureToken($length = 32)
    {
        try {
            return bin2hex(random_bytes($length));
        } catch (Exception $e) {
            Log::error('Failed to generate secure token: ' . $e->getMessage());
            throw $e;
        }
    }

    public static function generateSecureBytes($length = 32)
    {
        try {
            return random_bytes($length);
        } catch (Exception $e) {
            Log::error('Failed to generate secure bytes: ' . $e->getMessage());
            throw $e;
        }
    }
}