PHP中使用CURL发送文件失败：未发送文件仅发送字符串

别慌，我来帮你搞定这个问题！你遇到的情况几乎都是因为没用到curl专门处理文件上传的参数，误把文件名当成普通字符串传出去了。下面给你拆解正确操作方式和避坑点：

正确的文件上传姿势 #

最常用也最稳妥的方法是用-F（或--form）参数，它会模拟浏览器的表单文件上传行为：

curl -F "file=@/绝对路径/你的文件名.ext" 目标上传URL

这里的@符号是核心！它告诉curl：“后面跟着的是本地文件的路径，把这个文件的内容传上去”，而不是把/绝对路径/你的文件名.ext这段文字当成字符串发送。

如果需要指定文件的MIME类型（比如上传图片、音频时），可以在路径后面追加类型说明：

curl -F "avatar=@/home/user/me.jpg;type=image/jpeg" https://your-api.com/profile/upload

你大概率踩过的坑 #

很多人会误用-d（或--data）参数，这个参数是用来发送普通表单字符串数据的，比如：

# ❌ 错误示例：这会把"myfile.txt"当成字符串发送，完全不会读取本地文件内容
curl -d "file=myfile.txt" https://example.com/upload

用-d的话，curl只会把等号后面的文本原样发出去，根本不会去加载本地文件。

验证上传是否成功的小技巧 #

如果想确认curl确实在发送文件，可以加上-v参数开启verbose模式，查看请求详情：

curl -v -F "file=@/path/to/your/file.txt" https://example.com/upload

在输出里你能看到类似Content-Disposition: form-data; name="file"; filename="file.txt"的内容，这就说明文件已经被正确识别并上传了。

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