Files
nextcloud-docs/developer_manual/app/backgroundjobs.rst
Daniel Calviño Sánchez d18a61c515 Fix style-related punctuation
Based on the style that can be inferred from the current documentation,
paragraphs should end in periods, except when followed by lists or
examples in which case they should end in colons; list items should not
use an ending period, except when the list items act themselves as
paragraphs.

Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>
2017-05-10 00:40:46 +02:00

40 lines
1.1 KiB
ReStructuredText

======================
Background Jobs (Cron)
======================
.. sectionauthor:: Bernhard Posselt <dev@bernhard-posselt.com>
Background/cron jobs are usually registered in the :file:`appinfo/app.php` by using the **addRegularTask** method, the class and the method to run:
.. code-block:: php
<?php
\OCP\Backgroundjob::addRegularTask('\OCA\MyApp\Cron\SomeTask', 'run');
The class for the above example would live in :file:`cron/sometask.php`. Try to keep the method as small as possible because its hard to test static methods. Simply reuse the app container and execute a service that was registered in it:
.. code-block:: php
<?php
namespace OCA\MyApp\Cron;
use \OCA\MyApp\AppInfo\Application;
class SomeTask {
public static function run() {
$app = new Application();
$container = $app->getContainer();
$container->query('SomeService')->run();
}
}
Don't forget to configure the cron service on the server by executing::
sudo crontab -u http -e
where **http** is your Web server user, and add::
*/15 * * * * php -f /srv/http/nextcloud/cron.php