看板初始化提交

2026-06-01 21:23:12 -07:00
commit 27411ebedc
1827 changed files with 192340 additions and 0 deletions
@@ -0,0 +1,144 @@
+<?php
+
+namespace Kanboard\Core\Plugin;
+
+use ZipArchive;
+use Kanboard\Core\Tool;
+
+/**
+ * Class Installer
+ *
+ * @package Kanboard\Core\Plugin
+ * @author  Frederic Guillot
+ */
+class Installer extends \Kanboard\Core\Base
+{
+    /**
+     * Return true if Kanboard is configured to install plugins
+     *
+     * @static
+     * @access public
+     * @return bool
+     */
+    public static function isConfigured()
+    {
+        return PLUGIN_INSTALLER && is_writable(PLUGINS_DIR) && extension_loaded('zip');
+    }
+
+    /**
+     * Install a plugin
+     *
+     * @access public
+     * @param  string $archiveUrl
+     * @throws PluginInstallerException
+     */
+    public function install($archiveUrl)
+    {
+        $zip = $this->downloadPluginArchive($archiveUrl);
+
+        if (! $zip->extractTo(PLUGINS_DIR)) {
+            $this->cleanupArchive($zip);
+            throw new PluginInstallerException(t('Unable to extract plugin archive.'));
+        }
+
+        $this->cleanupArchive($zip);
+    }
+
+    /**
+     * Uninstall a plugin
+     *
+     * @access public
+     * @param  string $pluginId
+     * @throws PluginInstallerException
+     */
+    public function uninstall($pluginId)
+    {
+        $pluginFolder = PLUGINS_DIR.DIRECTORY_SEPARATOR.basename($pluginId);
+
+        if (! file_exists($pluginFolder)) {
+            throw new PluginInstallerException(t('Plugin not found.'));
+        }
+
+        if (! is_writable($pluginFolder)) {
+            throw new PluginInstallerException(e('You don\'t have the permission to remove this plugin.'));
+        }
+
+        Tool::removeAllFiles($pluginFolder);
+    }
+
+    /**
+     * Update a plugin
+     *
+     * @access public
+     * @param  string $archiveUrl
+     * @throws PluginInstallerException
+     */
+    public function update($archiveUrl)
+    {
+        $zip = $this->downloadPluginArchive($archiveUrl);
+
+        $firstEntry = $zip->statIndex(0);
+        $this->uninstall($firstEntry['name']);
+
+        if (! $zip->extractTo(PLUGINS_DIR)) {
+            $this->cleanupArchive($zip);
+            throw new PluginInstallerException(t('Unable to extract plugin archive.'));
+        }
+
+        $this->cleanupArchive($zip);
+    }
+
+    /**
+     * Download archive from URL
+     *
+     * @access protected
+     * @param  string $archiveUrl
+     * @return ZipArchive
+     * @throws PluginInstallerException
+     */
+    protected function downloadPluginArchive($archiveUrl)
+    {
+        if (!preg_match('/^https?:\/\//', $archiveUrl) || !filter_var($archiveUrl, FILTER_VALIDATE_URL)) {
+            throw new PluginInstallerException(t('This URL is invalid'));
+        }
+
+        $archiveData = $this->httpClient->get($archiveUrl);
+        $archiveFile = tempnam(ini_get('upload_tmp_dir') ? ini_get('upload_tmp_dir') : sys_get_temp_dir(), 'kb_plugin');
+
+        if (empty($archiveData)) {
+            unlink($archiveFile);
+            throw new PluginInstallerException(t('Unable to download plugin archive.'));
+        }
+
+        if (file_put_contents($archiveFile, $archiveData) === false) {
+            unlink($archiveFile);
+            throw new PluginInstallerException(t('Unable to write temporary file for plugin.'));
+        }
+
+        $zip = new ZipArchive();
+        if ($zip->open($archiveFile) !== true) {
+            unlink($archiveFile);
+            throw new PluginInstallerException(t('Unable to open plugin archive.'));
+        }
+
+        if ($zip->numFiles === 0) {
+            unlink($archiveFile);
+            throw new PluginInstallerException(t('There is no file in the plugin archive.'));
+        }
+
+        return $zip;
+    }
+
+    /**
+     * Remove archive file
+     *
+     * @access protected
+     * @param ZipArchive $zip
+     */
+    protected function cleanupArchive(ZipArchive $zip)
+    {
+        $filename = $zip->filename;
+        $zip->close();
+        unlink($filename);
+    }
+}