Konksud

Vaata Markdownina Muuda teenuses GitHub Dokumentatsioon: 7a44bd6

Rudel käivitab liivakasti elutsükli sündmuste puhul WordPress toimingud ja filtrid. Allolev kataloog näitab, mida tagastab Rudel::hooks(): 28 toimingut ja 5 filtrit.

Näide

PHP

add_action(
    'rudel_after_environment_create',
    function ( \Rudel\Environment $environment, array $context ): void {
        error_log( 'Created Rudel environment ' . $environment->id );
    },
    10,
    2
);

Enamik before ja failed toiminguid saab argumendiks massiivi $context. Liivakasti elutsükli hookide puhul sisaldab see environment (või loomisel väärtusi name, options ja environments_dir); toimingud failed saavad tabatud Throwable lisaks argumendina $error.

Liivakasti elutsükli toimingud

Toiming	Argumendid
`rudel_before_environment_create`	`$context`
`rudel_after_environment_create`	`$environment`, `$context`
`rudel_environment_create_failed`	`$context`, `$error`
`rudel_before_environment_update`	`$context`
`rudel_after_environment_update`	`$environment`, `$context`
`rudel_environment_update_failed`	`$context`, `$error`
`rudel_before_environment_destroy`	`$context`
`rudel_after_environment_destroy`	`$context`
`rudel_environment_destroy_failed`	`$context`, `$error`
`rudel_before_environment_replace_state`	`$context`
`rudel_after_environment_replace_state`	`$result`, `$context`
`rudel_environment_replace_state_failed`	`$context`, `$error`

Kolm replace_state toimingut kuuluvad üksusele EnvironmentManager::replace_environment_state(), mida ükski Rudel käsk ei kutsu.

Hetktõmmiste toimingud

Toiming	Argumendid
`rudel_before_recovery_point_create`	`$context`
`rudel_after_recovery_point_create`	`$context`, `$meta`
`rudel_before_recovery_point_restore`	`$context`
`rudel_after_recovery_point_restore`	`$context`
`rudel_before_recovery_point_delete`	`$context`
`rudel_after_recovery_point_delete`	`$context`

$context sisaldab väärtusi environment, kind (snapshot), name ja path. Kõik need käivituvad ka snapshot aliasena, näiteks rudel_after_snapshot_create, ning tõrke korral käivituvad rudel_failed_recovery_point_{create|restore|delete} ja rudel_failed_snapshot_{create|restore|delete} koos väärtuse $context ja veaga. Neid aliaseid kataloogis pole.

Puhastamise toimingud

Toiming	Argumendid
`rudel_before_environment_cleanup`	`$options`
`rudel_after_environment_cleanup`	`$result`, `$options`
`rudel_before_environment_cleanup_merged`	`$options`
`rudel_after_environment_cleanup_merged`	`$result`, `$options`

$result sisaldab väärtusi removed, skipped, errors ja reasons.

Git üleslaadimise toimingud

Toiming	Argumendid
`rudel_before_environment_push`	`$context`
`rudel_after_environment_push`	`$sha`, `$context`
`rudel_environment_push_failed`	`$context`, `$error`

Need käivituvad toimingu Rudel::push() puhul. $context sisaldab väärtusi environment, remote, message ja subdir. Käsk wp rudel push laadib muudatused otse üles ega käivita neid.

Automatiseerimise toimingud

Toiming	Argumendid
`rudel_before_automation_cleanup`	`$config`
`rudel_after_automation_cleanup`	`$result`, `$config`
`rudel_after_automation_expiring_environments`	`$result`, `$config`

$config on kogu massiiv rudel_config. Vt Automatiseerimine.

Filtrid

Filter	Argumendid
`rudel_environment_create_options`	`$options`, `$name`, `$manager`
`rudel_environment_clone_source`	`$clone_source`, `$host_url`, `$db_cloned`, `$themes_cloned`, `$plugins_cloned`, `$uploads_cloned`, `$extra`
`rudel_environment_cleanup_options`	`$options`, `$repository`
`rudel_environment_cleanup_merged_options`	`$options`, `$repository`
`rudel_environment_db_dropin_contents`	`$contents`, `$context`

rudel_environment_create_options saab muuta iga loomiskutse suvandeid enne, kui Rudel neid kasutab. rudel_environment_clone_source filtreerib hostist loodud liivakasti salvestatud kloonimise metaandmeid. rudel_environment_db_dropin_contents kehtib ainult db.php lisatava faili kohta, mida kasutavad mitme saidiga alamvõrkude keskkonnad; ülekattega liivakastid, mida praegused versioonid ainsana loovad, seda faili kunagi ei tekita.

Filtrid on mõeldud reeglite kohandamiseks, mitte üksuse Rudel salvestusmudeli asendamiseks. Käitusaja identiteet, tabelite prefiksid ja töökataloogi metaandmed jäävad andmebaasis hoitavaks Rudel olekuks.