Mac本地环境下Apache与命令行的AWS凭证读取异常问题

我之前也碰到过一模一样的问题——Apache的运行环境和你终端登录的用户会话是完全隔离的，所以它默认不会继承$HOME环境变量，这就导致AWS SDK找不到你用户目录下的凭证文件，反而去根目录瞎找了。下面给你几个可行的解决办法，按推荐优先级排序：

方法一：在Apache配置中设置HOME变量 #

这是最直接的解决方案，让Apache进程带上正确的HOME环境变量：

1. 找到Apache的配置文件：

   • 全局配置通常是/etc/httpd/httpd.conf（CentOS/RHEL）或者/etc/apache2/apache2.conf（Ubuntu/Debian）
   • 如果是针对单个站点，修改对应虚拟主机配置文件（比如/etc/apache2/sites-available/your-site.conf）

2. 添加SetEnv指令：
   在配置文件的合适位置（比如<VirtualHost>块内，或者全局的<Directory>块里）添加：

   SetEnv HOME /Users/username
   

   把/Users/username替换成你的实际用户目录路径。

3. 重启Apache服务：

   # Ubuntu/Debian系统
   sudo systemctl restart apache2
   
   # CentOS/RHEL系统
   sudo systemctl restart httpd
   

之后再通过浏览器运行脚本，getenv('HOME')应该就能返回正确路径，SDK也会自动去/Users/username/.aws/credentials读取凭证了。

方法二：在PHP脚本中手动指定凭证路径 #

如果不方便修改Apache配置，可以直接在创建S3客户端时指定凭证文件的绝对路径，绕开HOME变量的依赖：

$client = new \Aws\S3\S3Client([
    'profile' => 'default',
    'region' => 'eu-west-1',
    'version' => '2006-03-01',
    'credentials' => [
        'credentials_file' => '/Users/username/.aws/credentials',
    ],
]);

方法三：直接在脚本中设置HOME环境变量 #

另一种快速临时解决方案是在脚本开头手动设置HOME：

putenv('HOME=/Users/username');
// 之后再创建S3客户端
$client = new \Aws\S3\S3Client([
    'profile' => 'default',
    'region' => 'eu-west-1',
    'version' => '2006-03-01',
]);

方法四：使用环境变量传递凭证（生产环境推荐） #

如果是生产服务器，更安全的做法是直接在Apache配置中设置AWS的凭证环境变量，避免依赖本地文件：

SetEnv AWS_ACCESS_KEY_ID your-access-key-here
SetEnv AWS_SECRET_ACCESS_KEY your-secret-key-here

这样SDK会自动读取这些环境变量，不需要依赖.aws/credentials文件。

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