نقاط التوسعة

عرض بتنسيق Markdown التعديل على GitHub التوثيق في 7a44bd6

يطلق Rudel إجراءات ومرشحات WordPress حول أحداث دورة حياة البيئة المعزولة. يتضمن الفهرس أدناه ما يعيده Rudel::hooks(): 28 إجراءً و5 مرشحات.

مثال

PHP

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

تتلقى معظم إجراءات before وfailed مصفوفة $context. وفي خطافات دورة حياة البيئة المعزولة، تحتوي على environment (أو name وoptions وenvironments_dir عند الإنشاء)؛ كما تتلقى إجراءات failed قيمة Throwable التي جرى التقاطها ضمن $error.

إجراءات دورة حياة البيئة المعزولة

الإجراء	الوسيطات
`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`

تنتمي إجراءات replace_state الثلاثة إلى EnvironmentManager::replace_environment_state()، ولا يستدعيها أي أمر من Rudel.

إجراءات اللقطات

الإجراء	الوسيطات
`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 العناصر environment وkind (snapshot) وname وpath. ويُطلق كل منها أيضًا باسم مستعار snapshot، مثل rudel_after_snapshot_create، وتُطلق حالات الإخفاق rudel_failed_recovery_point_{create|restore|delete} وrudel_failed_snapshot_{create|restore|delete} مع $context والخطأ. هذه الأسماء المستعارة غير مدرجة في الفهرس.

إجراءات التنظيف

الإجراء	الوسيطات
`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 العناصر removed وskipped وerrors وreasons.

إجراءات دفع Git

الإجراء	الوسيطات
`rudel_before_environment_push`	`$context`
`rudel_after_environment_push`	`$sha`، `$context`
`rudel_environment_push_failed`	`$context`، `$error`

تُطلق هذه الإجراءات من أجل Rudel::push(). وتتضمن $context العناصر environment وremote وmessage وsubdir. أما الأمر wp rudel push فيدفع التغييرات مباشرة ولا يطلقها.

إجراءات الأتمتة

الإجراء	الوسيطات
`rudel_before_automation_cleanup`	`$config`
`rudel_after_automation_cleanup`	`$result`، `$config`
`rudel_after_automation_expiring_environments`	`$result`، `$config`

$config هي مصفوفة rudel_config كاملة. راجع الأتمتة.

المرشحات

المرشح	الوسيطات
`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 تغيير خيارات أي استدعاء إنشاء قبل أن يطبق Rudel عليها. ويصفّي rudel_environment_clone_source بيانات النسخ الوصفية المخزنة في بيئة معزولة أُنشئت من المضيف. وينطبق rudel_environment_db_dropin_contents على الإضافة db.php فقط، التي تستخدمها بيئات المواقع المتعددة الفرعية؛ أما البيئات المعزولة ذات التراكب، وهي النوع الوحيد الذي تنشئه الإصدارات الحالية، فلا تنشئ واحدة أبدًا.

صُممت المرشحات لتعديل السياسات، لا لاستبدال نموذج التخزين في Rudel. وتظل هوية وقت التشغيل وبادئات الجداول والبيانات الوصفية لأشجار العمل حالات مدعومة بقاعدة البيانات عبر Rudel.