如何安装ProcessMaker/docker-executor-python及解决安装报错问题

问题概述 #

• 已部署运行开源版ProcessMaker，根据官方文档，Script Executor for Python 1.0.0属于开源组件，但系统中未找到该执行器
• 已成功安装processmaker/docker-executor-node和processmaker/docker-executor-php，但GitHub搜索不到Python版本的执行器包
• 尝试在Docker构建文件中添加以下命令时报错：

  RUN composer require processmaker/docker-executor-python --ignore-platform-reqs
  RUN php artisan package-skeleton:install
  

  错误信息：

  In PackageDiscoveryTrait.php line 376:
  Could not find a matching version of package processmaker/docker-executor-python. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (dev)

解决方案 #

1. 修正包名称 #

官方文档的包名可能存在笔误，ProcessMaker的Python执行器正确包名为processmaker/docker-executor-python3（适配Python3）。替换Docker构建命令为：

RUN composer require processmaker/docker-executor-python3 --ignore-platform-reqs
RUN php artisan package-skeleton:install

2. 手动安装未公开的包 #

若上述包名仍无法找到，说明该组件可能未在Packagist公开，需手动从ProcessMaker核心仓库构建：

• 克隆ProcessMaker官方仓库，定位到packages/docker-executor-python3模块
• 将该模块复制到你的ProcessMaker项目的packages目录下
• 在项目根目录执行以下命令：

  composer dump-autoload
  php artisan package:discover
  php artisan package-skeleton:install
  

3. 指定版本约束 #

若遇到版本不匹配问题，需明确指定与你的ProcessMaker版本对应的执行器版本。例如你的ProcessMaker为4.x系列，执行：

RUN composer require processmaker/docker-executor-python3:^4.0 --ignore-platform-reqs
RUN php artisan package-skeleton:install

验证步骤 #

安装完成后重启ProcessMaker服务，进入后台管理界面：

• 进入Admin > Script Executors
• 确认Python执行器已出现在列表中，且状态为可用

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