php容器内无法通过curl连接宿主机docker socket，根本原因常是php-fpm工作进程权限不足（默认以www-data运行，无权访问/var/run/docker.sock），需调整fpm用户配置并启用root权限运行。
php容器内无法通过curl连接宿主机docker socket，根本原因常是php-fpm工作进程权限不足（默认以www-data运行，无权访问/var/run/docker.sock），需调整fpm用户配置并启用root权限运行。
在Docker环境中，PHP应用（尤其是使用Guzzle等HTTP客户端）常需通过Unix域套接字（/var/run/docker.sock）与Docker守护进程通信，实现容器管理、状态查询等功能。然而，即使确认docker.sock已正确挂载且命令行curl --unix-socket /var/run/docker.sock http://localhost/v1.40/containers/json可成功执行，PHP代码仍可能抛出 cURL error 7（Failed to connect to host） —— 这并非Guzzle或cURL配置错误，而是典型的权限隔离问题。
根本原因在于：官方PHP Docker镜像（如php:8.2-fpm）默认使用PHP-FPM管理Web请求，其worker进程由www-data用户启动。该用户不属于docker组，且无权读写/var/run/docker.sock（该文件通常属root:docker，权限为srw-rw----）。因此，即便cURL参数CURLOPT_UNIX_SOCKET_PATH设置正确，底层系统调用仍因权限拒绝而失败。
✅ 正确解决方案如下：
-
修改PHP-FPM用户配置
编辑FPM池配置文件（通常位于/usr/local/etc/php-fpm.d/www.conf），将user和group设为root：; /usr/local/etc/php-fpm.d/www.conf user = root group = root
-
启用root用户运行权限
启动PHP-FPM时必须添加-R（--allow-to-run-as-root）标志，否则FPM会主动拒绝以root身份启动：# Dockerfile 示例 FROM php:8.2-fpm COPY www.conf /usr/local/etc/php-fpm.d/www.conf CMD ["php-fpm", "-R"] # 关键：必须加 -R
或在docker run中显式指定：
立即学习“PHP免费学习笔记（深入）”；
docker run -v /var/run/docker.sock:/var/run/docker.sock:ro \ -v ./www.conf:/usr/local/etc/php-fpm.d/www.conf \ php:8.2-fpm php-fpm -R -
验证与安全提醒
修改后，原PHP代码即可正常工作：$client = new GuzzleHttp\Client(); $response = $client->request('GET', 'http://v1.40/containers/json', [ 'curl' => [CURLOPT_UNIX_SOCKET_PATH => '/var/run/docker.sock'] ]); $containers = json_decode($response->getBody(), true);
⚠️ 重要注意事项：
- 以root运行PHP-FPM存在安全风险，仅建议在可信的内部管理容器中使用（如CI/CD工具、运维看板），切勿用于面向公网的Web应用；
- 更安全的替代方案是将PHP容器用户加入docker组（需挂载/etc/group并确保组ID一致），但受限于Docker组权限模型，实践中常不如root + -R直接可靠；
- 始终通过-v /var/run/docker.sock:/var/run/docker.sock:ro以只读方式挂载socket，避免容器获得Docker守护进程的写权限。
综上，解决该问题的关键不在HTTP客户端配置，而在理解PHP-FPM的进程模型与Linux权限机制的交互。精准定位到www-data用户的权限瓶颈，并通过user=root与-R组合解法，即可稳定打通PHP与Docker API的通信链路。
