如何在PHP8环境下用Composer初始化Zend1项目并解决语法报错

方案1：改用社区维护的PHP 8兼容分支 #

官方zendframework/zendframework1的1.12版本原生不支持PHP 8.x，可替换为社区维护的兼容分支zfcampus/zf1，该分支已修复包括大括号语法在内的PHP 8适配问题：

• 修改composer.json中的依赖项：

  {
    "require": {
      "zfcampus/zf1": "^1.12.29"
    }
  }
  

• 执行composer update更新依赖
• 重新运行初始化命令：./vendor/zfcampus/zf1/bin/zf.sh create project app

方案2：临时切换PHP版本完成初始化 #

如果必须使用官方包，可临时切换到PHP 7.x版本执行初始化操作：

• 通过PHP版本管理工具（如phpbrew、asdf）或系统多版本PHP切换至PHP 7.4
• 运行./vendor/zendframework/zendframework1/bin/zf.sh create project app完成项目初始化
• 初始化完成后切回PHP 8.1，后续可通过代码适配或批量修复工具处理项目运行时的语法问题

方案3：用Composer补丁工具自动修复 #

使用cweagans/composer-patches工具，无需手动修改包内文件即可自动应用语法修复补丁：

1. 安装补丁工具：

   composer require cweagans/composer-patches --dev
   

2. 创建本地补丁文件：
   • 找到vendor/zendframework/zendframework1/library/Zend/Tool/Project/Provider/ApplicationConfigFile.php
   • 将所有{$xxx}形式的数组/字符串偏移语法替换为标准的$xxx形式（比如把{$this->_config['applicationDirectory']}改成$this->_config['applicationDirectory']）
   • 在项目根目录新建patches文件夹，将修改后的代码差异保存为ApplicationConfigFile.php.patch
3. 在composer.json中配置补丁：

   {
     "extra": {
       "patches": {
         "zendframework/zendframework1": {
           "Fix curly brace syntax in ApplicationConfigFile.php": "patches/ApplicationConfigFile.php.patch"
         }
       }
     }
   }
   

4. 执行composer install，补丁会自动应用到包文件中，后续composer update也会保留该补丁

内容的提问来源于stack exchange，提问作者A.Dumas