解决 PHP 7.2 环境中 WordPress 的 count() 调用问题

来自:互联网
时间:2018-09-02
阅读:
免费资源网 - https://freexyz.cn/

群里有小伙伴 at 我,然后问了一个 WordPress 的报错问题,看了一下报错内容。嗯,这家伙用的 PHP 肯定是 7.2 版本的,然后就问了一下,果不其然还真是。

Warning: count(): Parameter must be an array or an object that implements Countable in /wp-includes/media.php on line 1206
报错原因

首先来看一下 count() 的方法原型。其中 $array_or_countable 参数,需要是数组或者 Countable 对象(Countable 接口能让对象可以被用于count函数的能力)。在 PHP 7.2 中对于 count() 有一个新增的变更,具体可参考官网文档

int count ( mixed $array_or_countable [, int $mode = COUNT_NORMAL ] )

也就是说在 7.2 版本中当无效的类型传递给 $array_or_countable 参数时,count() 会产生警告,所以我们可以知道,上面提到的报错应该是传了无效的类型给 count() 才导致发出的警告,不过这里还需要具体环境具体分析,接下来我们就看一下问题排查。

问题排查

在解决 WordPress 问题的时候,先把外因(插件、主题)排除,然后再看是不是 WordPress 自身的问题。这里先让其关闭了所有插件(排除插件导致),然后通过与小伙伴的交流,了解到了以下几点:

1、关闭所有插件之后问题依然存在;

2、用的主题是收费的,所以不方便调试;

3、切换主题之后,问题依然存在;

4、确定问题根源是用 WordPress 的手机 APP 上传的图片会出现这个问题;

解决问题

再看一下上面提到的报错位置 /wp-includes/media.php on line 1206 ,根据与小伙伴聊天排除了插件的问题,剩下主题和程序自身缺陷了,再确定了是用 WordPress 的手机 APP 上传的图片会出现这个问题,而且切换主题之后,问题依然存在。所以怀疑是程序自身的缺陷导致的这个问题,接下来我们就看一下 /wp-includes/media.php 在 1206 行有啥东西吧。

/**
 * Filters an image's 'srcset' sources.
 *
 * @since 4.4.0
 *
 * @param array  $sources {
 *     One or more arrays of source data to include in the 'srcset'.
 *
 *     @type array $width {
 *         @type string $url        The URL of an image source.
 *         @type string $descriptor The descriptor type used in the image candidate string,
 *                                  either 'w' or 'x'.
 *         @type int    $value      The source width if pAIred with a 'w' descriptor, or a
 *                                  pixel density value if paired with an 'x' descriptor.
 *     }
 * }
 * @param array  $size_array    Array of width and height values in pixels (in that order).
 * @param string $image_src     The 'src' of the image.
 * @param array  $image_meta    The image meta data as returned by 'wp_get_attachment_metadata()'.
 * @param int    $attachment_id Image attachment ID or 0.
 */
$sources = apply_filters( 'wp_calculate_image_srcset', $sources, $size_array, $image_src, $image_meta, $attachment_id );
 
// Only return a 'srcset' value if there is more than one source.
if ( ! $src_matched || count( $sources ) < 2 ) {
	return false;
}

看代码发现 1206 行在一个名叫 wp_calculate_image_srcset 的方法中(上面的点仅截取了部分重要代码和注释,问题代码在第 25 行),而且 count 调的 $sources 也是一个数组。那么只能说明在不知道哪里调用 wp_calculate_image_srcset 方法的时候,传过来的 $sources 是一个非数组,所以出现了这个问题,那么应该在调用 count 之前确保 $sources 是一个数组就成了,所以我们这里加一个判断 ! is_array( $sources ) 就可以了,所以修改之后的代码如下

/**
 * Filters an image's 'srcset' sources.
 *
 * @since 4.4.0
 *
 * @param array  $sources {
 *     One or more arrays of source data to include in the 'srcset'.
 *
 *     @type array $width {
 *         @type string $url        The URL of an image source.
 *         @type string $descriptor The descriptor type used in the image candidate string,
 *                                  either 'w' or 'x'.
 *         @type int    $value      The source width if paired with a 'w' descriptor, or a
 *                                  pixel density value if paired with an 'x' descriptor.
 *     }
 * }
 * @param array  $size_array    Array of width and height values in pixels (in that order).
 * @param string $image_src     The 'src' of the image.
 * @param array  $image_meta    The image meta data as returned by 'wp_get_attachment_metadata()'.
 * @param int    $attachment_id Image attachment ID or 0.
 */
$sources = apply_filters( 'wp_calculate_image_srcset', $sources, $size_array, $image_src, $image_meta, $attachment_id );
 
// Only return a 'srcset' value if there is more than one source.
if ( ! $src_matched || ! is_array( $sources ) || count( $sources ) < 2 ) { 
	return false;
}
战后总结

把改好的代码让群里的小伙伴改好之后,问题成功的解决了  ,之所以对这个 count() 报错定位快,是因为在制作 Dobby 主题的时候,也同样遇到了一个 count() 的问题,不过调用的函数是不一样的,当时发现问题之后就提了一个 Ticket ,答复在后期版本会兼容这个问题,所以大家如果在使用 WordPress 4.9.4 或者之前的版本使用 PHP7.2 遇到同样问题的话,可以参考这里的方法修复,然后安心等待官方的修复版本。

免费资源网 - https://freexyz.cn/
返回顶部
顶部