Zanke

Prikaži kot Markdown Uredi na GitHub Dokumentacija za 7a44bd6

Rudel sproži dejanja in filtre WordPress ob dogodkih življenjskega cikla peskovnika. Spodnji katalog je rezultat ukaza Rudel::hooks(): 28 dejanj in 5 filtrov.

Primer

PHP

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

Večina dejanj before in failed prejme polje $context. Pri kavljih življenjskega cikla peskovnika vsebuje environment (ali name, options in environments_dir ob ustvarjanju); dejanja failed prejmejo tudi prestreženo izjemo Throwable kot $error.

Dejanja življenjskega cikla peskovnika

Dejanje	Argumenti
`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`

Tri dejanja replace_state pripadajo EnvironmentManager::replace_environment_state(), ki ga ne pokliče noben ukaz Rudel.

Dejanja posnetkov

Dejanje	Argumenti
`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 vsebuje environment, kind (snapshot), name in path. Vsako od teh dejanj se sproži tudi z vzdevkom snapshot, na primer rudel_after_snapshot_create; ob napakah se z $context in napako sprožita tudi rudel_failed_recovery_point_{create|restore|delete} in rudel_failed_snapshot_{create|restore|delete}. Ti vzdevki niso vključeni v katalog.

Dejanja čiščenja

Dejanje	Argumenti
`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 vsebuje removed, skipped, errors in reasons.

Dejanja pošiljanja Git

Dejanje	Argumenti
`rudel_before_environment_push`	`$context`
`rudel_after_environment_push`	`$sha`, `$context`
`rudel_environment_push_failed`	`$context`, `$error`

Ta dejanja se sprožijo za Rudel::push(). $context vsebuje environment, remote, message in subdir. Ukaz wp rudel push pošlje neposredno in jih ne sproži.

Dejanja avtomatizacije

Dejanje	Argumenti
`rudel_before_automation_cleanup`	`$config`
`rudel_after_automation_cleanup`	`$result`, `$config`
`rudel_after_automation_expiring_environments`	`$result`, `$config`

$config je celotno polje rudel_config. Glejte Avtomatizacija.

Filtri

Filter	Argumenti
`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 lahko spremeni možnosti katerega koli klica za ustvarjanje, preden jih uporabi Rudel. rudel_environment_clone_source filtrira metapodatke klona, shranjene v peskovniku, ustvarjenem iz gostitelja. rudel_environment_db_dropin_contents velja samo za vtičnik db.php, ki ga uporabljajo okolja podmestij v večmestni namestitvi; prekrivni peskovniki, edina vrsta, ki jo ustvarjajo trenutne različice, ga nikoli ne ustvarijo.

Filtri so namenjeni prilagajanju pravilnikov, ne zamenjavi modela shranjevanja za Rudel. Identiteta izvajalnega okolja, predpone tabel in metapodatki delovnih imenikov ostajajo stanje Rudel, podprto z bazo podatkov.