从PHP 7.4升级到PHP 8出现XMLParser类重复声明致命错误

PHP 8.0 版本起，官方xml扩展内置了全局类XMLParser，PHP 7.4及更早版本不存在这个内置类，因此你之前自定义的同名类在7.4环境下可以正常运行，升级到8之后就会触发类名重复声明的致命错误。
另外你现有代码里的构造方法写法也不兼容PHP8：你之前为了兼容PHP7加了空的__construct方法，而旧的PHP4风格、和类同名的XMLParser()方法在PHP8中已经不会被识别为构造函数，就算解决了类名冲突，原来的XML初始化逻辑也不会执行，类会直接失效。

• 重命名自定义XML类
  把你代码里自定义的XMLParser类改成不和内置类冲突的名称，比如CustomXMLParser，同时全局搜索项目中所有实例化这个类的位置，把new XMLParser(参数)的写法统一替换成new CustomXMLParser(参数)。
• 修正构造方法逻辑
  删掉原来空的__construct方法和旧的同名构造方法，把初始化逻辑合并到标准的__construct方法中，修正后的完整类代码如下：

class CustomXMLParser 
{
    var $filename;
    var $xml;
    var $data;

    public function __construct($xml_file)
    {
        $this->filename = $xml_file;
        $this->xml = xml_parser_create();
        xml_set_object($this->xml, $this);
        xml_set_element_handler($this->xml, 'startHandler', 'endHandler');
        xml_set_character_data_handler($this->xml, 'dataHandler');
        $this->parse($xml_file);
    }

    function parse($xml_file)
    {
        if (!($fp = fopen($xml_file, 'r'))) 
        {
            die('Cannot open XML data file: '.$xml_file);
            return false;
        }

        $bytes_to_parse = 512;

        while ($data = fread($fp, $bytes_to_parse)) 
        {
            $parse = xml_parse($this->xml, $data, feof($fp));
       
            if (!$parse) 
            {
                die(sprintf("XML error: %s at line %d",
                xml_error_string(xml_get_error_code($this->xml)),
                   xml_get_current_line_number($this->xml)));
                xml_parser_free($this->xml);
            }
        }

        return true;
    }

    function startHandler($parser, $name, $attributes)
    {
        $data['name'] = $name;
        if ($attributes) 
        {
            $data['attributes'] = $attributes; 
        }
        $this->data[] = $data;
    }

    function dataHandler($parser, $data)
    {
        if ($data = trim($data)) 
        {
            $index = count($this->data) - 1;
            if(isset($this->data[$index]['content'])) 
            $this->data[$index]['content'] .= $data;
            else $this->data[$index]['content'] = $data;
        }
    }

    function endHandler($parser, $name)
    {
        if (count($this->data) > 1) 
        {
            $data = array_pop($this->data);
            $index = count($this->data) - 1; 
            $this->data[$index]['child'][] = $data;
        }
    }
}

• 代码修改完成后，如果你的共享主机开启了OPcache，需要刷新OPcache缓存，避免旧代码缓存导致报错持续存在
• 项目中其他用面向过程方式调用的xml相关函数（比如xml_parser_create、xml_parse等）不需要修改，这部分逻辑在PHP8下可以正常运行

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