钩子文档

image_edit_before_change

💡 云策文档标注

概述

image_edit_before_change 是一个 WordPress 过滤器钩子,用于在应用图像编辑更改前过滤 GD 图像资源。该钩子自 3.5.0 版本起已被弃用,建议使用 wp_image_editor_before_change 替代。

关键要点

  • 钩子名称:image_edit_before_change
  • 作用:在应用图像编辑更改前过滤 GD 图像资源或 GdImage 实例
  • 参数:$imageresource(GD 图像资源或 GdImage 实例)和 $changes(更改操作数组)
  • 弃用状态:自 WordPress 3.5.0 起弃用,推荐使用 wp_image_editor_before_change
  • 相关函数:与 image_edit_apply_changes() 函数关联,用于执行图像编辑更改

注意事项

由于该钩子已弃用,开发者应避免在新代码中使用,并迁移到 wp_image_editor_before_change 以保持兼容性和最佳实践。


📄 原文内容

Filters the GD image resource before applying changes to the image.

Parameters

$imageresource|GdImage
GD image resource or GdImage instance.
$changesarray
Array of change operations.

Source

$image = apply_filters_deprecated( 'image_edit_before_change', array( $image, $changes ), '3.5.0', 'wp_image_editor_before_change' );

Changelog

Version Description
3.5.0 Deprecated. Use ‘wp_image_editor_before_change’ instead.
2.9.0 Introduced.