phpEnv 无法直接安装 MinIO，需单独运行 MinIO Server 并在 PHP 中通过 Composer 安装 minio/minio-php SDK；关键配置包括 use_ssl=false（本地 HTTP）、正确设置 curl.cainfo 及时间同步。
phpEnv 是 Windows 下的 PHP 集成环境（类似 XAMPP、WAMP），它默认不带 MinIO 服务，也不预装任何对象存储 SDK。你无法直接“用 phpEnv 安装 MinIO”，因为 MinIO 是一个独立的 Go 二进制服务进程，不是 PHP 扩展或 Apache 模块。要让 phpEnv 环境能对接 MinIO，实际要做的是：在系统层面运行 MinIO Server，再在 phpEnv 的 PHP 中通过 Composer 安装并调用 minio/minio-php SDK。
MinIO Server 怎么在 Windows 上跑起来（非 phpEnv 内置）
MinIO 不依赖 phpEnv，必须单独下载和启动：
- 去 min.io/download?platform=windows 下载
minio.exe - 新建目录如
C:\minio-data，作为数据根目录 - 以管理员身份打开 CMD 或 PowerShell，执行：
minio.exe server C:\minio-data --console-address :9001
（--console-address是 Web 控制台端口，避免和 phpEnv 的 80/443 冲突） - 访问
http://localhost:9001，用默认账号minioadmin/minioadmin登录
⚠️ 注意：minio.exe 进程需保持运行；关掉 CMD 窗口 = MinIO 停止。如需后台运行，建议用 NSSM 封装为 Windows 服务，或改用 Docker Desktop（更稳定）。
phpEnv 的 PHP 怎么装 minio/minio-php SDK
确保 phpEnv 的 PHP CLI 可用（比如 C:\phpenv\versions\8.2.12\php.exe），然后在你的项目目录执行：
立即学习“PHP免费学习笔记（深入）”；
composer require minio/minio-php
安装成功后检查：vendor/minio/minio-php/src/Minio/MinioClient.php 是否存在。若报 Could not find package minio/minio-php：
- 先运行
composer clear-cache - 国内用户可临时切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 别误装
gusijin/minio-php-sdk或aws/aws-sdk-php—— 前者是过时社区包，后者虽支持 S3 兼容但对 MinIO 的 STS、临时凭证等特性支持不完整
PHP 脚本连不上 MinIO 的常见原因和 fix
即使 SDK 装好了，new MinioClient([...]) 初始化失败，大概率卡在这几个点：
-
SSL certificate problem: unable to get local issuer certificate：phpEnv 自带的 cURL 没配 CA 证书。打开 phpEnv 对应版本的php.ini（如C:\phpenv\versions\8.2.12\php.ini），取消注释并修正路径：curl.cainfo = "C:/phpenv/versions/8.2.12/cacert.pem"
，然后从 curl.se/ca/cacert.pem 下载证书保存到该路径 -
InvalidAccessKeyId或SignatureDoesNotMatch：最常见是use_ssl参数值和 MinIO 实际协议不一致。本地默认 HTTP 启动，use_ssl必须设为false；如果用了https://endpoint（比如反向代理了 HTTPS），才设true - 时钟偏差 > 15 秒：MinIO 严格校验请求时间戳。Windows 时间若不准（尤其虚拟机或休眠唤醒后），会直接拒绝请求。运行
w32tm /resync强制同步时间
phpEnv 下测试上传是否真通了
写个最小可测脚本 test-minio.php 放在 phpEnv 的 web 目录（如 C:\phpenv\www\），用浏览器访问或 CLI 执行：
<?php
require 'vendor/autoload.php';
use Minio\MinioClient;
$client = new MinioClient([
'endpoint' => 'localhost:9000',
'access_key' => 'minioadmin',
'secret_key' => 'minioadmin',
'use_ssl' => false, // 关键！本地 HTTP 必须 false
]);
try {
$client->listBuckets();
echo "✅ 连接成功，可列出存储桶";
} catch (Exception $e) {
echo "❌ 失败：" . $e->getMessage();
}
?>
这个脚本只验证连接，不涉及文件 IO。真正上传前，先确认它返回 ✅ —— 否则后面所有操作都是空谈。很多问题其实就卡在 use_ssl 和证书路径这两个地方，反复检查比重装 SDK 有用得多。
