Eloquent 中实现条件字段选择与搜索：告别原始 SQL 的优雅之道

// app/Models/Activity.php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Activity extends Model
{
    use HasFactory;

    /**
     * 获取活动的统一标题 (coolTitle)。
     * 如果 title 存在且非空，则使用 title；否则使用 original_title。
     *
     * @return string|null
     */
    public function getCoolTitleAttribute(): ?string
    {
        // 这里的 'title' 和 'original_title' 是模型实例的属性
        // 可以根据实际情况判断空字符串或 null
        return $this->attributes['title'] ?? $this->attributes['original_title'];
        // 或者更严格的空字符串检查：
        // return !empty($this->attributes['title']) ? $this->attributes['title'] : $this->attributes['original_title'];
    }

    /**
     * 如果希望在模型序列化为 JSON 时自动包含此属性，
     * 可以将其添加到 $appends 数组中。
     *
     * @var array
     */
    protected $appends = ['cool_title'];
}

$activity = Activity::find(1);

// 访问 coolTitle 属性
echo $activity->cool_title; // 会自动调用 getCoolTitleAttribute 方法

// 如果查询结果是集合
$activities = Activity::all();
foreach ($activities as $activity) {
    echo $activity->cool_title . "\n";
}

// 当模型被序列化为 JSON 时（例如在 API 响应中），
// 如果 $appends 数组中包含了 'cool_title'，它也会被自动包含。
return response()->json($activity);

use Illuminate\Support\Facades\DB;
use App\Models\Activity;

// 假设我们正在查询 Activity 模型
$activities = Activity::addSelect([
    'id', // 选择其他需要的字段
    'title',
    'original_title',
    DB::raw('(CASE WHEN title IS NULL OR title = "" THEN original_title ELSE title END) as coolTitle')
])->get();

foreach ($activities as $activity) {
    echo "ID: {$activity->id}, Title: {$activity->title}, Original Title: {$activity->original_title}, Cool Title: {$activity->coolTitle}\n";
}

// 使用 COALESCE，它会返回第一个非 NULL 的表达式
// 如果 title 可能为空字符串但不是 NULL，则需要更复杂的逻辑
$activities = Activity::addSelect([
    'id',
    'title',
    'original_title',
    DB::raw('COALESCE(NULLIF(title, ""), original_title) as coolTitle')
])->get();
// NULLIF(title, "") 会将空字符串的 title 转换为 NULL，
// 然后 COALESCE 就可以处理 NULL 和 original_title。

// 如果只需要处理 NULL 值，COALESCE 足够
$activities = Activity::addSelect([
    'id',
    'title',
    'original_title',
    DB::raw('COALESCE(title, original_title) as coolTitle')
])->get();

use App\Models\Activity;

$search = 'some keyword';

$activities = Activity::where(function ($query) use ($search) {
    // 检查 title 是否不为空且匹配搜索词
    $query->whereNotNull('title')
          ->where('title', 'like', '%' . $search . '%');
})->orWhere(function ($query) use ($search) {
    // 或者 original_title 匹配搜索词
    $query->where('original_title', 'like', '%' . $search . '%');
})->get();

use Illuminate\Support\Facades\DB;
use App\Models\Activity;

$search = 'some keyword';

$activities = Activity::where(function ($query) use ($search) {
    // 如果 title 不为空，则搜索 title
    $query->whereNotNull('title')
          ->where('title', 'like', '%' . $search . '%');
})->orWhere(function ($query) use ($search) {
    // 如果 title 为空（或 null），则搜索 original_title
    $query->where(function ($subQuery) {
        $subQuery->whereNull('title')->orWhere('title', ''); // 检查 title 为 null 或空字符串
    })->where('original_title', 'like', '%' . $search . '%');
})->get();