Différences

Ci-dessous, les différences entre deux révisions de la page.

--- lumo:creation_complete_du_plugin_dokuwiki [2026/03/12 10:34] – estro
+++ lumo:creation_complete_du_plugin_dokuwiki [2026/03/12 10:45] (Version actuelle) – supprimée estro
@@ Ligne 1: / Ligne 1: @@
-====== Création complète du plugin DokuWiki ======
-[[./|retour]]
-----
-===== Structure du Plugin =====
-<code>
-/lib/plugins/bashexec/
-├── action.php          # Gestion des actions et appels
-├── syntax.php          # Syntaxe pour l'insertion dans les pages
-├── helper.php          # Fonctions utilitaires
-├── script.sh           # Votre script bash (optionnel)
-└── manifest.ini        # Métadonnées du plugin
-</code>
-<adm note 1. manifest.ini>
-++++code ini|
-<code ini>
-[plugin]
-name=Bash Exec Plugin
-desc=Exécute des scripts bash avec validation sécurisée
-author=Votre Nom
-email=votre@email.com
-url=https://votre-site.com
-date=2026-03-12
-version=1.0.0
-</code>
-++++
-</adm>
-<adm danger 2. helper.php (Fonctions utilitaires)>
-++++code php|
-<code php>
-<?php
-/**
- * Helper class for Bash Exec Plugin
- */
-class helper_plugin_bashexec extends DokuWiki_Plugin {
-    /**
-     * Validation stricte des arguments
-     */
-    public function validateArgument($arg) {
-        // Autorise uniquement alphanumérique, tirets et underscores
-        if (!preg_match('/^[a-zA-Z0-9_-]{1,50}$/', $arg)) {
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Validation du chemin du script
-     */
-    public function validateScriptPath($path) {
-        $allowedPaths = array(
-            DOKU_PLUGIN . 'bashexec/scripts/',
-            '/usr/local/bin/'
-        );
-        foreach ($allowedPaths as $allowed) {
-            if (strpos($path, $allowed) === 0) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Journalisation des exécutions
-     */
-    public function logExecution($script, $args, $returnCode, $user) {
-        $logFile = DOKU_LOG . '/bashexec.log';
-        $timestamp = date('Y-m-d H:i:s');
-        $entry = sprintf(
-            "[%s] User: %s | Script: %s | Args: %s | Return: %d\n",
-            $timestamp,
-            $user,
-            basename($script),
-            implode(' ', $args),
-            $returnCode
-        );
-        file_put_contents($logFile, $entry, FILE_APPEND);
-    }
-    /**
-     * Vérification des permissions
-     */
-    public function checkPermissions() {
-        global $USERINFO;
-        // Vérifie si l'utilisateur est connecté
-        if (!isset($USERINFO['name'])) {
-            return false;
-        }
-        // Optionnel : Restreindre à certains groupes
-        $allowedGroups = $this->getConf('allowed_groups');
-        if ($allowedGroups) {
-            $userGroups = explode(',', $allowedGroups);
-            foreach ($userGroups as $group) {
-                if (in_array(trim($group), $USERINFO['groups'])) {
-                    return true;
-                }
-            }
-            return false;
-        }
-        return true;
-    }
-}
-</code>
-++++
-</adm>
-<adm information 3. syntax.php (Syntaxe dans les pages wiki)>
-++++code php|
-<code php>
-<?php
-/**
- * Syntax Plugin for Bash Exec
- */
-class syntax_plugin_bashexec extends DokuWiki_Plugin_Syntax {
-    public function getType() {
-        return 'substition';
-    }
-    public function getPType() {
-        return 'normal';
-    }
-    public function getSort() {
-        return 150;
-    }
-    public function connectTo($mode) {
-        $this->Lexer->addSpecialPattern('%%bashexec\{[^}]+\}%%', $mode, 'plugin_bashexec');
-    }
-    public function handle($match, $state, $pos, Doku_Handler $handler) {
-        preg_match('/%%bashexec\{([^}]+)\}%%/', $match, $matches);
-        $params = trim($matches[1]);
-        // Parse: script.sh arg1 arg2
-        $parts = preg_split('/\s+/', $params);
-        $script = array_shift($parts);
-        $args = $parts;
-        return array($script, $args);
-    }
-    public function render($format, Doku_Renderer $renderer, $data) {
-        if ($format != 'xhtml') {
-            return false;
-        }
-        list($script, $args) = $data;
-        $helper = plugin_load('helper', 'bashexec');
-        // Vérifier les permissions
-        if (!$helper->checkPermissions()) {
-            $renderer->cdata('Accès refusé');
-            return true;
-        }
-        // Valider le script
-        if (!$helper->validateScriptPath(DOKU_PLUGIN . 'bashexec/scripts/' . $script)) {
-            $renderer->cdata('Script non autorisé');
-            return true;
-        }
-        // Valider tous les arguments
-        foreach ($args as $arg) {
-            if (!$helper->validateArgument($arg)) {
-                $renderer->cdata('Argument invalide');
-                return true;
-            }
-        }
-        // Exécuter le script
-        $fullScript = DOKU_PLUGIN . 'bashexec/scripts/' . $script;
-        $cmd = escapeshellcmd($fullScript);
-        $escapedArgs = array_map('escapeshellarg', $args);
-        $command = $cmd . ' ' . implode(' ', $escapedArgs);
-        exec($command, $output, $returnCode);
-        // Journaliser
-        global $INPUT;
-        $helper->logExecution($script, $args, $returnCode, $INPUT->server->str('REMOTE_USER'));
-        // Afficher le résultat
-        if ($returnCode === 0) {
-            $renderer->cdata(implode("\n", $output));
-        } else {
-            $renderer->cdata('Erreur d\'exécution (code: ' . $returnCode . ')');
-        }
-        return true;
-    }
-}
-</code>
-++++
-</adm>
-<adm bug 4. action.php (Actions via URL)>
-++++code php|
-<code php>
-<?php
-/**
- * Action Plugin for Bash Exec
- */
-class action_plugin_bashexec extends DokuWiki_Action_Plugin {
-    public function register(Doku_Event_Handler $controller) {
-        $controller->register_hook('ACTION_ACT_PREPROCESS', 'BEFORE', $this, 'handleScriptRequest');
-        $controller->register_hook('TPL_ACT_RENDER', 'AFTER', $this, 'renderOutput');
-    }
-    public function handleScriptRequest(Doku_Event $event, $param) {
-        if ($event->data !== 'script') {
-            return;
-        }
-        $helper = plugin_load('helper', 'bashexec');
-        // Vérifier les permissions
-        if (!$helper->checkPermissions()) {
-            http_response_code(403);
-            print json_encode(['error' => 'Accès refusé']);
-            exit;
-        }
-        // Récupérer les paramètres
-        $script = $this->getInput('script');
-        $arg1 = $this->getInput('arg1');
-        $arg2 = $this->getInput('arg2');
-        // Valider le script
-        if (!$helper->validateScriptPath(DOKU_PLUGIN . 'bashexec/scripts/' . $script)) {
-            http_response_code(400);
-            print json_encode(['error' => 'Script non autorisé']);
-            exit;
-        }
-        // Valider les arguments
-        $args = array_filter([$arg1, $arg2]);
-        foreach ($args as $arg) {
-            if (!$helper->validateArgument($arg)) {
-                http_response_code(400);
-                print json_encode(['error' => 'Argument invalide']);
-                exit;
-            }
-        }
-        // Exécuter
-        $fullScript = DOKU_PLUGIN . 'bashexec/scripts/' . $script;
-        $escapedArgs = array_map('escapeshellarg', $args);
-        $command = escapeshellcmd($fullScript) . ' ' . implode(' ', $escapedArgs);
-        exec($command, $output, $returnCode);
-        // Journaliser
-        global $INPUT;
-        $helper->logExecution($script, $args, $returnCode, $INPUT->server->str('REMOTE_USER'));
-        // Répondre
-        header('Content-Type: application/json');
-        print json_encode([
-            'success' => $returnCode === 0,
-            'output' => $output,
-            'return_code' => $returnCode
-        ]);
-        exit;
-    }
-    private function getInput($key) {
-        return isset($_GET[$key]) ? $_GET[$key] : (isset($_POST[$key]) ? $_POST[$key] : '');
-    }
-    public function renderOutput(Doku_Event $event, $param) {
-        // Peut être utilisé pour afficher des résultats après exécution
-    }
-}
-</code>
-++++
-</adm>