Electron应用中如何查找PHP可执行文件路径？

问题根源 #

Electron打包后的进程环境变量（尤其是PATH）和开发环境存在差异，系统安装的PHP不在打包后进程的PATH搜索范围内，导致直接调用php会提示找不到。

错误操作分析 #

1. 使用$(which php)的问题：child_process.spawn默认不启动shell，无法解析这种shell替换语法；即使开启shell: true，打包后shell的环境PATH同样可能缺失PHP路径，且跨平台（Windows/类Unix）的shell语法不兼容，容易出问题。
2. real-executable-path包失效：该包依赖进程的PATH查找可执行文件，打包后PATH被修改，自然找不到PHP。

可行解决方案 #

方案1：手动扩展进程的PATH环境变量

针对不同平台，将PHP常见的安装路径添加到进程PATH中，确保spawn能找到PHP二进制文件：

const { spawn } = require('child_process');

// 构造包含PHP可能路径的自定义PATH
let customPath = process.env.PATH;
const platform = process.platform;

if (platform === 'darwin' || platform === 'linux') {
  // 类Unix系统（Mac/Linux）常见PHP路径
  customPath += ':/usr/bin:/usr/local/bin:/opt/homebrew/bin';
} else if (platform === 'win32') {
  // Windows系统常见PHP路径（如独立安装、XAMPP集成）
  customPath += ';C:\\php;C:\\xampp\\php;C:\\wamp\\bin\\php\\php8.2.0';
}

// 调用PHP时传入自定义环境变量
const phpProcess = spawn('php', ['/path/to/artisan'], {
  env: {
    ...process.env,
    PATH: customPath
  }
});

// 监听进程输出和错误
phpProcess.stdout.on('data', (data) => {
  console.log(`输出：${data}`);
});

phpProcess.stderr.on('data', (data) => {
  console.error(`错误：${data}`);
});

方案2：让用户手动配置PHP路径

考虑到不同用户的PHP安装位置差异极大（比如自定义路径、集成环境路径），最可靠的方式是在应用内添加设置界面，让用户选择PHP二进制文件的绝对路径，然后直接使用该路径调用：

const { spawn } = require('child_process');

// 假设从应用设置中获取用户配置的PHP路径
const phpPath = '/usr/local/bin/php'; // 或者Windows的'C:\\php\\php.exe'

const phpProcess = spawn(phpPath, ['/path/to/artisan']);

方案3：打包PHP二进制文件到应用内

如果需要完全脱离系统环境的依赖，可以将PHP的二进制文件（对应平台版本）打包到Electron应用的资源目录中，然后通过相对路径调用：

1. 将对应平台的PHP二进制文件放入项目的resources目录；
2. 打包后通过app.getAppPath()获取应用安装路径，拼接PHP的相对路径：

const { spawn } = require('child_process');
const { app } = require('electron');
const path = require('path');

// 获取应用内PHP二进制文件的路径
const phpPath = path.join(app.getAppPath(), 'resources', process.platform === 'win32' ? 'php.exe' : 'php');

const phpProcess = spawn(phpPath, ['/path/to/artisan']);

注意：这种方式需要为每个目标平台准备对应的PHP二进制文件，会增加应用包体积。

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