. */ declare(strict_types=1); namespace FireflyIII\Models; use Carbon\Carbon; use Eloquent; use FireflyIII\Support\Models\ReturnsIntegerIdTrait; use FireflyIII\Support\Models\ReturnsIntegerUserIdTrait; use FireflyIII\User; use Illuminate\Database\Eloquent\Casts\Attribute; use Illuminate\Database\Eloquent\Collection; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\BelongsTo; use Illuminate\Database\Eloquent\Relations\MorphMany; use Illuminate\Database\Eloquent\Relations\MorphTo; use Illuminate\Database\Eloquent\SoftDeletes; use Illuminate\Database\Query\Builder; use Symfony\Component\HttpKernel\Exception\NotFoundHttpException; /** * FireflyIII\Models\Attachment * * @property int $id * @property null|Carbon $created_at * @property null|Carbon $updated_at * @property null|Carbon $deleted_at * @property int $user_id * @property int $attachable_id * @property string $attachable_type * @property bool $file_exists * @property string $md5 * @property string $filename * @property null|string $title * @property null|string $description * @property string $mime * @property int|string $size * @property bool $uploaded * @property string $notes_text * @property \Eloquent|Model $attachable * @property Collection|Note[] $notes * @property null|int $notes_count * @property User $user * * @method static \Illuminate\Database\Eloquent\Builder|Attachment newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Attachment newQuery() * @method static Builder|Attachment onlyTrashed() * @method static \Illuminate\Database\Eloquent\Builder|Attachment query() * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereAttachableId($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereAttachableType($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereCreatedAt($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereDeletedAt($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereDescription($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereFilename($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereId($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereMd5($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereMime($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereSize($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereTitle($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereUpdatedAt($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereUploaded($value) * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereUserId($value) * @method static Builder|Attachment withTrashed() * @method static Builder|Attachment withoutTrashed() * * @property int $user_group_id * * @method static \Illuminate\Database\Eloquent\Builder|Attachment whereUserGroupId($value) * * @mixin Eloquent */ class Attachment extends Model { use ReturnsIntegerIdTrait; use ReturnsIntegerUserIdTrait; use SoftDeletes; protected $casts = [ 'created_at' => 'datetime', 'updated_at' => 'datetime', 'deleted_at' => 'datetime', 'uploaded' => 'boolean', ]; protected $fillable = ['attachable_id', 'attachable_type', 'user_id', 'md5', 'filename', 'mime', 'title', 'description', 'size', 'uploaded']; /** * Route binder. Converts the key in the URL to the specified object (or throw 404). * * @throws NotFoundHttpException */ public static function routeBinder(string $value): self { if (auth()->check()) { $attachmentId = (int)$value; /** @var User $user */ $user = auth()->user(); /** @var null|Attachment $attachment */ $attachment = $user->attachments()->find($attachmentId); if (null !== $attachment) { return $attachment; } } throw new NotFoundHttpException(); } public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get all of the owning attachable models. */ public function attachable(): MorphTo { return $this->morphTo(); } /** * Returns the expected filename for this attachment. */ public function fileName(): string { return sprintf('at-%s.data', (string)$this->id); } /** * Get all the notes. */ public function notes(): MorphMany { return $this->morphMany(Note::class, 'noteable'); } protected function attachableId(): Attribute { return Attribute::make( get: static fn ($value) => (int)$value, ); } }