2019-12-11 03:30:29 -05:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Friendica;
|
|
|
|
|
|
|
|
use Friendica\Database\Database;
|
|
|
|
use Friendica\Network\HTTPException;
|
|
|
|
use Psr\Log\LoggerInterface;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The Model classes inheriting from this abstract class are meant to represent a single database record.
|
|
|
|
* The associated table name has to be provided in the child class, and the table is expected to have a unique `id` field.
|
|
|
|
*
|
|
|
|
* @property int id
|
|
|
|
*/
|
2020-01-28 15:28:57 -05:00
|
|
|
abstract class BaseModel extends BaseEntity
|
2019-12-11 03:30:29 -05:00
|
|
|
{
|
|
|
|
/** @var Database */
|
|
|
|
protected $dba;
|
|
|
|
/** @var LoggerInterface */
|
|
|
|
protected $logger;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Model record abstraction.
|
|
|
|
* Child classes never have to interact directly with it.
|
|
|
|
* Please use the magic getter instead.
|
|
|
|
*
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private $data = [];
|
|
|
|
|
2020-01-13 21:58:19 -05:00
|
|
|
/**
|
|
|
|
* Used to limit/avoid updates if no data was changed.
|
|
|
|
*
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private $originalData = [];
|
|
|
|
|
2020-01-05 17:26:51 -05:00
|
|
|
/**
|
|
|
|
* @param Database $dba
|
|
|
|
* @param LoggerInterface $logger
|
|
|
|
* @param array $data Table row attributes
|
|
|
|
*/
|
|
|
|
public function __construct(Database $dba, LoggerInterface $logger, array $data = [])
|
2019-12-11 03:30:29 -05:00
|
|
|
{
|
|
|
|
$this->dba = $dba;
|
|
|
|
$this->logger = $logger;
|
2019-12-27 09:20:09 -05:00
|
|
|
$this->data = $data;
|
2020-01-13 21:58:19 -05:00
|
|
|
$this->originalData = $data;
|
|
|
|
}
|
|
|
|
|
|
|
|
public function getOriginalData()
|
|
|
|
{
|
2020-01-28 15:28:57 -05:00
|
|
|
return $this->originalData;
|
2019-12-11 03:30:29 -05:00
|
|
|
}
|
|
|
|
|
2020-01-24 20:01:49 -05:00
|
|
|
public function resetOriginalData()
|
|
|
|
{
|
|
|
|
$this->originalData = $this->data;
|
|
|
|
}
|
|
|
|
|
2020-01-05 17:26:51 -05:00
|
|
|
/**
|
|
|
|
* Performance-improved model creation in a loop
|
|
|
|
*
|
|
|
|
* @param BaseModel $prototype
|
|
|
|
* @param array $data
|
|
|
|
* @return BaseModel
|
|
|
|
*/
|
|
|
|
public static function createFromPrototype(BaseModel $prototype, array $data)
|
|
|
|
{
|
|
|
|
$model = clone $prototype;
|
|
|
|
$model->data = $data;
|
2020-01-13 21:58:19 -05:00
|
|
|
$model->originalData = $data;
|
2020-01-05 17:26:51 -05:00
|
|
|
|
|
|
|
return $model;
|
|
|
|
}
|
|
|
|
|
2020-01-13 22:18:45 -05:00
|
|
|
/**
|
|
|
|
* Magic isset method. Returns true if the field exists, either in the data prperty array or in any of the local properties.
|
|
|
|
* Used by array_column() on an array of objects.
|
|
|
|
*
|
|
|
|
* @param $name
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function __isset($name)
|
|
|
|
{
|
|
|
|
return in_array($name, array_merge(array_keys($this->data), array_keys(get_object_vars($this))));
|
|
|
|
}
|
|
|
|
|
2019-12-11 03:30:29 -05:00
|
|
|
/**
|
|
|
|
* Magic getter. This allows to retrieve model fields with the following syntax:
|
|
|
|
* - $model->field (outside of class)
|
|
|
|
* - $this->field (inside of class)
|
|
|
|
*
|
|
|
|
* @param $name
|
|
|
|
* @return mixed
|
|
|
|
* @throws HTTPException\InternalServerErrorException
|
|
|
|
*/
|
|
|
|
public function __get($name)
|
|
|
|
{
|
2020-01-13 22:18:45 -05:00
|
|
|
$this->checkValid();
|
2019-12-11 03:30:29 -05:00
|
|
|
|
|
|
|
if (!array_key_exists($name, $this->data)) {
|
|
|
|
throw new HTTPException\InternalServerErrorException('Field ' . $name . ' not found in ' . static::class);
|
|
|
|
}
|
|
|
|
|
|
|
|
return $this->data[$name];
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-01-05 17:26:51 -05:00
|
|
|
* @param string $name
|
|
|
|
* @param mixed $value
|
2019-12-11 03:30:29 -05:00
|
|
|
*/
|
2020-01-05 17:26:51 -05:00
|
|
|
public function __set($name, $value)
|
2019-12-11 03:30:29 -05:00
|
|
|
{
|
2020-01-05 17:26:51 -05:00
|
|
|
$this->data[$name] = $value;
|
2019-12-11 03:30:29 -05:00
|
|
|
}
|
|
|
|
|
2020-01-28 15:28:57 -05:00
|
|
|
public function toArray()
|
2019-12-11 03:30:29 -05:00
|
|
|
{
|
2020-01-28 15:28:57 -05:00
|
|
|
return $this->data;
|
2019-12-11 03:30:29 -05:00
|
|
|
}
|
2020-01-13 22:18:45 -05:00
|
|
|
|
|
|
|
protected function checkValid()
|
|
|
|
{
|
|
|
|
if (empty($this->data['id'])) {
|
|
|
|
throw new HTTPException\InternalServerErrorException(static::class . ' record uninitialized');
|
|
|
|
}
|
|
|
|
}
|
2019-12-11 03:30:29 -05:00
|
|
|
}
|