Windows XAMPP PHP8.1.10环境下PEAR安装报错求助

遇到的问题 #

• 执行官方手册安装步骤时，出现phar文件加载错误：

  Fatal error: Uncaught Error: Failed opening required 'phar://go-pear.phar/index.php' (include_path='C:\xampp_latest\php\PEAR') in C:\xampp_latest\php\go-pear.phar:1284 Stack trace: #0 {main} thrown in C:\xampp_latest\php\go-pear.phar on line 1284
  

• 尝试第三方解决方案后，出现大括号语法弃用错误：

  PHP Fatal error:  Array and string offset access syntax with curly braces is no longer supported in C:\xampp_latest\php\go-pear.php on line 1182
  

• 修改大括号为方括号后，又出现错误处理函数参数不匹配：

  PHP Fatal error:  Uncaught ArgumentCountError: Too few arguments to function error_handler(), 4 passed and exactly 5 expected in C:\xampp_latest\php\pear\pearcmd.php:446
  Stack trace:
  #0 [internal function]: error_handler(8192, 'trim(): Passing...', 'C:\\xampp_latest...', 152)
  #1 C:\xampp_latest\php\pear\PEAR\XMLParser.php(152): trim(NULL)
  #2 C:\xampp_latest\php\pear\PEAR\XMLParser.php(166): PEAR_XMLParser->postProcess(NULL, 'options')
  #3 [internal function]: PEAR_XMLParser->endHandler(Object(XMLParser), 'options')
  #4 C:\xampp_latest\php\pear\PEAR\XMLParser.php(102): xml_parse(Object(XMLParser), '<commands versi...')
  #5 C:\xampp_latest\php\pear\PEAR\Command.php(247): PEAR_XMLParser->parse('<commands versi...')
  #6 C:\xampp_latest\php\pear\PEAR\Command.php(302): PEAR_Command::registerCommands()
  #7 C:\xampp_latest\php\pear\pearcmd.php(54): PEAR_Command::getCommands()
  #8 {main}
    thrown in C:\xampp_latest\php\pear\pearcmd.php on line 446
  

解决步骤 #

1. 下载适配PHP版本的最新PEAR安装包 #

旧版go-pear.phar/go-pear.php不兼容PHP 7.4+的语法变化（比如大括号数组访问弃用、错误处理函数参数调整），直接替换为官网最新的安装包覆盖PHP目录下的旧文件。

2. 临时设置include_path执行安装 #

以管理员身份打开命令提示符，切换到C:\xampp_latest\php目录，执行：

php -d include_path=".;C:\xampp_latest\php\PEAR" go-pear.phar

强制指定include_path，解决phar文件加载失败的问题。

3. 用Composer替代安装（推荐） #

如果上述步骤仍报错，直接用Composer管理PEAR包，兼容性更好：

1. 确保已安装Composer
2. 在项目目录执行对应命令安装所需PEAR包，例如：

   composer require pear/pear-core
   

4. 手动修复错误处理函数（应急方案） #

若必须使用旧版PEAR，修改pearcmd.php第446行的error_handler函数，给最后一个参数设置默认值：

function error_handler($errno, $errstr, $errfile, $errline, $context = null) {
    // 保留原有函数内容
}

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