PHP 8.3 对接 Gemini 实现图文生成必须启用 cURL、JSON、OpenSSL 扩展，推荐启用 fileinfo、mbstring、zlib，GD 或 Imagick 仅在需本地图像预处理时启用。
PHP 8.3 对接 Gemini 实现图文生成（如上传图片分析、文生图、图文混合推理），**本身不依赖 PHP 图像扩展来调用 Gemini API**，因为 Gemini 的多模态能力由 Google 云端模型处理，PHP 只需负责构造请求、上传文件（Base64 或 multipart）、解析响应。但要让整个流程稳定、安全、可扩展，以下扩展和配置是实际生产中**必须开启或强烈推荐启用**的：
1. 必须启用的底层基础扩展
这些是发起 HTTPS 请求、处理 JSON 和二进制数据的刚性依赖：
-
cURL 扩展：Gemini 官方 PHP 客户端（
google-gemini-php/client）默认使用 cURL 发送带文件上传的 multipart 请求（尤其是传图/传PDF）。需确认extension=curl已在php.ini中启用。 -
JSON 扩展：所有请求体与响应体均为 JSON 格式，
json_encode/json_decode是核心操作，PHP 8.3 默认内置，但需确保未被禁用（extension=json）。 -
OpenSSL 扩展：Gemini API 地址为
https://generativelanguage.googleapis.com，必须通过 TLS 加密通信，openssl是强制要求。
2. 推荐启用的辅助扩展（提升健壮性与功能完整性）
虽非绝对必需，但缺失会导致典型场景失败：
-
fileinfo 扩展：用于准确识别上传图片的真实 MIME 类型（如判断是 JPEG 还是伪装成 JPG 的 WebP）。Gemini API 对
Content-Type敏感，错误类型可能导致“invalid file”错误。 -
mbstring 扩展：处理中文提示词、多语言响应、Unicode 文件名时必备；Gemini 返回的文本含大量 UTF-8 特殊符号（如 emoji、数学符号），
mb_convert_encoding等函数常用于清洗与转义。 - zlib 扩展：启用后客户端可自动处理 Gzip 压缩响应（Gemini API 支持），降低带宽消耗，尤其在返回长文本或 Base64 图片数据时更明显。
3. 图像处理扩展（仅在本地预处理时需要）
如果你要在 PHP 层对用户上传的图片做**压缩、裁剪、格式转换、HDR 增强等预处理**（例如按装修分析指南要求统一调整为 ISO 200+HDR 模式再上传），才需启用：
立即学习“PHP免费学习笔记（深入）”；
- GD 扩展：轻量级通用图像处理，支持 JPEG/PNG/GIF，适合缩略图生成、简单水印、尺寸校验。
- Imagick 或 Gmagick 扩展：更强的多格式支持（含 PDF、WebP、TIFF）和专业控制（ICC 配置、色彩空间转换、高精度裁剪）。注意：Gmagick 是实验性扩展，PHP 8.3 中稳定性风险较高，生产环境更推荐 Imagick。
不需要为 Gemini 调用专门开启 exif、xml 或 soap 等扩展。重点始终是：cURL + OpenSSL + JSON 打底，fileinfo + mbstring 补全，GD/Imagick 按需选配。验证方式很简单：运行 php -m | grep -E "(curl|json|openssl|fileinfo|mbstring)"，确保关键项在列。
