[ticket/14168] Add attachment manager service

PHPBB3-14168

phpBB/config/default/container/services_attachment.yml

@@ -10,6 +10,14 @@ services:
             - @attachment.resync
             - %core.root_path%
 
+    attachment.manager:
+        class: phpbb\attachment\manager
+        scope: prototype
+        arguments:
+            - @attachment.delete
+            - @attachment.resync
+            - @attachment.upload
+
     attachment.resync:
         class: phpbb\attachment\resync
         scope: prototype

phpBB/phpbb/attachment/manager.php

@@ -0,0 +1,99 @@
+<?php
+/**
+ *
+ * This file is part of the phpBB Forum Software package.
+ *
+ * @copyright (c) phpBB Limited <https://www.phpbb.com>
+ * @license GNU General Public License, version 2 (GPL-2.0)
+ *
+ * For full copyright and license information, please see
+ * the docs/CREDITS.txt file.
+ *
+ */
+
+namespace phpbb\attachment;
+
+/**
+ * Attachment manager
+ */
+class manager
+{
+    /** @var delete Attachment delete class */
+    protected $delete;
+
+    /** @var resync Attachment resync class */
+    protected $resync;
+
+    /** @var upload Attachment upload class */
+    protected $upload;
+
+    /**
+     * Constructor for attachment manager
+     *
+     * @param delete $delete Attachment delete class
+     * @param resync $resync Attachment resync class
+     * @param upload $upload Attachment upload class
+     */
+    public function __construct(delete $delete, resync $resync, upload $upload)
+    {
+        $this->delete = $delete;
+        $this->resync = $resync;
+        $this->upload = $upload;
+    }
+
+    /**
+     * Wrapper method for deleting attachments
+     *
+     * @param string $mode can be: post|message|topic|attach|user
+     * @param mixed $ids can be: post_ids, message_ids, topic_ids, attach_ids, user_ids
+     * @param bool $resync set this to false if you are deleting posts or topics
+     *
+     * @return int|bool Number of deleted attachments or false if something
+     *			went wrong during attachment deletion
+     */
+    public function delete($mode, $id, $resync = true)
+    {
+        $this->delete->delete($mode, $id, $resync);
+    }
+
+    /**
+     * Wrapper method for deleting attachments from filesystem
+     *
+     * @param string $filename Filename of attachment
+     * @param string $mode Delete mode
+     * @param bool $entry_removed Whether entry was removed. Defaults to false
+     * @return bool True if file was removed, false if not
+     */
+    public function unlink($filename, $mode = 'file', $entry_removed = false)
+    {
+        $this->delete->unlink_attachment($filename, $mode, $entry_removed);
+    }
+
+    /**
+     * Wrapper method for resyncing specified type
+     *
+     * @param string $type Type of resync
+     * @param array $ids IDs to resync
+     */
+    public function resync($type, $ids)
+    {
+        $this->resync->resync($type, $ids);
+    }
+
+    /**
+     * Wrapper method for uploading attachment
+     *
+     * @param string			$form_name		The form name of the file upload input
+     * @param int			$forum_id		The id of the forum
+     * @param bool			$local			Whether the file is local or not
+     * @param string			$local_storage	The path to the local file
+     * @param bool			$is_message		Whether it is a PM or not
+     * @param array		$local_filedata	An file data object created for the local file
+     *
+     * @return object filespec
+     */
+    public function upload($form_name, $forum_id, $local = false, $local_storage = '', $is_message = false, $local_filedata = [])
+    {
+        $this->upload->upload($form_name, $forum_id, $local, $local_storage, $is_message, $local_filedata);
+    }
+}