misc_pterodactyl-panel/app/Helpers/Utilities.php

<?php

namespace Pterodactyl\Helpers;

use Exception;
use Carbon\Carbon;
use Cron\CronExpression;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\ViewErrorBag;

class Utilities
{
    /**
     * Generates a random string and injects special characters into it, in addition to
     * the randomness of the alpha-numeric default response.
     *
     * @param int $length
     * @return string
     */
    public static function randomStringWithSpecialCharacters(int $length = 16): string
    {
        $string = str_random($length);
        // Given a random string of characters, randomly loop through the characters and replace some
        // with special characters to avoid issues with MySQL password requirements on some servers.
        try {
            for ($i = 0; $i < random_int(2, 6); $i++) {
                $character = ['!', '@', '=', '.', '+', '^'][random_int(0, 5)];

                $string = substr_replace($string, $character, random_int(0, $length - 1), 1);
            }
        } catch (Exception $exception) {
            // Just log the error and hope for the best at this point.
            Log::error($exception);
        }

        return $string;
    }

    /**
     * Converts schedule cron data into a carbon object.
     *
     * @param string $minute
     * @param string $hour
     * @param string $dayOfMonth
     * @param string $dayOfWeek
     * @return \Carbon\Carbon
     */
    public static function getScheduleNextRunDate(string $minute, string $hour, string $dayOfMonth, string $dayOfWeek)
    {
        return Carbon::instance(CronExpression::factory(
            sprintf('%s %s %s * %s', $minute, $hour, $dayOfMonth, $dayOfWeek)
        )->getNextRunDate());
    }
}