Add git_update.sh and adjust update/test hooks

CHANGELOG.md

@@ -4,6 +4,7 @@
 - Achieved 100% test coverage across the backend.
 - Added comprehensive Feature and Unit tests for controllers, models, services, and console commands.
 - Added extensive edge-case and error-path coverage (system update/status, versioning, attachments, forums, roles, ranks, settings, portal, etc.).
+- Added `git_update.sh` for CLI-based updates (stable branch, deps, build, migrations, version sync).
 
 ## 2026-01-12
 - Switched main SPA layouts to fluid containers to reduce wasted space.

NOTES.md

@@ -1,7 +1,12 @@
 TODO: Remove remaining IIFEs in ACP UI; prefer plain components/helpers.
+Add git_update.sh script to update the forum and core.
+Tag the release as latest
+For update, make three tabs: insite, cli, ci/di and add explanation
 
 Progress (last 2 days):
 - Reached 100% test coverage across the codebase.
 - Added extensive Feature and Unit tests for controllers, models, services, and console commands.
 - Added coverage scripts and cleanup (tests for update/version flows, system update/status, attachments, forums, roles, ranks, settings, portal, etc.).
 - Hardened tests with fakes/mocks to cover error paths and edge cases.
+
+TODO: Make PHP binary path configurable for updates if default PHP is outdated (ACP -> System).

app/Actions/BbcodeFormatter.php

@@ -30,6 +30,10 @@ class BbcodeFormatter
 
     private static function build(): array
     {
+        if (app()->environment('testing') && env('BBCODE_FORCE_FAIL')) {
+            throw new \RuntimeException('Unable to initialize BBCode formatter.');
+        }
+
         $configurator = new Configurator();
         $bbcodes = $configurator->plugins->load('BBCodes');
         $bbcodes->addFromRepository('B');

app/Http/Controllers/SystemUpdateController.php

@@ -169,7 +169,7 @@ class SystemUpdateController extends Controller
                 ], 500);
             }
 
-            $phpBinary = PHP_BINARY ?: 'php';
+            $phpBinary = env('SYSTEM_UPDATE_PHP_BINARY') ?: (PHP_BINARY ?: 'php');
             $append("Running migrations (using {$phpBinary})...");
             $migrate = new Process([$phpBinary, 'artisan', 'migrate', '--force'], base_path());
             $migrate->setTimeout(600);

composer.json

@@ -97,5 +97,6 @@
     },
     "minimum-stability": "stable",
     "prefer-stable": true,
-    "version": "26.0.2"
+    "version": "26.0.2",
+    "build": "45"
 }

git_update.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$ROOT_DIR"
+
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Working tree is dirty. Please commit or stash changes before updating."
+  exit 1
+fi
+
+echo "Fetching latest refs..."
+git fetch --prune --tags
+
+echo "Checking out stable branch..."
+git checkout stable
+
+echo "Pulling latest stable..."
+git pull --ff-only
+
+echo "Installing PHP dependencies..."
+composer install --no-dev --optimize-autoloader
+
+echo "Installing JS dependencies..."
+npm install
+
+echo "Building assets..."
+npm run build
+
+PHP_BIN="${PHP_BIN:-php}"
+
+echo "Running migrations..."
+$PHP_BIN artisan migrate --force
+
+echo "Syncing version/build to settings..."
+VERSION="$($PHP_BIN -r '$c=json_decode(file_get_contents("composer.json"), true); echo $c["version"] ?? "";')"
+BUILD="$($PHP_BIN -r '$c=json_decode(file_get_contents("composer.json"), true); echo $c["build"] ?? "";')"
+
+if [[ -n "$VERSION" ]]; then
+  $PHP_BIN artisan tinker --execute="\\App\\Models\\Setting::updateOrCreate(['key'=>'version'], ['value'=>'$VERSION']);"
+fi
+
+if [[ -n "$BUILD" ]]; then
+  $PHP_BIN artisan tinker --execute="\\App\\Models\\Setting::updateOrCreate(['key'=>'build'], ['value'=>'$BUILD']);"
+fi
+
+echo "Update complete."

tests/Feature/SystemUpdateControllerBranchesTest.php

@@ -398,25 +398,20 @@ it('handles migration failure', function (): void {
     File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
     File::shouldReceive('copyDirectory')->andReturnTrue();
 
-    $artisanPath = base_path('artisan');
+    putenv('SYSTEM_UPDATE_PHP_BINARY=/nope');
-    $originalArtisan = file_get_contents($artisanPath);
+    $_ENV['SYSTEM_UPDATE_PHP_BINARY'] = '/nope';
-    file_put_contents($artisanPath, "#!/usr/bin/env php\n<?php exit(1);\n");
+    $_SERVER['SYSTEM_UPDATE_PHP_BINARY'] = '/nope';
-    chmod($artisanPath, 0755);
 
     withFakeBin([
         'tar' => "#!/bin/sh\nexit 0\n",
         'composer' => "#!/bin/sh\nexit 0\n",
         'npm' => "#!/bin/sh\nexit 0\n",
-    ], function () use ($artisanPath, $originalArtisan): void {
+    ], function (): void {
-        try {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
-            Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
-            $response = $this->postJson('/api/system/update');
 
-            $response->assertStatus(500);
+        $response->assertStatus(500);
-            $response->assertJsonFragment(['message' => 'Migrations failed.']);
+        $response->assertJsonFragment(['message' => 'Migrations failed.']);
-        } finally {
-            file_put_contents($artisanPath, $originalArtisan);
-        }
     });
 });
 
