Laravel 10 Upgrade (#730)

* wip composer.json

* WIP - departure to integrate
https://github.com/googleapis/google-cloud-php-errorreporting

* replace `gluedev/laravel-stackdriver`

* configure `absszero/laravel-stackdriver-error-reporting`

see #731

* remove call to `registerPolicies`

see https://laravel.com/docs/10.x/upgrade#register-policies

* schedule redis stale tag pruning

* use `$casts` property

see https://laravel.com/docs/10.x/upgrade#model-dates-property

* run `composer update --ignore-platform-reqs`

Composer version 2.6.5 2023-10-06 10:11:52

* rename `$routeMiddleware`

see https://laravel.com/docs/10.x/upgrade#middleware-aliases

* Apply curated changes from
laravel/laravel@9.x...10.x

* test: php 8.2

* update php version in composer

* remove custom stackdriver repo

* upgrade to phpunit 10

* migrate phpunit configuration

* re-add "absszero/laravel-stackdriver-error-reporting"

* replace CORS Handler

* refactor data providers

* refactor `$this->dispatch` & `dispatchNow`

* fix test class name

* refactor some tests

* update phpunit to 10.5, run composer update

* migrate ElasticSearchIndexDeleteTest.php

* fix deprecated string interpolation

* tests: replace job to queue dispatching with calling handle()

* implement ForceSearchIndex::uniqueId

* move to `dispatch` as mostly recommended example

Author: deer-wmde

.github/workflows/composer.test.yml

@@ -22,7 +22,7 @@ jobs:
     - name: Install dependencies
       uses: php-actions/composer@v6
       with:
-        php_version: 8.1
+        php_version: 8.2
         command: install
 
     - name: Copy example .env file

.gitignore

@@ -6,6 +6,7 @@ Homestead.yaml
 .env
 .php_cs.cache
 .phpunit.result.cache
+.phpunit.cache
 /storage/*.key
 /public/storage
 _ide_helper.php

CHANGELOG.md

@@ -1,5 +1,12 @@
 # api
 
+## 10x.0.0 - 26 February 2024
+- Update Laravel to v10.10 - T341797
+  - schedule redis stale tag pruning
+  - refactor: `dispatchNow` was removed
+- Update to PHPUnit v10.5
+- fix: Implemented ForceSearchIndex::uniqueId T358106
+
 ## 9x.1.0 - 16 Februrary 2024
 - Switching to PHP 8.2
 

app/Console/Commands/Wiki/SetSetting.php

@@ -41,7 +41,7 @@ public function handle()
                 'wiki_id' => $wiki->id,
                 'name' => $settingKey,
             ])->delete();
-            $this->line("Deleted setting ${settingKey} for wiki id ${wikiId}");
+            $this->line("Deleted setting {$settingKey} for wiki id {$wikiId}");
             return;
         }
 
@@ -54,7 +54,7 @@ public function handle()
                 'value' => $settingValue,
             ]
         );
-        $this->line("Set setting ${settingKey} to ${settingValue} for wiki id ${wikiId}");
+        $this->line("Set setting {$settingKey} to {$settingValue} for wiki id {$wikiId}");
 
         return 0;
     }

app/Console/Kernel.php

@@ -22,9 +22,8 @@ class Kernel extends ConsoleKernel
      * Define the application's command schedule.
      *
      * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
-     * @return void
      */
-    protected function schedule(Schedule $schedule)
+    protected function schedule(Schedule $schedule): void
     {
         // Make sure that the DB and QS pools are always populated somewhat.
         // This will create at most 1 new entry for each per minute...
@@ -48,6 +47,9 @@ protected function schedule(Schedule $schedule)
         // Schedule site stat updates for each wiki and platform-summary
         $schedule->command('schedule:stats')->dailyAt('7:00');
 
+        // https://laravel.com/docs/10.x/upgrade#redis-cache-tags
+        $schedule->command('cache:prune-stale-tags')->hourly();
+
         $schedule->job(new PollForMediaWikiJobsJob)->everyFifteenMinutes();
 
         $schedule->job(new UpdateWikiSiteStatsJob)->dailyAt('19:00');
@@ -57,10 +59,8 @@ protected function schedule(Schedule $schedule)
 
     /**
      * Register the commands for the application.
-     *
-     * @return void
      */
-    protected function commands()
+    protected function commands(): void
     {
         $this->load(__DIR__.'/Commands');
         $this->load(__DIR__.'/Commands/User');

app/Exceptions/Handler.php

@@ -7,25 +7,8 @@
 
 class Handler extends ExceptionHandler
 {
-
-    /**
-     * A list of exception types with their corresponding custom log levels.
-     *
-     * @var array<class-string<\Throwable>, \Psr\Log\LogLevel::*>
-     */
-    protected $levels = [
-        //
-    ];
-
     /**
-     * A list of the exception types that are not reported.
-     *
-     * @var array<int, class-string<\Throwable>>
-     */
-    protected $dontReport = [];
-
-    /**
-     * A list of the inputs that are never flashed for validation exceptions.
+     * The list of the inputs that are never flashed to the session on validation exceptions.
      *
      * @var array
      */
@@ -37,10 +20,11 @@ class Handler extends ExceptionHandler
     /**
      * Register the exception handling callbacks for the application.
      */
-    public function register()
+    public function register(): void
     {
         $this->reportable(function (Throwable $e) {
             (new \Absszero\ErrorReporting)->report($e);
         });
     }
 }
+

app/Http/Controllers/Controller.php

@@ -3,11 +3,10 @@
 namespace App\Http\Controllers;
 
 use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
-use Illuminate\Foundation\Bus\DispatchesJobs;
 use Illuminate\Foundation\Validation\ValidatesRequests;
 use Illuminate\Routing\Controller as BaseController;
 
 class Controller extends BaseController
 {
-    use AuthorizesRequests, DispatchesJobs, ValidatesRequests;
+    use AuthorizesRequests, ValidatesRequests;
 }

app/Http/Controllers/Sandbox/SandboxController.php

@@ -86,12 +86,12 @@ public function create(Request $request): \Illuminate\Http\Response
         // For now only schedule this job for 1 dataSet type
         // As the extension API is dumb currently
         if ($dataSet === 'library') {
-            $this->dispatch(new MediawikiSandboxLoadData($domain, $dataSet));
+            dispatch(new MediawikiSandboxLoadData($domain, $dataSet));
         }
 
         // opportunistic dispatching of jobs to make sure storage pools are topped up
-        $this->dispatch(new ProvisionWikiDbJob(null, null, 10));
-        $this->dispatch(new ProvisionQueryserviceNamespaceJob(null, 10));
+        dispatch(new ProvisionWikiDbJob(null, null, 10));
+        dispatch(new ProvisionQueryserviceNamespaceJob(null, 10));
 
         $res['success'] = true;
         $res['message'] = 'Success!';

app/Http/Controllers/WikiController.php

@@ -68,7 +68,7 @@ public function create(Request $request): \Illuminate\Http\Response
             $maxWikis = config('wbstack.wiki_max_per_user');
 
             if ( config('wbstack.wiki_max_per_user') !== false && $numWikis > config('wbstack.wiki_max_per_user')) {
-                abort(403, "Too many wikis. Your new total of {$numWikis} would exceed the limit of ${maxWikis} per user.");
+                abort(403, "Too many wikis. Your new total of {$numWikis} would exceed the limit of {$maxWikis} per user.");
             }
 
             $wiki = Wiki::create([
@@ -114,22 +114,22 @@ public function create(Request $request): \Illuminate\Http\Response
             ]);
 
             // TODO maybe always make these run in a certain order..?
-            $this->dispatch(new MediawikiInit($wiki->domain, $request->input('username'), $user->email));
+            dispatch(new MediawikiInit($wiki->domain, $request->input('username'), $user->email));
             // Only dispatch a job to add a k8s ingress IF we are using a custom domain...
             if (! $isSubdomain) {
-                $this->dispatch(new KubernetesIngressCreate($wiki->id, $wiki->domain));
+                dispatch(new KubernetesIngressCreate($wiki->id, $wiki->domain));
             }
         });
 
 
         // dispatch elasticsearch init job to enable the feature
         if ( Config::get('wbstack.elasticsearch_enabled_by_default') ) {
-            $this->dispatch(new ElasticSearchIndexInit($wiki->id));
+            dispatch(new ElasticSearchIndexInit($wiki->id));
         }
 
         // opportunistic dispatching of jobs to make sure storage pools are topped up
-        $this->dispatch(new ProvisionWikiDbJob(null, null, 10));
-        $this->dispatch(new ProvisionQueryserviceNamespaceJob(null, 10));
+        dispatch(new ProvisionWikiDbJob(null, null, 10));
+        dispatch(new ProvisionQueryserviceNamespaceJob(null, 10));
 
         $res['success'] = true;
         $res['message'] = 'Success!';

app/Http/Kernel.php

@@ -14,7 +14,7 @@ class Kernel extends HttpKernel
      * @var array
      */
     protected $middleware = [
-        \Fruitcake\Cors\HandleCors::class,
+        \Illuminate\Http\Middleware\HandleCors::class,
         \Illuminate\Http\Middleware\TrustProxies::class,
     ];
 
@@ -32,7 +32,7 @@ class Kernel extends HttpKernel
      *
      * @var array
      */
-    protected $routeMiddleware = [
+    protected $middlewareAliases = [
         // Came with Laravel
         'auth' => \App\Http\Middleware\Authenticate::class,
         'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,