钩子文档

image_memory_limit

💡 云策文档标注

概述

image_memory_limit 是一个 WordPress 过滤器,用于调整图像处理时分配的内存限制。它允许开发者自定义内存上限,以优化图像操作性能。

关键要点

  • 过滤器名称:image_memory_limit
  • 参数:$filtered_limit,可以是整数(字节)或简写字符串(如 '256M'),表示图像处理的最大内存限制
  • 默认值:取 WP_MAX_MEMORY_LIMIT 或原始 php.ini memory_limit 中的较高者
  • 应用场景:主要用于图像处理等内存密集型操作

代码示例

$filtered_limit = apply_filters( 'image_memory_limit', $filtered_limit );

注意事项

  • 从 WordPress 4.6.0 版本起,默认值会考虑原始 memory_limit 设置
  • 该过滤器在 WordPress 3.5.0 版本中引入
  • 相关函数:wp_raise_memory_limit() 可用于尝试提高 PHP 内存限制

📄 原文内容

Filters the memory limit allocated for image manipulation.

Parameters

$filtered_limitint|string
Maximum memory limit to allocate for image processing.
Default WP_MAX_MEMORY_LIMIT or the original php.ini memory_limit, whichever is higher.
Accepts an integer (bytes), or a shorthand string notation, such as '256M'.

Source

$filtered_limit = apply_filters( 'image_memory_limit', $filtered_limit );

Changelog

Version Description
4.6.0 The default now takes the original memory_limit into account.
3.5.0 Introduced.