pkp/pkp-lib#9678 Replacing task schedular with laravel scheduler

classes/scheduler/Scheduler.php

@@ -0,0 +1,60 @@
+<?php
+
+/**
+ * @file classes/scheduler/Scheduler.php
+ *
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class Scheduler
+ *
+ * @brief Core scheduler class, responsible to register scheduled tasks specific for the application
+ */
+
+namespace APP\scheduler;
+
+use APP\tasks\UsageStatsLoader;
+use PKP\scheduledTask\PKPScheduler;
+use PKP\task\EditorialReminders;
+use PKP\task\PublishSubmissions;
+use PKP\task\ReviewReminder;
+
+class Scheduler extends PKPScheduler
+{
+    /**
+     * @copydoc \PKP\scheduledTask\PKPScheduler::registerSchedules
+     */
+    public function registerSchedules(): void
+    {
+        parent::registerSchedules();
+
+        $this
+            ->schedule
+            ->call(fn () => (new ReviewReminder())->execute())
+            ->hourly()
+            ->name(ReviewReminder::class)
+            ->withoutOverlapping();
+
+        $this
+            ->schedule
+            ->call(fn () => (new EditorialReminders())->execute())
+            ->daily()
+            ->name(EditorialReminders::class)
+            ->withoutOverlapping();
+
+        $this
+            ->schedule
+            ->call(fn () => (new PublishSubmissions())->execute())
+            ->daily()
+            ->name(PublishSubmissions::class)
+            ->withoutOverlapping();
+
+        $this
+            ->schedule
+            ->call(fn () => (new UsageStatsLoader([]))->execute())
+            ->daily()
+            ->name(UsageStatsLoader::class)
+            ->withoutOverlapping();
+    }
+}

config.TEMPLATE.inc.php

@@ -54,17 +54,6 @@
 ; To set the "Secure" attribute for the cookie see the setting force_ssl at the [security] group
 session_samesite = Lax
 
-; Enable support for running scheduled tasks
-; Set this to On if you have set up the scheduled tasks script to
-; execute periodically
-scheduled_tasks = Off
-
-; Scheduled tasks will send email about processing
-; only in case of errors. Set to off to receive
-; all other kind of notification, including success,
-; warnings and notices.
-scheduled_tasks_report_error_only = On
-
 ; Site time zone
 ; Please refer to https://www.php.net/timezones for a full list of supported
 ; time zones.
@@ -583,6 +572,41 @@
 ; Remove this setting to leave failed jobs in the database.
 delete_failed_jobs_after = 180
 
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;
+; Schedule Task Settings ;
+;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+[schedule]
+
+; Whether or not to turn on the built-in schedule task runner
+;
+; When enabled, schedule tasks will be processed at the end of each web
+; request to the application.
+;
+; Use of the built-in schedule task runner is highly discouraged for high-volume 
+; sites. Use your operational system's task scheduler instead, and configure 
+; it to run the task scheduler every minute.
+; Sample for the *nix crontab
+; * * * * * php lib/pkp/tools/scheduler.php run >> /dev/null 2>&1
+;
+; See: <link-to-documentation>
+task_runner = On
+
+; How often should the built-in schedule task runner run scheduled tasks at the
+; end of web request life cycle (value defined in seconds).
+; 
+; This configuration will only have effect for the build-it task runner, it doesn't apply
+; to the system crontab configuration. 
+;
+; The default value is set to 60 seconds, a value smaller than that might affect the
+; application performance negatively.
+task_runner_interval = 60
+
+; When enabled, an email with the scheduled task result will be sent only when an error
+; has occurred. Otherwise, all tasks will generate a notification.
+scheduled_tasks_report_error_only = On
+
 [invitations]
 expiration_days = 3
 

dbscripts/xml/install.xml

@@ -33,7 +33,6 @@
 	<migration class="PKP\migration\install\InvitationsMigration" />
 	<migration class="PKP\migration\install\SubmissionFilesMigration" />
 	<migration class="PKP\migration\install\ReviewFormsMigration" />
-	<migration class="PKP\migration\install\ScheduledTasksMigration" />
 	<migration class="PKP\migration\install\LibraryFilesMigration" />
 	<migration class="PKP\migration\install\ReviewsMigration" />
 	<migration class="PKP\migration\install\TemporaryFilesMigration" />

dbscripts/xml/upgrade.xml

@@ -115,6 +115,7 @@
 		<migration class="PKP\migration\upgrade\v3_5_0\PreflightCheckMigration" fallback="3.4.9.9" />
 		<migration class="APP\migration\upgrade\v3_5_0\I8333_AddMissingForeignKeys" />
 		<migration class="PKP\migration\upgrade\v3_5_0\I9895_AddAppKeyToConfigFile"/>
+		<migration class="PKP\migration\upgrade\v3_5_0\I9678_RemoveScheduledTasksTable"/>
 		<migration class="PKP\migration\upgrade\v3_5_0\InstallEmailTemplates"/>
 		<migration class="PKP\migration\upgrade\v3_5_0\I9197_MigrateAccessKeys"/>
 		<migration class="PKP\migration\upgrade\v3_5_0\I9253_SiteAnnouncements"/>

docs/release-notes/README-3.5.0

@@ -17,6 +17,13 @@ New config.inc.php parameters added for security:
     - cipher (default value: ''), cipher algorithm used to generate app key and encryption purpose
     - cookie_encryption (default value: ''), allow cookie encryption when set
 
+New config.inc.php section for schedule task named schedule is added, with the following parameters:
+    - task_runner (default value: On), Whether or not to run the schedule tasks through web based task runner
+    - task_runner_interval (default value: 60), How often should the built-in web based task runner run scheduled tasks in seconds
+    - scheduled_tasks_report_error_only (default value: On), Whether or not schedule task execution failure details will be sent via mail
+
+- The setting general.scheduled_tasks has been removed. It was supposed to control the schedule tasks but had no impact.
+
 
 New Features
 ------------

locale/en/manager.po

@@ -741,9 +741,6 @@ msgstr "Review Options"
 msgid "manager.setup.reviewOptions.automatedReminders"
 msgstr "Automated Email Reminders"
 
-msgid "manager.setup.reviewOptions.automatedRemindersDisabled"
-msgstr "To activate these options, the site administrator must enable the <tt>scheduled_tasks</tt> option in the OMP configuration file. Additional server configuration may be required to support this functionality (which may not be possible on all servers), as indicated in the OMP documentation."
-
 msgid "manager.setup.reviewOptions.onQuality"
 msgstr "Editors will rate reviewers on a five-point quality scale after each review."