Method createShareLink

src/FileRise/Domain/FileModel.php:3062–3129

* Creates a share link for a file. * * @param string $folder The folder containing the shared file (or "root"). * @param string $file The name of the file being shared. * @param int $expirationSeconds The number of seconds until expiration. * @param string $password Optional password protecting the share. * @return array Returns an associative array with keys "token"

($folder, $file, $expirationSeconds = 3600, $password = "", string $createdBy = "")

     *               or "error" on failure.
     */
    public static function createShareLink($folder, $file, $expirationSeconds = 3600, $password = "", string $createdBy = "")
    {
        try {
            if (FolderCrypto::isEncryptedOrAncestor((string)$folder)) {
                return ["error" => "Sharing is disabled inside encrypted folders."];
            }
        } catch (\Throwable $e) {
/* ignore */
        }

        // Validate folder if necessary (this can also be done in the controller).
        if (strtolower($folder) !== 'root' && !preg_match(REGEX_FOLDER_NAME, $folder)) {
            return ["error" => "Invalid folder name."];
        }
        // Validate file name.
        $file = basename(trim($file));
        if (!preg_match(REGEX_FILE_NAME, $file)) {
            return ["error" => "Invalid file name."];
        }

        // Generate a secure token (32 hex characters).
        $token = bin2hex(random_bytes(16));

        // Calculate expiration (Unix timestamp).
        $expires = time() + $expirationSeconds;

        // Hash the password if provided.
        $hashedPassword = !empty($password) ? password_hash($password, PASSWORD_DEFAULT) : "";

        // File to store share links.
        $shareFile = self::metaRoot() . "share_links.json";
        $shareLinks = [];
        if (file_exists($shareFile)) {
            $data = file_get_contents($shareFile);
            $shareLinks = json_decode($data, true);
            if (!is_array($shareLinks)) {
                $shareLinks = [];
            }
        }

        // Clean up expired share links.
        $currentTime = time();
        foreach ($shareLinks as $key => $link) {
            if ($link["expires"] < $currentTime) {
                unset($shareLinks[$key]);
            }
        }

        $createdBy = trim($createdBy);
        $createdBy = preg_replace('/[\x00-\x1F\x7F]/', '', $createdBy);

        // Add new share record.
        $shareLinks[$token] = [
            "folder"   => $folder,
            "file"     => $file,
            "expires"  => $expires,
            "password" => $hashedPassword,
            "createdBy" => is_string($createdBy) ? $createdBy : '',