Laravel 8中如何实现数值区间优雅映射为对应字符串

在Laravel 8项目开发中，数值区间映射字符串是常见需求，比如用户积分对应等级、订单金额对应优惠档位等场景都需要这类逻辑。传统写法容易出现大量条件判断，不利于后续扩展和维护，我们可以采用更优雅的方式实现。

方案一：配置数组映射

这种方式适合区间规则相对固定、不需要频繁修改的场景，我们把区间规则和对应的字符串维护在配置文件中，后续修改只需要调整配置即可。

首先在config目录下新建score_rank.php配置文件：

<?php
// config/score_rank.php
return [
    // 区间规则，键为区间下限，值为对应字符串，区间左闭右开
    0 => '不及格',
    60 => '及格',
    80 => '良好',
    90 => '优秀',
];

然后编写映射逻辑，遍历配置数组判断数值所在区间：

<?php
namespace AppServices;

use IlluminateSupportFacadesConfig;

class ScoreService
{
    /**
     * 根据分数获取对应等级字符串
     * @param int $score 分数
     * @return string
     */
    public function getRankByScore(int $score): string
    {
        $rankConfig = Config::get('score_rank');
        // 按区间下限倒序排列，方便从大到小匹配
        krsort($rankConfig);
        foreach ($rankConfig as $minScore => $rank) {
            if ($score >= $minScore) {
                return $rank;
            }
        }
        // 兜底返回默认值
        return '无效分数';
    }
}

方案二：自定义辅助函数

如果映射逻辑需要在多个地方复用，可以将逻辑封装为全局辅助函数，调用起来更加方便。

在app/Helpers目录下新建map_helper.php文件：

<?php
// app/Helpers/map_helper.php
if (!function_exists('map_interval_to_string')) {
    /**
     * 数值区间映射字符串辅助函数
     * @param int|float $value 待映射的数值
     * @param array $intervalMap 区间映射数组，格式为[['min'=>最小值,'max'=>最大值,'result'=>对应字符串],...]
     * @param string $default 默认值
     * @return string
     */
    function map_interval_to_string($value, array $intervalMap, string $default = ''): string
    {
        foreach ($intervalMap as $item) {
            // 处理开闭区间，默认左闭右开
            $minCheck = $item['min'] ?? null;
            $maxCheck = $item['max'] ?? null;
            if (is_null($minCheck) && is_null($maxCheck)) {
                continue;
            }
            $match = true;
            if (!is_null($minCheck) && $value < $minCheck) {
                $match = false;
            }
            if (!is_null($maxCheck) && $value >= $maxCheck) {
                $match = false;
            }
            if ($match) {
                return $item['result'];
            }
        }
        return $default;
    }
}

然后在composer.json的autoload节点添加该文件实现自动加载：

{
    "autoload": {
        "files": [
            "app/Helpers/map_helper.php"
        ]
    }
}

执行composer dump-autoload命令后就可以直接调用函数：

<?php
$intervalMap = [
    ['min' => 0, 'max' => 60, 'result' => '不及格'],
    ['min' => 60, 'max' => 80, 'result' => '及格'],
    ['min' => 80, 'max' => 90, 'result' => '良好'],
    ['min' => 90, 'max' => 101, 'result' => '优秀'],
];
$result = map_interval_to_string(85, $intervalMap, '无效分数');
echo $result; // 输出 良好

方案三：枚举类实现

如果Laravel 8项目使用了PHP8.1及以上版本，或者安装了spatie/laravel-enum这类枚举扩展包，可以用枚举类实现，代码语义更清晰，也方便IDE提示。

首先安装枚举扩展包：

composer require spatie/laravel-enum

创建分数等级枚举类：

<?php
namespace AppEnums;

use SpatieEnumEnum;

/**
 * @method static self fail()
 * @method static self pass()
 * @method static self good()
 * @method static self excellent()
 */
class ScoreRankEnum extends Enum
{
    protected static function values(): array
    {
        return [
            'fail' => 0,
            'pass' => 60,
            'good' => 80,
            'excellent' => 90,
        ];
    }

    protected static function labels(): array
    {
        return [
            'fail' => '不及格',
            'pass' => '及格',
            'good' => '良好',
            'excellent' => '优秀',
        ];
    }

    /**
     * 根据分数获取对应枚举实例
     * @param int $score
     * @return static|null
     */
    public static function getByScore(int $score): ?self
    {
        $values = self::values();
        krsort($values);
        foreach ($values as $label => $minScore) {
            if ($score >= $minScore) {
                return self::$label();
            }
        }
        return null;
    }
}

调用方式如下：

<?php
use AppEnumsScoreRankEnum;

$score = 92;
$rankEnum = ScoreRankEnum::getByScore($score);
if ($rankEnum) {
    echo $rankEnum->label; // 输出 优秀
}

方案对比与选择

我们可以根据实际场景选择合适的方案：

实际开发中可以根据项目情况和需求灵活选择，核心目标是减少冗余条件判断，提升代码的可维护性和扩展性。

Laravelmappingintervalstring_conversion修改时间：2026-06-29 16:33:45