Linux（树莓派）下PHP调用Node.js脚本时require()失败的解决方法

这大概率和权限问题或者PHP执行环境的路径/环境变量差异有关，毕竟Windows和Linux的权限模型、进程运行环境差别很大，咱们一步步来排查解决：

1. 先确认权限问题（最可能的原因） #

在Raspbian上，PHP通常是以www-data用户身份运行的，而你直接在控制台执行node脚本时用的是自己的用户（比如pi），两者的权限范围不一样：

• 首先检查/home/pi/node_modules/MathJax-node目录及其文件的权限，执行这条命令（在控制台）：

  ls -l /home/pi/node_modules/MathJax-node/
  

  看看文件的所有者是不是pi，而www-data有没有读权限。
• 给www-data赋予访问该目录的权限，最安全的方式是修改所有者：

  sudo chown -R www-data:www-data /home/pi/node_modules/MathJax-node/
  

  或者如果不想修改所有者，也可以给其他用户加读权限：

  sudo chmod -R o+r /home/pi/node_modules/MathJax-node/
  

• 别忘了检查/home/pi目录的权限！如果/home/pi的权限是700（只有自己能访问），那www-data连进入这个目录都做不到，需要改成755：

  sudo chmod 755 /home/pi
  

2. 排查PHP执行环境的路径差异 #

直接在控制台跑node时，用的是当前用户的环境变量，但PHP的exec调用用的是www-data的环境，可能存在路径不一致的问题：

• 先确认PHP能找到的node路径，在PHP里加一行测试：

  echo exec('which node');
  

  把输出的绝对路径替换到你的exec命令里，比如输出是/usr/bin/node，那命令改成：

  $string = '/usr/bin/node /home/pi/node_modules/MathJax-node/minimathjax.js';
  

• 另外，虽然你的脚本里用的是绝对路径require("/home/pi/node_modules/MathJax-node/lib/mj-page.js")，但如果MathJax-node内部还有相对路径的require，也可能因为工作目录不同出问题，可以在脚本开头加上：

  process.chdir('/home/pi/node_modules/MathJax-node/');
  

  把工作目录切换到脚本所在文件夹。

3. 捕获错误信息，精准定位问题 #

exec默认只返回最后一行输出，而require失败的错误信息可能被输出到stderr（标准错误流），你看不到。修改PHP代码捕获所有输出和错误：

$string = 'node /home/pi/node_modules/MathJax-node/minimathjax.js 2>&1';
exec($string, $output, $return_var);
print_r($output);
echo "<br>Return code: $return_var";

这样就能看到具体的错误提示，比如EACCES: permission denied（权限不足）或者Cannot find module（路径问题），方便你精准解决。

4. 其他可能的排查点 #

• 检查node版本：控制台执行node -v，PHP里执行exec('node -v')，看看两个版本是否一致。如果版本差异大，MathJax-node可能不兼容。
• 检查安全限制：如果Raspbian开启了AppArmor或者SELinux，可能限制了PHP访问node模块目录，需要调整对应的安全规则。

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