如何通过环境变量让PHP自动切换对应子域名的locales目录路径？

项目架构 #

- root
  - locales
  - subdomain1
    - locales
  - subdomain2
    - locales
  - .env

需求逻辑 #

• 在.env中设置环境变量DOMAIN=XXX
  • 当DOMAIN未设置时，使用/root/locales目录
  • 当DOMAIN=subdomain1时，使用/root/subdomain1/locales目录

当前.env配置为DOMAIN=subdomain1，项目中存在数千处require_once('/root/locales/XXX')的代码引用，且无法手动修改这些引用，需要实现自动将这些引用指向/root/subdomain1/locales/XXX的效果。

尝试无效的方法 #

在index.php中执行符号链接创建代码，但未生效：

// 从.env变量中获取"subdomain1"
symlink('/root/locales/XXX', '/root/subdomain1/locales/XXX');

询问：symlink用法是否有误？或者有无其他无需修改大量引用代码的实现方式？

1. 修正symlink用法（推荐方案） #

你当前的symlink写法搞反了目标资源和链接路径的顺序。PHP的symlink()函数语法为：

symlink(string $target, string $link): bool

• $target：要指向的真实文件/目录（即你实际想用的/root/subdomain1/locales）
• $link：要创建的符号链接路径（即被代码引用的/root/locales）

正确的实现代码：

$domain = getenv('DOMAIN');
// 仅当DOMAIN存在且对应目录有效时执行
if ($domain && is_dir("/root/{$domain}/locales")) {
    $realLocalesPath = "/root/{$domain}/locales";
    $linkLocalesPath = "/root/locales";

    // 先删除已存在的locales链接（避免冲突）
    if (is_link($linkLocalesPath)) {
        unlink($linkLocalesPath);
    }
    // 创建目录级符号链接，一次性替换所有子文件路径
    symlink($realLocalesPath, $linkLocalesPath);
}

注意事项：

• 执行PHP的进程需要拥有创建/删除符号链接的权限
• 直接给整个locales目录创建链接，无需逐个处理单个文件

2. PHP运行时拦截方案（无权限创建链接时使用） #

如果服务器权限限制无法创建符号链接，可以通过自定义流包装器拦截绝对路径请求，自动替换目标路径：

步骤1：创建拦截脚本（locales_override.php） #

class LocalesOverrideStream {
    private $handle;

    public function stream_open($path, $mode, $options, &$opened_path) {
        $domain = getenv('DOMAIN');
        // 替换/root/locales路径到对应子域名目录
        if ($domain && str_starts_with($path, '/root/locales/')) {
            $targetPath = str_replace('/root/locales/', "/root/{$domain}/locales/", $path);
            $this->handle = fopen($targetPath, $mode, $options);
            return $this->handle !== false;
        }
        // 非locales路径正常处理
        $this->handle = fopen($path, $mode, $options);
        return $this->handle !== false;
    }

    // 实现流操作必需的方法
    public function stream_read($count) { return fread($this->handle, $count); }
    public function stream_write($data) { return fwrite($this->handle, $data); }
    public function stream_tell() { return ftell($this->handle); }
    public function stream_eof() { return feof($this->handle); }
    public function stream_seek($offset, $whence = SEEK_SET) { return fseek($this->handle, $offset, $whence); }
    public function stream_close() { return fclose($this->handle); }
    public function stream_stat() { return fstat($this->handle); }

    public function url_stat($path, $flags) {
        $domain = getenv('DOMAIN');
        if ($domain && str_starts_with($path, '/root/locales/')) {
            $path = str_replace('/root/locales/', "/root/{$domain}/locales/", $path);
        }
        return stat($path);
    }
}

// 覆盖file://协议，实现路径拦截
stream_wrapper_unregister('file');
stream_wrapper_register('file', 'LocalesOverrideStream');

步骤2：自动加载拦截脚本 #

通过服务器配置让所有PHP请求自动加载该脚本：

• Apache：在项目根目录.htaccess中添加

php_value auto_prepend_file "/root/locales_override.php"

• Nginx：在站点配置中添加

fastcgi_param PHP_VALUE "auto_prepend_file=/root/locales_override.php";

3. 服务器层面配置方案 #

如果以上PHP方案都无法生效，可以直接在服务器层面做路径重写：

• Nginx配置示例：

map $env:DOMAIN $locales_root {
    default /root/locales;
    subdomain1 /root/subdomain1/locales;
    subdomain2 /root/subdomain2/locales;
}

server {
    # 其他配置项...
    location ~* /root/locales/(.*)$ {
        root $locales_root;
        try_files /$1 =404;
    }
}

• Apache配置示例：

SetEnvIf DOMAIN subdomain1 LOCALES_ROOT=/root/subdomain1/locales
SetEnvIf DOMAIN subdomain2 LOCALES_ROOT=/root/subdomain2/locales
SetEnvIf DOMAIN "" LOCALES_ROOT=/root/locales

RewriteEngine On
RewriteRule ^/root/locales/(.*)$ %{ENV:LOCALES_ROOT}/$1 [L]

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