PHP 8.0中Undefined array key 1警告的代码兼容修复咨询

在PHP 8.0环境下运行代码时，遇到「Undefined array key 1」警告，触发警告的代码行是：

list( $delim, $page_index ) = explode( '/', $query_string['page'] );

完整函数代码如下：

function wpsc_remove_page_from_query_string( $query_string ) {

if ( false === strpos( implode( ' ', $query_string ), 'wpsc' ) ) {
    return $query_string;
}

if ( isset( $query_string['name'] ) && $query_string['name'] == 'page' && isset( $query_string['page'] ) ) {
    unset( $query_string['name'] );

    list( $delim, $page_index ) = explode( '/', $query_string['page'] );

    $query_string['paged'] = $page_index;
}

if ( isset( $query_string['wpsc-product'] ) && 'page' == $query_string['wpsc-product'] ) {
    $query_string['wpsc-product'] = '';
}

if ( isset( $query_string['name'] ) && is_numeric( $query_string['name'] ) ) {
    $query_string['paged'] = $query_string['name'];
    $query_string['page']  = '/'.$query_string['name'];

    $query_string['posts_per_page'] = get_option('wpsc_products_per_page');
}

if ( isset( $query_string['wpsc-product'] ) && is_numeric( $query_string['wpsc-product'] ) ) {
    unset( $query_string['wpsc-product'] );
}

if ( isset( $query_string['wpsc_product_category'] ) && 'page' == $query_string['wpsc_product_category'] ) {
    unset( $query_string['wpsc_product_category'] );
}

if ( isset( $query_string['name'] ) && is_numeric( $query_string['name'] ) ) {
    unset( $query_string['name'] );
}

if ( isset($query_string['term']) && 'page' == $query_string['term'] )  {
    unset( $query_string['term'] );
    unset( $query_string['taxonomy'] );
}

return $query_string;
}

问题原因 #

警告的核心原因是：explode('/')分割字符串后得到的数组元素数量不足2个，而list()强制解构两个变量。PHP 8.0开始对这类未定义数组键的情况抛出警告（PHP 7及以前会静默忽略，将未匹配的变量设为null）。

修复方案 #

方案1：限制分割次数并填充默认值 #

使用explode的第三个参数限制分割次数，再结合array_pad确保数组至少包含2个元素，避免解构失败：

// 替换原有的list行
$parts = explode('/', $query_string['page'], 2); // 最多分割成2部分
$parts = array_pad($parts, 2, null); // 不足2个元素时用null填充
list($delim, $page_index) = $parts;

// 或者更简洁的PHP 7.1+写法
[$delim, $page_index] = array_pad(explode('/', $query_string['page'], 2), 2, null);

方案2：先检查数组元素数量 #

先判断分割后的数组是否包含第二个元素，再进行解构，同时处理异常情况：

// 替换原有的list及后续赋值行
$parts = explode('/', $query_string['page']);
if (isset($parts[1])) {
    list($delim, $page_index) = $parts;
    $query_string['paged'] = $page_index;
} else {
    // 无页码时设置默认值，可根据需求调整
    $query_string['paged'] = 1;
}

额外PHP 8兼容性优化 #

• 改用PHP 7.1+支持的短数组解构语法[$a, $b]替代list()，更贴合现代PHP编码风格
• 条件判断中使用严格相等运算符===替代松散相等==，避免类型转换导致的逻辑错误，例如将$query_string['name'] == 'page'修改为$query_string['name'] === 'page'

内容的提问来源于stack exchange，提问作者Andy