Add site redirects (#552)

* feat(redirects): add redirects to sites

* chore(style): fixed coding style issues

* style: fix php-stan docblocks

* style: pint cleanup

* tests: fixed redirect test suite

* feat: vhosts include additional configs

* fix: use exact location matching

* - add enums
- use queues
- use vhost rather than separate conf files
- vhost formatter
- cleanup

* generate docs

---------

Co-authored-by: Saeed Vaziry <mr.saeedvaziry@gmail.com>

app/Actions/Redirect/CreateRedirect.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace App\Actions\Redirect;
+
+use App\Enums\RedirectStatus;
+use App\Models\Redirect;
+use App\Models\Service;
+use App\Models\Site;
+use App\SSH\Services\Webserver\Webserver;
+use Illuminate\Validation\Rule;
+
+class CreateRedirect
+{
+    /**
+     * @param  array<string, mixed>  $input
+     */
+    public function create(Site $site, array $input): Redirect
+    {
+        $redirect = new Redirect;
+
+        $redirect->site_id = $site->id;
+        $redirect->from = $input['from'];
+        $redirect->to = $input['to'];
+        $redirect->mode = $input['mode'];
+        $redirect->status = RedirectStatus::CREATING;
+        $redirect->save();
+
+        dispatch(function () use ($site, $redirect): void {
+            /** @var Service $service */
+            $service = $site->server->webserver();
+            /** @var Webserver $webserver */
+            $webserver = $service->handler();
+            $webserver->updateVHost($site);
+            $redirect->status = RedirectStatus::READY;
+            $redirect->save();
+        })
+            ->catch(function () use ($redirect): void {
+                $redirect->status = RedirectStatus::FAILED;
+                $redirect->save();
+            })
+            ->onConnection('ssh');
+
+        return $redirect->refresh();
+    }
+
+    /**
+     * @return array<string, array<string>>
+     */
+    public static function rules(Site $site): array
+    {
+        return [
+            'from' => [
+                'required',
+                'string',
+                'max:255',
+                'not_regex:/^http(s)?:\/\//',
+                Rule::unique('redirects', 'from')->where('site_id', $site->id),
+            ],
+            'to' => [
+                'required',
+                'url:http,https',
+            ],
+            'mode' => [
+                'required',
+                'integer',
+                Rule::in([
+                    301,
+                    302,
+                    307,
+                    308,
+                ]),
+            ],
+        ];
+    }
+}

app/Actions/Redirect/DeleteRedirect.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Actions\Redirect;
+
+use App\Enums\RedirectStatus;
+use App\Models\Redirect;
+use App\Models\Service;
+use App\Models\Site;
+use App\SSH\Services\Webserver\Webserver;
+
+class DeleteRedirect
+{
+    public function delete(Site $site, Redirect $redirect): void
+    {
+        $redirect->status = RedirectStatus::DELETING;
+        $redirect->save();
+
+        dispatch(function () use ($site, $redirect): void {
+            /** @var Service $service */
+            $service = $site->server->webserver();
+            /** @var Webserver $webserver */
+            $webserver = $service->handler();
+            $webserver->updateVHost($site);
+            $redirect->delete();
+        })->catch(function () use ($redirect): void {
+            $redirect->status = RedirectStatus::FAILED;
+            $redirect->save();
+        })->onConnection('ssh');
+    }
+}