engine/classes/ElggRelationship.php

Rama 7.x · réplica de lectura del repositorio original.

<?php

/**
 * Relationship class.
 *
 * @property int    $id           The unique identifier (read-only)
 * @property int    $guid_one     The GUID of the subject of the relationship
 * @property string $relationship The type of the relationship (limit of 50 characters long)
 * @property int    $guid_two     The GUID of the target of the relationship
 * @property int    $time_created A UNIX timestamp of when the relationship was created (read-only, set on first save)
 */
class ElggRelationship extends \ElggData {

	/**
	 * @var string[] database columns
	 */
	public const PRIMARY_ATTR_NAMES = [
		'id',
		'guid_one',
		'relationship',
		'guid_two',
		'time_created',
	];
	
	/**
	 * @var string[] attributes that are integers
	 */
	protected const INTEGER_ATTR_NAMES = [
		'guid_one',
		'guid_two',
		'time_created',
		'id',
	];
	
	/**
	 * Holds the original (persisted) attribute values that have been changed but not yet saved.
	 * @var array
	 */
	protected array $orig_attributes = [];
	
	/**
	 * Create a relationship object
	 *
	 * @param null|\stdClass $row Database row
	 */
	public function __construct(?\stdClass $row = null) {
		$this->initializeAttributes();

		if (!empty($row)) {
			foreach ((array) $row as $key => $value) {
				if (!in_array($key, static::PRIMARY_ATTR_NAMES)) {
					// don't set arbitrary attributes that aren't supported
					continue;
				}
				
				if (in_array($key, static::INTEGER_ATTR_NAMES)) {
					$value = (int) $value;
				}
				
				$this->attributes[$key] = $value;
			}
		}
	}

	/**
	 * {@inheritdoc}
	 */
	protected function initializeAttributes() {
		parent::initializeAttributes();

		$this->attributes['id'] = null;
		$this->attributes['guid_one'] = null;
		$this->attributes['relationship'] = null;
		$this->attributes['guid_two'] = null;
	}

	/**
	 * Set an attribute of the relationship
	 *
	 * @param string $name  Name
	 * @param mixed  $value Value
	 *
	 * @return void
	 */
	public function __set(string $name, mixed $value): void {
		if (in_array($name, static::INTEGER_ATTR_NAMES) && isset($value) && !is_int($value)) {
			// make sure the new value is an int for the int columns
			$value = (int) $value;
		}
		
		if ($this->$name === $value) {
			// nothing changed
			return;
		}
		
		if (!array_key_exists($name, $this->attributes)) {
			// only support setting attributes
			return;
		}
		
		if ($this->id > 0 && !array_key_exists($name, $this->orig_attributes)) {
			// store original attribute
			$this->orig_attributes[$name] = $this->attributes[$name];
		}
		
		$this->attributes[$name] = $value;
	}

	/**
	 * Get an attribute of the relationship
	 *
	 * @param string $name Name
	 *
	 * @return mixed
	 */
	public function __get(string $name): mixed {
		if (array_key_exists($name, $this->attributes)) {
			return $this->attributes[$name];
		}

		return null;
	}

	/**
	 * {@inheritdoc}
	 */
	public function save(): bool {
		if ($this->id > 0 && empty($this->orig_attributes)) {
			// nothing has changed
			return true;
		}
		
		if ($this->id > 0) {
			_elgg_services()->relationshipsTable->delete($this->id);
		}

		return _elgg_services()->relationshipsTable->add($this);
	}

	/**
	 * Delete this relationship from the database.
	 *
	 * @return bool
	 */
	public function delete(): bool {
		return _elgg_services()->relationshipsTable->delete($this->id);
	}

	/**
	 * Get a URL for this relationship.
	 *
	 * Plugins can register for the 'relationship:url', 'relationship' event to
	 * customize the url for a relationship.
	 *
	 * @return string
	 */
	public function getURL(): string {
		$url = _elgg_services()->events->triggerResults('relationship:url', $this->getType(), ['relationship' => $this], '');

		return elgg_normalize_url($url);
	}

	/**
	 * {@inheritdoc}
	 */
	public function toObject(array $params = []) {
		$object = new \Elgg\Export\Relationship();
		$object->id = $this->id;
		$object->subject_guid = $this->guid_one;
		$object->relationship = $this->relationship;
		$object->object_guid = $this->guid_two;
		$object->time_created = date('c', $this->getTimeCreated());

		$params['relationship'] = $this;

		return _elgg_services()->events->triggerResults('to:object', 'relationship', $params, $object);
	}

	// SYSTEM LOG INTERFACE ////////////////////////////////////////////////////////////

	/**
	 * {@inheritdoc}
	 */
	public function getSystemLogID(): int {
		return (int) $this->id;
	}

	/**
	 * For a given ID, return the object associated with it.
	 * This is used by the river functionality primarily.
	 * This is useful for checking access permissions etc on objects.
	 *
	 * @param int $id ID
	 *
	 * @return \ElggRelationship|false
	 */
	public function getObjectFromID(int $id) {
		return _elgg_services()->relationshipsTable->get($id);
	}

	/**
	 * Return a type of the object - eg. object, group, user, relationship, metadata, annotation etc
	 *
	 * @return string 'relationship'
	 */
	public function getType(): string {
		return 'relationship';
	}

	/**
	 * Return a subtype. For metadata & annotations this is the 'name' and for relationship this
	 * is the relationship type.
	 *
	 * @return string
	 */
	public function getSubtype(): string {
		return $this->relationship;
	}
	
	/**
	 * Get the original values of attribute(s) that have been modified since the relationship was persisted.
	 *
	 * @return array
	 */
	public function getOriginalAttributes(): array {
		return $this->orig_attributes;
	}
}