A task to create a simple symbolic link

Mage/Task/BuiltIn/Filesystem/SymlinkTask.php

@@ -0,0 +1,139 @@
+<?php
+namespace Mage\Task\BuiltIn\Filesystem;
+
+use Mage\Task\AbstractTask;
+use Mage\Config\RequiredConfigNotFoundException;
+
+/**
+ * Task for creating a symbolic link. Change will be done on local or
+ * remote host depending on the stage of the deployment.
+ *
+ * Usage :
+ *   pre-deploy:
+ *     - filesystem/symlink: {link:/path/to/symlink, target: /path/to/target}
+ *   on-deploy:
+ *     - filesystem/symlink: {link:/path/to/symlink, target: /path/to/target}
+ *
+ * @author Jérémy Huet <jeremy.huet@gmail.com>
+ */
+class SymlinkTask extends AbstractTask
+{
+    /**
+     * The name of the symlink including full path to it.
+     *
+     * If the stage is on local host you should give full paths. If on remote
+     * you may give full or relative to the current release directory paths.
+     *
+     * @var string
+     */
+    private $link;
+
+    /**
+     * The target to wich the symlink should point to including full path to it.
+     *
+     * If the stage is on local host you should give full paths. If on remote
+     * you may give full or relative to the current release directory paths.
+     *
+     * @var string
+     */
+    private $target;
+
+    /**
+     * Initialize parameters.
+     *
+     * @throws RequiredConfigNotFoundException
+     */
+    public function init()
+    {
+        parent::init();
+
+        if (! $this->getParameter('target')) {
+            throw new RequiredConfigNotFoundException('Missing required target link.');
+        }
+
+        $this->setTarget($this->getParameter('target'));
+        if (!is_null($this->getParameter('link'))) {
+            $this->setLink($this->getParameter('link'));
+        }
+    }
+
+    /**
+     * @return string
+     */
+    public function getName()
+    {
+        return "Creating symbolic link [built-in]";
+    }
+
+    /**
+     * @return boolean
+     */
+    public function run()
+    {
+        $command = 'ln -fs ' . $this->getAbsolutPath($this->getTarget());
+        if ($this->getLink()) {
+            $command .= ' ' . $this->getAbsolutPath($this->getLink());
+        }
+
+        $result = $this->runCommand($command);
+
+        return $result;
+    }
+
+    /**
+     * @param string $path
+     * @return string
+     */
+    public function getAbsolutPath($path)
+    {
+        // For release
+        if ($this->getStage() != 'pre-deploy' && $path[0] != '/' && $this->getConfig()->deployment('to')) {
+            $releasesDirectory = trim($this->getConfig()->release('directory', 'releases'), '/') . '/' . $this->getConfig()->getReleaseId();
+            return rtrim($this->getConfig()->deployment('to'), '/') . '/' . $releasesDirectory . '/' . ltrim($path, '/');
+        }
+
+        return $path;
+    }
+
+    /**
+     * Set link.
+     *
+     * @param string $link
+     * @return SymlinkTask
+     */
+    protected function setLink($link)
+    {
+        $this->link = $link;
+
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    protected function getLink()
+    {
+        return $this->link;
+    }
+
+    /**
+     * Set target.
+     *
+     * @param string $target
+     * @return SymlinkTask
+     */
+    protected function setTarget($target)
+    {
+        $this->target = $target;
+
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    protected function getTarget()
+    {
+        return $this->target;
+    }
+}