mirror of
https://github.com/nextcloud/documentation.git
synced 2026-01-02 17:59:36 +07:00
2647cd93c7
This moves lots of pages around. The high-level changes are * Better main sections, so it's more *general*, *into*, *basics* and *details* * Move more general topics to a *Basic* section, which are not app-specific * Remove app docs to the stuff that is likely used, anything else goes into "Digging deeper" * Move general guides into a prologue * Try to *compress*/combine some pages with similar content * Try to have better consistencs on level ob abstraction across pages * Split app development and maintenance pages into two sections * Integrate bugtracker info into prologue * Integrate Android pages into client APIs section Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
59 lines
1.6 KiB
ReStructuredText
59 lines
1.6 KiB
ReStructuredText
=============
|
|
Bootstrapping
|
|
=============
|
|
|
|
Every php process has a relatively short lifespan that lasts as long as the HTTP request or the invokation of the command
|
|
line program. At the beginning of this lifespan, Nextcloud initializes its services. At the same time, any additional apps
|
|
might want to register their services to Nextcloud as well. This event is called the *bootstrapping* and this chapter
|
|
shall shed some light on how to hook into this with an app.
|
|
|
|
|
|
.. _app-php:
|
|
|
|
app.php
|
|
-------
|
|
|
|
Nextcloud will ``require_once`` every installed and enabled app's ``appinfo/app.php`` file if it exists. The app can use
|
|
this file to run registrations of services, event listeners and similar.
|
|
|
|
To leverage the advantages of object-oriented programming, it's recommended to put the logic into an :ref:`application-php`
|
|
class and query an instance like
|
|
|
|
.. code-block:: php
|
|
|
|
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
$app = \OC::$server->query(\OCA\MyApp\AppInfo\Application::class);
|
|
$app->registerHooks();
|
|
|
|
|
|
.. _application-php:
|
|
|
|
Application
|
|
-----------
|
|
|
|
An `Application` class shall serve as central initialization point of an app.
|
|
|
|
.. code-block:: php
|
|
|
|
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace OCA\MyApp\AppInfo;
|
|
|
|
use OCP\AppFramework\App;
|
|
|
|
class Application extends App {
|
|
|
|
public function registerHooks(): void {
|
|
\OCP\Util::connectHook('OC_User', 'pre_deleteUser', 'OCA\MyApp\Hooks\User', 'deleteUser');
|
|
}
|
|
|
|
}
|
|
|
|
.. note:: Nextcloud does not load this class for every request. You should query an instance inside your :ref:`app-php` to
|
|
load for every request, if desired.
|