本教程详细介绍了如何使用php通过discord webhook发送文件附件。内容涵盖了使用curl处理本地文件上传的正确方法，包括`realpath()`的应用、`multipart/form-data`的正确配置，以及如何处理来自外部url的文件，旨在帮助开发者避免常见的“cannot send an empty message”错误。
Discord Webhook文件附件发送指南
Discord Webhook提供了一种向Discord频道发送消息的便捷方式，但当涉及到发送文件附件时，开发者可能会遇到一些挑战。本文将深入探讨如何使用PHP的cURL库正确地通过Discord Webhook上传文件，并解决常见的“Cannot send an empty message”错误。
理解“Cannot send an empty message”错误
在使用PHP cURL尝试通过Discord Webhook发送文件时，常见的错误响应是{"message": "Cannot send an empty message", "code": 50006}。这个错误通常不是因为消息内容为空，而是因为文件上传的请求体格式不正确，导致Discord无法识别文件数据。
导致此问题的主要原因有两个：
文件路径不正确：curl_file_create()函数需要文件的绝对路径。如果只提供相对路径，而PHP脚本的执行目录与文件所在目录不一致，它将无法找到文件。multipart/form-data请求体构造不当：当上传文件时，HTTP请求的Content-Type必须是multipart/form-data。PHP的http_build_query()函数会将数据编码为application/x-www-form-urlencoded格式，这与文件上传所需的multipart/form-data不兼容。此外，手动设置Content-Type头时，如果未包含正确的boundary，也会导致问题。正确上传本地文件
要正确地通过Discord Webhook上传本地文件，需要遵循以下步骤：
立即学习“PHP免费学习笔记（深入）”；
1. 确保文件路径正确
使用realpath()函数获取文件的绝对路径。这可以确保curl_file_create()函数能够准确地找到并读取文件。
巧文书 巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。
8 查看详情 
2. 配置cURL请求体
将包含文件数据的数组直接传递给CURLOPT_POSTFIELDS选项，而不是使用http_build_query()。当CURLOPT_POSTFIELDS是一个数组且包含CURLFile对象时，cURL会自动处理multipart/form-data编码，并设置正确的Content-Type头及边界。因此，不需要手动设置Content-Type: multipart/form-data头。3. 示例代码
以下是使用PHP上传本地文件到Discord Webhook的正确实现：
<?php// 替换为您的Discord Webhook URL$webhookUrl = "YOUR_DISCORD_WEBHOOK_URL_HERE";// 确保图片文件存在于脚本可访问的路径$imagePath = "image.gif"; // 假设image.gif在与脚本相同的目录下// 检查文件是否存在if (!file_exists($imagePath)) { die("错误：文件不存在于指定路径: " . $imagePath);}// 获取文件的绝对路径$absoluteImagePath = realpath($imagePath);// 准备POST数据$postData = [ // 消息内容 (可选) "content" => "Hello World! 这是一个文件附件。", // 用户名 (可选，会覆盖Webhook默认用户名) "username" => "文件上传机器人", // 文件上传字段 // 第一个参数是文件的绝对路径 // 第二个参数是文件的MIME类型 // 第三个参数是Discord接收到的文件名 "file" => curl_file_create($absoluteImagePath, 'image/gif', 'image.gif')];// 初始化cURL会话$ch = curl_init();// 设置cURL选项curl_setopt($ch, CURLOPT_URL, $webhookUrl);curl_setopt($ch, CURLOPT_POST, true);// 当CURLOPT_POSTFIELDS是数组且包含CURLFile对象时，cURL会自动设置multipart/form-data// 因此，不需要手动设置Content-Type头// curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: multipart/form-data']); // 错误示范，应移除curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应内容而不是直接输出curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 在开发环境中可能需要，生产环境应设为true以确保安全// 直接传递数组作为POST数据curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);// 执行cURL请求$response = curl_exec($ch);// 检查是否有cURL错误if (curl_errno($ch)) { echo 'cURL错误: ' . curl_error($ch);} else { // 打印响应 echo "Discord Webhook响应:\n"; var_dump($response);}// 关闭cURL会话curl_close($ch);?>登录后复制代码解析：
$webhookUrl: 您的Discord Webhook URL。$imagePath: 您要上传的本地图片文件名。realpath($imagePath): 这是解决文件路径问题的关键。它将相对路径转换为服务器上的绝对路径。curl_file_create(...): 创建一个CURLFile对象，指示cURL这是一个文件上传。$postData数组：包含了文本消息和文件对象。CURLOPT_POSTFIELDS, $postdata: 直接将$postData数组传递给cURL，让cURL自动构建multipart/form-data请求。CURLOPT_HTTPHEADER：已移除手动设置Content-Type: multipart/form-data，因为cURL会自行处理。上传远程URL文件
如果文件不在您的服务器上，而是位于某个远程URL，您需要先将该文件下载到您的服务器的临时位置，然后再按照上述方法上传。
1. 远程文件处理流程
从远程URL下载文件到本地临时文件。使用临时文件的路径调用curl_file_create()。上传文件。上传完成后，删除本地临时文件。2. 示例代码
<?php$webhookUrl = "YOUR_DISCORD_WEBHOOK_URL_HERE";$remoteFileUrl = "https://example.com/some_remote_image.png"; // 替换为远程文件URL$tempFileName = "temp_upload_" . uniqid() . ".png"; // 生成唯一的临时文件名// 1. 从远程URL下载文件到本地临时文件$fileContent = file_get_contents($remoteFileUrl);if ($fileContent === false) { die("错误：无法从远程URL下载文件: " . $remoteFileUrl);}file_put_contents($tempFileName, $fileContent);// 确保临时文件已创建且存在if (!file_exists($tempFileName)) { die("错误：无法创建临时文件: " . $tempFileName);}// 获取临时文件的绝对路径$absoluteTempPath = realpath($tempFileName);// 准备POST数据$postData = [ "content" => "这是一个从远程URL上传的文件。", "username" => "远程文件机器人", // 使用临时文件的绝对路径 "file" => curl_file_create($absoluteTempPath, 'image/png', 'remote_image.png')];// 初始化cURL会话$ch = curl_init();curl_setopt($ch, CURLOPT_URL, $webhookUrl);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);// 执行cURL请求$response = curl_exec($ch);// 检查是否有cURL错误if (curl_errno($ch)) { echo 'cURL错误: ' . curl_error($ch);} else { echo "Discord Webhook响应:\n"; var_dump($response);}// 关闭cURL会话curl_close($ch);// 4. 上传完成后，删除本地临时文件if (file_exists($tempFileName)) { unlink($tempFileName); echo "临时文件 " . $tempFileName . " 已删除。\n";}?>登录后复制注意事项与最佳实践
错误处理：在实际应用中，务必对curl_exec()的返回值进行检查，并使用curl_errno()和curl_error()来捕获和处理潜在的cURL错误。文件类型与MIME类型：curl_file_create()的第二个参数应准确反映文件的MIME类型（例如image/gif, application/pdf）。不正确的MIME类型可能导致Discord无法正确显示文件。文件大小限制：Discord对通过Webhook上传的文件有大小限制（通常为8MB，Nitro用户可达50MB或100MB）。请确保您上传的文件不超过这些限制。Webhook速率限制：Discord对Webhook请求有速率限制。频繁发送大量请求可能会导致您的请求被暂时阻止。请查阅Discord API文档了解具体限制。安全性：在生产环境中，始终将CURLOPT_SSL_VERIFYPEER设置为true，以验证SSL证书，确保通信安全。当处理用户上传的文件时，务必对文件进行验证（类型、大小、内容），以防止恶意文件上传。临时文件处理：确保临时文件存储在一个安全的、可被脚本写入和删除的目录，并在使用后立即删除，以避免磁盘空间浪费和潜在的安全风险。可读性与维护性：为您的Webhook URL、文件路径等配置项使用常量或环境变量，提高代码的可读性和可维护性。总结
通过本教程，您应该已经掌握了使用PHP通过Discord Webhook发送文件附件的正确方法。关键在于理解multipart/form-data请求的构造，正确使用realpath()获取文件路径，以及避免http_build_query()对文件上传造成干扰。遵循这些指导原则，您可以有效地将文件内容集成到您的Discord通知流程中。
以上就是PHP使用Discord Webhook发送文件附件教程的详细内容，更多请关注php中文网其它相关文章！