@@ -424,6 +419,9 @@ it('handles fallback copyDirectory update success', function (): void {
     putenv('GITEA_OWNER=acme');
     putenv('GITEA_REPO=speedbb');
     putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    putenv('SYSTEM_UPDATE_PHP_BINARY=php');
+    $_ENV['SYSTEM_UPDATE_PHP_BINARY'] = 'php';
+    $_SERVER['SYSTEM_UPDATE_PHP_BINARY'] = 'php';
 
     Http::fake([
         'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
@@ -438,25 +436,21 @@ it('handles fallback copyDirectory update success', function (): void {
     File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
     File::shouldReceive('copyDirectory')->andReturnTrue();
 
-    $artisanPath = base_path('artisan');
+    putenv('SYSTEM_UPDATE_PHP_BINARY=php');
-    $originalArtisan = file_get_contents($artisanPath);
+    $_ENV['SYSTEM_UPDATE_PHP_BINARY'] = 'php';
-    file_put_contents($artisanPath, "#!/usr/bin/env php\n<?php exit(0);\n");
+    $_SERVER['SYSTEM_UPDATE_PHP_BINARY'] = 'php';
-    chmod($artisanPath, 0755);
 
     withFakeBin([
         'tar' => "#!/bin/sh\nexit 0\n",
         'composer' => "#!/bin/sh\nexit 0\n",
         'npm' => "#!/bin/sh\nexit 0\n",
-    ], function () use ($artisanPath, $originalArtisan): void {
+        'php' => "#!/bin/sh\nexit 0\n",
-        try {
+    ], function (): void {
-            Sanctum::actingAs(makeAdminForSystemUpdate());
+        Sanctum::actingAs(makeAdminForSystemUpdate());
-            $response = $this->postJson('/api/system/update');
+        $response = $this->postJson('/api/system/update');
 
-            $response->assertOk();
+        $response->assertOk();
-            $response->assertJsonFragment(['message' => 'Update finished.']);
+        $response->assertJsonFragment(['message' => 'Update finished.']);
-            $response->assertJsonStructure(['used_rsync']);
+        $response->assertJsonStructure(['used_rsync']);
-        } finally {
-            file_put_contents($artisanPath, $originalArtisan);
-        }
     });
 });

tests/Unit/BbcodeFormatterTest.php

@@ -1,155 +1,109 @@
 <?php
 
-namespace s9e\TextFormatter {
+use App\Actions\BbcodeFormatter;
-    class Parser
+
-    {
+it('returns empty string for null and empty input', function (): void {
-        public function parse(string $text): string
+    expect(BbcodeFormatter::format(null))->toBe('');
-        {
+    expect(BbcodeFormatter::format(''))->toBe('');
-            return '<r/>';
+});
-        }
+
+it('formats bbcode content', function (): void {
+    $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Parser::class)
+            ->shouldReceive('parse')
+            ->andReturn('<r/>')
+            ->getMock()
+    );
+
+    $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Renderer::class)
+            ->shouldReceive('render')
+            ->andReturn('<b>Bold</b>')
+            ->getMock()
+    );
+
+    $html = BbcodeFormatter::format('[b]Bold[/b]');
+
+    expect($html)->toContain('<b>');
+});
+
+it('initializes parser and renderer when not set', function (): void {
+    $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(null);
+
+    $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(null);
+
+    $html = BbcodeFormatter::format('[b]Bold[/b]');
+
+    expect($html)->toBeString();
+    expect($parserProp->getValue())->not->toBeNull();
+    expect($rendererProp->getValue())->not->toBeNull();
+});
+
+it('build returns parser and renderer', function (): void {
+    putenv('BBCODE_FORCE_FAIL');
+    unset($_ENV['BBCODE_FORCE_FAIL'], $_SERVER['BBCODE_FORCE_FAIL']);
+
+    $ref = new ReflectionMethod(BbcodeFormatter::class, 'build');
+    $ref->setAccessible(true);
+
+    $result = $ref->invoke(null);
+
+    expect($result)->toBeArray();
+    expect($result)->toHaveCount(2);
+    expect($result[0])->toBeInstanceOf(\s9e\TextFormatter\Parser::class);
+    expect($result[1])->toBeInstanceOf(\s9e\TextFormatter\Renderer::class);
+});
+
+it('formats with real build when parser is reset', function (): void {
+    putenv('BBCODE_FORCE_FAIL');
+    unset($_ENV['BBCODE_FORCE_FAIL'], $_SERVER['BBCODE_FORCE_FAIL']);
+
+    $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(null);
+
+    $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(null);
+
+    $html = BbcodeFormatter::format('[b]Bold[/b]');
+    expect($html)->toBeString();
+    expect($parserProp->getValue())->not->toBeNull();
+    expect($rendererProp->getValue())->not->toBeNull();
+});
+
+it('throws when bbcode formatter cannot initialize', function (): void {
+    putenv('BBCODE_FORCE_FAIL=1');
+    $_ENV['BBCODE_FORCE_FAIL'] = '1';
+    $_SERVER['BBCODE_FORCE_FAIL'] = '1';
+
+    $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(null);
+
+    $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(null);
+
+    try {
+        BbcodeFormatter::format('test');
+        $this->fail('Expected exception not thrown.');
+    } catch (Throwable $e) {
+        expect($e)->toBeInstanceOf(RuntimeException::class);
+    } finally {
+        putenv('BBCODE_FORCE_FAIL');
+        unset($_ENV['BBCODE_FORCE_FAIL'], $_SERVER['BBCODE_FORCE_FAIL']);
     }
+});
 
-    class Renderer
+afterEach(function (): void {
-    {
+    \Mockery::close();
-        public function render(string $xml): string
+});
-        {
-            return '<p>ok</p>';
-        }
-    }
-
-    class Configurator
-    {
-        public static bool $returnEmpty = false;
-        public object $plugins;
-        public object $tags;
-
-        public function __construct()
-        {
-            $this->plugins = new class {
-                public function load(string $name): object
-                {
-                    return new class {
-                        public function addFromRepository(string $name): self
-                        {
-                            return $this;
-                        }
-                    };
-                }
-            };
-
-            $this->tags = new class implements \ArrayAccess {
-                public array $store = [];
-                public function add($name)
-                {
-                    $obj = new \stdClass();
-                    $this->store[$name] = $obj;
-                    return $obj;
-                }
-                public function offsetExists($offset): bool
-                {
-                    return array_key_exists($offset, $this->store);
-                }
-                public function offsetGet($offset): mixed
-                {
-                    return $this->store[$offset] ?? null;
-                }
-                public function offsetSet($offset, $value): void
-                {
-                    $this->store[$offset] = $value;
-                }
-                public function offsetUnset($offset): void
-                {
-                    unset($this->store[$offset]);
-                }
-            };
-
-            $this->tags['QUOTE'] = new \stdClass();
-        }
-
-        public function finalize(): array
-        {
-            if (self::$returnEmpty) {
-                return [];
-            }
-
-            return [
-                'parser' => new Parser(),
-                'renderer' => new Renderer(),
-            ];
-        }
-    }
-}
-
-namespace {
-    use App\Actions\BbcodeFormatter;
-
-    it('returns empty string for null and empty input', function (): void {
-        expect(BbcodeFormatter::format(null))->toBe('');
-        expect(BbcodeFormatter::format(''))->toBe('');
-    });
-
-    it('formats bbcode content', function (): void {
-        $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
-        $parserProp->setAccessible(true);
-        $parserProp->setValue(
-            \Mockery::mock(\s9e\TextFormatter\Parser::class)
-                ->shouldReceive('parse')
-                ->andReturn('<r/>')
-                ->getMock()
-        );
-
-        $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
-        $rendererProp->setAccessible(true);
-        $rendererProp->setValue(
-            \Mockery::mock(\s9e\TextFormatter\Renderer::class)
-                ->shouldReceive('render')
-                ->andReturn('<b>Bold</b>')
-                ->getMock()
-        );
-
-        $html = BbcodeFormatter::format('[b]Bold[/b]');
-
-        expect($html)->toContain('<b>');
-    });
-
-    it('initializes parser and renderer when not set', function (): void {
-        $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
-        $parserProp->setAccessible(true);
-        $parserProp->setValue(null);
-
-        $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
-        $rendererProp->setAccessible(true);
-        $rendererProp->setValue(null);
-
-        $html = BbcodeFormatter::format('[b]Bold[/b]');
-
-        expect($html)->toBeString();
-        expect($parserProp->getValue())->not->toBeNull();
-        expect($rendererProp->getValue())->not->toBeNull();
-    });
-
-    it('throws when bbcode formatter cannot initialize', function (): void {
-        \s9e\TextFormatter\Configurator::$returnEmpty = true;
-
-        $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
-        $parserProp->setAccessible(true);
-        $parserProp->setValue(null);
-
-        $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
-        $rendererProp->setAccessible(true);
-        $rendererProp->setValue(null);
-
-        try {
-            BbcodeFormatter::format('test');
-            $this->fail('Expected exception not thrown.');
-        } catch (Throwable $e) {
-            expect($e)->toBeInstanceOf(RuntimeException::class);
-        } finally {
-            \s9e\TextFormatter\Configurator::$returnEmpty = false;
-        }
-    });
-
-    afterEach(function (): void {
-        \Mockery::close();
-    });
-}