add support for file timestamps, fix creation of elements through links

Author: matthi4s

src/Exception/TouchException.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Aternos\IO\Exception;
+
+/**
+ * Class TouchException
+ *
+ * Thrown when a touch operation fails
+ *
+ * @package Aternos\IO\Exception
+ */
+class TouchException extends IOException
+{
+
+}

src/Interfaces/Features/GetAccessTimestampInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface GetAccessTimestampInterface
+ *
+ * Allows getting the access timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface GetAccessTimestampInterface extends IOElementInterface
+{
+    /**
+     * Get the access timestamp of the element
+     *
+     * @throws IOException
+     * @return int
+     */
+    public function getAccessTimestamp(): int;
+}

src/Interfaces/Features/GetBirthTimestampInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface GetBirthTimestampInterface
+ *
+ * Allows getting the birth timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface GetBirthTimestampInterface extends IOElementInterface
+{
+    /**
+     * Get the birth timestamp of the element
+     *
+     * @throws IOException
+     * @return int
+     */
+    public function getBirthTimestamp(): int;
+}

src/Interfaces/Features/GetModificationTimestampInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface GetModificationTimestampInterface
+ *
+ * Allows getting the modification timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface GetModificationTimestampInterface extends IOElementInterface
+{
+    /**
+     * Get the modification timestamp of the element
+     *
+     * @throws IOException
+     * @return int
+     */
+    public function getModificationTimestamp(): int;
+}

src/Interfaces/Features/GetStatusChangeTimestampInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface GetStatusChangeTimestampInterface
+ *
+ * Allows getting the timestamp of the last status change
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface GetStatusChangeTimestampInterface extends IOElementInterface
+{
+    /**
+     * Get the timestamp of the last status change
+     *
+     * @throws IOException
+     * @return int
+     */
+    public function getStatusChangeTimestamp(): int;
+}

src/Interfaces/Features/SetAccessTimestampInterface.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface SetAccessTimestampInterface
+ *
+ * Allows setting the access timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface SetAccessTimestampInterface extends IOElementInterface
+{
+    /**
+     * Set the access timestamp
+     *
+     * This might also change other timestamps
+     *
+     * @throws IOException
+     * @param int $timestamp
+     * @return $this
+     */
+    public function setAccessTimestamp(int $timestamp): static;
+}

src/Interfaces/Features/SetBirthTimestampInterface.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface SetBirthTimestampInterface
+ *
+ * Allows setting the birth timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface SetBirthTimestampInterface extends IOElementInterface
+{
+    /**
+     * Set the birth timestamp
+     *
+     * This might also change other timestamps
+     *
+     * @throws IOException
+     * @param int $timestamp
+     * @return $this
+     */
+    public function setBirthTimestamp(int $timestamp): static;
+}

src/Interfaces/Features/SetModificationTimestampInterface.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface SetModificationTimestampInterface
+ *
+ * Allows setting the modification timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface SetModificationTimestampInterface extends IOElementInterface
+{
+    /**
+     * Set the modification timestamp
+     *
+     * This might also change other timestamps
+     *
+     * @throws IOException
+     * @param int $timestamp
+     * @return $this
+     */
+    public function setModificationTimestamp(int $timestamp): static;
+}

src/Interfaces/Features/SetStatusChangeTimestampInterface.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Aternos\IO\Interfaces\Features;
+
+use Aternos\IO\Exception\IOException;
+use Aternos\IO\Interfaces\IOElementInterface;
+
+/**
+ * Interface SetStatusChangeTimestampInterface
+ *
+ * Allows setting the status change timestamp of an element
+ *
+ * @package Aternos\IO\Interfaces\Features
+ */
+interface SetStatusChangeTimestampInterface extends IOElementInterface
+{
+    /**
+     * Set the status change timestamp
+     *
+     * This might also change other timestamps
+     *
+     * @throws IOException
+     * @param int $timestamp
+     * @return $this
+     */
+    public function setStatusChangeTimestamp(int $timestamp): static;
+}

src/System/FilesystemElement.php

@@ -4,6 +4,8 @@
 
 use Aternos\IO\Exception\MoveException;
 use Aternos\IO\Exception\PathOutsideElementException;
+use Aternos\IO\Exception\StatException;
+use Aternos\IO\Exception\TouchException;
 use Aternos\IO\Interfaces\Features\GetPathInterface;
 use Aternos\IO\System\Directory\Directory;
 use Aternos\IO\System\File\File;
@@ -134,6 +136,84 @@ public function exists(): bool
         return file_exists($this->path);
     }
 
+    /**
+     * @inheritDoc
+     * @throws StatException
+     */
+    public function getAccessTimestamp(): int
+    {
+        $time = @fileatime($this->path);
+        if ($time === false) {
+            $error = error_get_last();
+            throw new StatException("Could not get access timestamp (" . $this->path . ")" . ($error ? ": " . $error["message"] : ""), $this);
+        }
+        return $time;
+    }
+
+    /**
+     * @inheritDoc
+     * @throws StatException
+     */
+    public function getModificationTimestamp(): int
+    {
+        $time = @filemtime($this->path);
+        if ($time === false) {
+            $error = error_get_last();
+            throw new StatException("Could not get modification timestamp (" . $this->path . ")" . ($error ? ": " . $error["message"] : ""), $this);
+        }
+        return $time;
+    }
+
+    /**
+     * @inheritDoc
+     * @throws StatException
+     */
+    public function getStatusChangeTimestamp(): int
+    {
+        $time = @filectime($this->path);
+        if ($time === false) {
+            $error = error_get_last();
+            throw new StatException("Could not get status change timestamp (" . $this->path . ")" . ($error ? ": " . $error["message"] : ""), $this);
+        }
+        return $time;
+    }
+
+    /**
+     * @inheritDoc
+     * @throws TouchException
+     * @throws StatException
+     */
+    public function setAccessTimestamp(int $timestamp): static
+    {
+        if (!file_exists($this->path)) {
+            throw new StatException("Could not set access timestamp because element does not exist (" . $this->path . ")", $this);
+        }
+
+        if (!@touch($this->path, $timestamp, $timestamp)) {
+            $error = error_get_last();
+            throw new TouchException("Could not set access timestamp (" . $this->path . ")" . ($error ? ": " . $error["message"] : ""), $this);
+        }
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     * @throws TouchException
+     * @throws StatException
+     */
+    public function setModificationTimestamp(int $timestamp): static
+    {
+        if (!file_exists($this->path)) {
+            throw new StatException("Could not set modification timestamp because element does not exist (" . $this->path . ")", $this);
+        }
+
+        if (!@touch($this->path, mtime: $timestamp)) {
+            $error = error_get_last();
+            throw new TouchException("Could not set modification timestamp (" . $this->path . ")" . ($error ? ": " . $error["message"] : ""), $this);
+        }
+        return $this;
+    }
+
     /**
      * @return string[]
      */