Debian 12上PHP8.2-FPM无法解析含希伯来语路径的PHP文件

问题复现 #

升级到Debian 12后，当PHP文件位于含希伯来语字符的路径（如/var/www/html/בדיקה/info.php）时，PHP 8.2-FPM会提示文件不存在，但同路径下的纯文本文件（如info.txt）可通过Apache正常访问；第三方编译的PHP 8.3-FPM则能正常处理这类文件。

排查与解决步骤 #

1. 检查PHP-FPM进程的Locale环境

Debian官方的PHP 8.2-FPM默认可能未配置支持希伯来语的UTF-8 Locale，导致无法正确解析非ASCII路径。

• 查看当前PHP-FPM进程的Locale：

  # 找到PHP-FPM主进程PID
  ps aux | grep php-fpm8.2 | head -n1
  # 替换[PID]为上一步得到的进程ID，查看环境变量
  cat /proc/[PID]/environ | tr '\0' '\n' | grep -E "(LANG|LC_ALL)"
  

• 如果输出中没有he_IL.UTF-8或类似UTF-8编码的希伯来语Locale，需要先生成并配置。

2. 生成并配置希伯来语Locale

• 生成Locale：

  locale-gen he_IL.UTF-8
  

• 系统全局更新Locale（可选，确保系统环境默认编码）：

  update-locale LANG=he_IL.UTF-8 LC_ALL=he_IL.UTF-8
  

3. 修改PHP-FPM池配置

编辑PHP-FPM的池配置文件（通常是/etc/php/8.2/fpm/pool.d/www.conf），添加Locale环境变量：

env[LANG] = he_IL.UTF-8
env[LC_ALL] = he_IL.UTF-8

4. 调整PHP字符编码配置

编辑/etc/php/8.2/fpm/php.ini，确保多字节字符串扩展（mbstring）的编码配置正确：

mbstring.language = Hebrew
mbstring.internal_encoding = UTF-8
mbstring.http_input = UTF-8
mbstring.http_output = UTF-8

5. 重启服务验证

• 重启PHP-FPM服务：

  systemctl restart php8.2-fpm
  

• 再次访问含希伯来语路径的PHP文件，或创建测试脚本验证路径识别：

  <?php
  // 输出当前工作目录
  echo "当前目录：" . getcwd() . "<br>";
  // 列出当前目录下的文件
  echo "目录文件列表：<br>";
  var_dump(scandir(__DIR__));
  ?>
  

补充说明 #

第三方编译的PHP 8.3-FPM正常工作，是因为PHP 8.3版本在非ASCII路径处理上做了优化，默认配置更友好；而Debian官方打包的PHP 8.2-FPM需要手动配置Locale和字符编码，才能支持希伯来语这类非拉丁字符的路径解析。

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