Page MenuHomePhorge
Files F120837738

Item.php
No OneTemporary
Actions

Authored By
Unknown
Size
5 KB
Referenced Files
None
Subscribers
None

Item.php
View Options

<?php
namespace App\Fs;
use App\Traits\BelongsToUserTrait;
use App\Traits\UuidStrKeyTrait;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\SoftDeletes;
/**
* The eloquent definition of a filesystem item.
*
* @property string $id Item identifier
* @property int $type Item type
* @property string $path Item path (readonly)
* @property int $user_id Item owner
*/
class Item extends Model
{
use BelongsToUserTrait;
use SoftDeletes;
use UuidStrKeyTrait;
public const TYPE_FILE = 1;
public const TYPE_COLLECTION = 2;
public const TYPE_INCOMPLETE = 4;
/** @var list<string> The attributes that are mass assignable */
protected $fillable = ['user_id', 'type'];
/** @var array<string, string> The attributes that should be cast */
protected $casts = [
'created_at' => 'datetime:Y-m-d H:i:s',
'updated_at' => 'datetime:Y-m-d H:i:s',
];
/** @var string Database table name */
protected $table = 'fs_items';
/**
* Content chunks of this item (file).
*
* @return HasMany<Chunk, $this>
*/
public function chunks()
{
return $this->hasMany(Chunk::class);
}
/**
* Getter for the file path (without the filename) in the storage.
*/
protected function path(): Attribute
{
return Attribute::make(
get: function ($value) {
if (empty($this->id)) {
throw new \Exception("Cannot get path for an item without ID");
}
$id = substr($this->id, 0, 6);
return implode('/', str_split($id, 2));
}
);
}
/**
* Any (additional) properties of this item.
*
* @return HasMany<Property, $this>
*/
public function properties()
{
return $this->hasMany(Property::class);
}
/**
* Obtain the value for an item property
*
* @param string $key Property name
* @param mixed $default Default value, to be used if not found
*
* @return string|null Property value
*/
public function getProperty(string $key, $default = null)
{
$attr = $this->properties()->where('key', $key)->first();
return $attr ? $attr->value : $default;
}
/**
* Obtain the values for many properties in one go (for better performance).
*
* @param array $keys Property names
*
* @return array Property key=value hash, includes also requested but non-existing properties
*/
public function getProperties(array $keys): array
{
$props = array_fill_keys($keys, null);
$this->properties()->whereIn('key', $keys)->get()
->each(static function ($prop) use (&$props) {
$props[$prop->key] = $prop->value;
});
return $props;
}
/**
* Remove a property
*
* @param string $key Property name
*/
public function removeProperty(string $key): void
{
$this->setProperty($key, null);
}
/**
* Create or update a property.
*
* @param string $key Property name
* @param string|null $value The new value for the property
*/
public function setProperty(string $key, $value): void
{
$this->storeProperty($key, $value);
}
/**
* Create or update multiple properties in one fell swoop.
*
* @param array $data an associative array of key value pairs
*/
public function setProperties(array $data = []): void
{
foreach ($data as $key => $value) {
$this->storeProperty($key, $value);
}
}
/**
* Create or update a property.
*
* @param string $key Property name
* @param string|null $value The new value for the property
*/
private function storeProperty(string $key, $value): void
{
if ($value === null || $value === '') {
$this->properties()->where('key', $key)->delete();
} else {
// Note: updateOrCreate() uses two queries, but upsert() uses one
$this->properties()->upsert(
// Note: Setting 'item_id' here should not be needed after we migrate to Laravel v11
[['key' => $key, 'value' => $value, 'item_id' => $this->id]],
['item_id', 'key'],
['value']
);
}
}
/**
* All relations for this item
*
* @return HasMany<Relation, $this>
*/
public function relations()
{
return $this->hasMany(Relation::class);
}
/**
* Child relations for this item
*
* Used to retrieve all items in a collection.
*
* @return BelongsToMany<Item, $this>
*/
public function children()
{
return $this->belongsToMany(self::class, 'fs_relations', 'item_id', 'related_id');
}
/**
* Parent relations for this item
*
* Used to retrieve all collections of an item.
*
* @return BelongsToMany<Item, $this>
*/
public function parents()
{
return $this->belongsToMany(self::class, 'fs_relations', 'related_id', 'item_id');
}
}

File Metadata

Mime Type
text/x-php
Expires
Fri, Apr 24, 1:49 PM (4 d, 23 h ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
18824738
Default Alt Text
Item.php (5 KB)

Event Timeline