如何创建自定义toRrule方法处理Laravel模型重复事件数据？

问题a：这种实现方式是否优雅？ #

非常优雅。这种设计完全贴合Laravel的惯用风格——和toArray()、toJson()这类内置集合方法的调用逻辑一致，保持了API的一致性，开发者上手零成本。同时把重复事件展开的逻辑封装起来，让数据转换的细节对调用层透明，符合关注点分离的设计原则，后续维护和修改展开逻辑也只需要在一处调整，非常合理。

问题b：如何创建这个方法，应该在何处定义？ #

需要分两步实现：单个模型的事件展开逻辑，以及集合层面的toRrule()方法。

1. 给单个Presence模型添加事件展开方法

在你的Presence模型中，新增一个方法（比如叫expandToSingleEvents()），负责把当前模型的重复规则转换成单个事件的数组：

// app/Models/Presence.php
public function expandToSingleEvents()
{
    // 这里放用RRule生成单个事件的逻辑，最终返回类似示例中的单条事件数组
    $rrule = new RRule([
        'freq' => constant('RRule::' . $this->frequency),
        'interval' => $this->interval,
        'dtstart' => Carbon::parse($this->start)->toDateTime(),
        'until' => Carbon::parse($this->end)->toDateTime(),
    ]);
    
    return collect($rrule->getOccurrences())->map(function ($date) {
        return [
            'start' => $date->format('Y-m-d'),
            'end' => $date->format('Y-m-d'),
        ];
    })->toArray();
}

2. 给集合添加toRrule()方法

有两种常用方式：

方式一：自定义模型集合（推荐）

创建一个自定义集合类，继承Laravel的Eloquent集合，在里面实现toRrule()方法：

// app/Collections/PresenceCollection.php
namespace App\Collections;

use Illuminate\Database\Eloquent\Collection;

class PresenceCollection extends Collection
{
    public function toRrule()
    {
        return $this->flatMap(function ($presence) {
            return $presence->expandToSingleEvents();
        })->toArray();
    }
}

然后在Presence模型中指定使用这个自定义集合：

// app/Models/Presence.php
use App\Collections\PresenceCollection;

protected $collection = PresenceCollection::class;

这样当你调用Presence::all()时，返回的就是PresenceCollection实例，直接调用->toRrule()就能得到所有展开后的事件列表。

方式二：集合宏（快速实现）

如果不想创建自定义集合类，可以在AppServiceProvider的boot()方法中注册集合宏：

// app/Providers/AppServiceProvider.php
use Illuminate\Support\Collection;

public function boot()
{
    Collection::macro('toRrule', function () {
        return $this->flatMap(function ($item) {
            // 确保集合中的元素是Presence模型
            if (method_exists($item, 'expandToSingleEvents')) {
                return $item->expandToSingleEvents();
            }
            return [];
        })->toArray();
    });
}

这种方式不需要修改模型，任何包含Presence模型的集合都能调用->toRrule()方法，但缺点是全局集合都能访问该方法，可能造成逻辑混淆。

内容的提问来源于stack exchange，提问作者JanBoehmer