本文档详细介绍了如何使用 PHP 和 cURL 正确地将附件上传到 Trello 卡片。重点在于解决常见的上传文件大小不正确、文件名显示异常等问题，并提供经过验证的 PHP 代码示例，帮助开发者高效地实现附件上传功能，确保上传的文件能够正确显示文件名，并且文件内容完整无损。
使用 cURL 和 PHP 上传附件到 Trello 卡片
Trello 提供 API 允许开发者通过编程方式管理卡片，包括添加附件。使用 PHP 和 cURL 上传附件到 Trello 卡片，需要正确设置 cURL 选项，特别是 CURLOPT_POSTFIELDS。
以下代码示例展示了如何正确地使用 cURL 上传附件到 Trello 卡片：
<?php
if (!empty($_FILES)) {
for ($i = 0; $i < count($_FILES['file']['name']); $i++) {
$args = array(
'file' => new CurlFile(
$_FILES['file']['tmp_name'][$i],
$_FILES['file']['type'][$i],
$_FILES['file']['name'][$i]
),
'key' => 'YOUR_TRELLO_API_KEY',
'token' => 'YOUR_TRELLO_API_TOKEN',
'mimeType' => $_FILES['file']['type'][$i],
'name' => $_FILES['file']['name'][$i]
);
$chAttachments = curl_init();
curl_setopt($chAttachments, CURLOPT_URL, 'https://api.trello.com/1/cards/' . 'YOUR_CARD_ID' . '/attachments/');
curl_setopt($chAttachments, CURLOPT_POST, 1);
curl_setopt($chAttachments, CURLOPT_POSTFIELDS, $args);
curl_setopt($chAttachments, CURLOPT_RETURNTRANSFER, true); // 确保返回结果
$resultAttachments = curl_exec($chAttachments);
curl_close($chAttachments);
// 处理返回结果
echo "Upload Result: " . $resultAttachments . "\n";
}
} else {
echo "No files uploaded.\n";
}
?>代码解释：
立即学习“PHP免费学习笔记（深入）”；
- CurlFile 类: 这是关键。使用 CurlFile 类来表示要上传的文件。 CurlFile 的构造函数接受三个参数：临时文件名、MIME 类型和文件名。
- $args 数组: 这个数组包含了所有需要传递给 Trello API 的参数，包括 file (使用 CurlFile 对象), key (你的 Trello API 密钥), token (你的 Trello API 令牌), mimeType (文件的 MIME 类型), 和 name (文件名)。
-
curl_setopt 函数:
- CURLOPT_URL: 指定 Trello API 的 URL，包含卡片 ID。 将 'YOUR_CARD_ID' 替换为实际的卡片 ID。
- CURLOPT_POST: 设置为 1 表示这是一个 POST 请求。
- CURLOPT_POSTFIELDS: 设置为 $args 数组，包含了所有要发送的数据。
- CURLOPT_RETURNTRANSFER: 设置为 true，确保 curl_exec 函数返回结果，而不是直接输出。
- 错误处理: 虽然示例中没有明确的错误处理，但在实际应用中，应该检查 curl_exec 的返回值，并根据需要进行错误处理。 可以使用 curl_errno 和 curl_error 函数来获取 cURL 的错误信息。
- 安全注意事项: 不要在客户端代码中暴露你的 Trello API 密钥和令牌。 将这些敏感信息保存在服务器端，并使用安全的方式来访问它们。
- MIME 类型: 确保正确设置文件的 MIME 类型，这有助于 Trello 正确处理上传的文件。
- 卡片 ID: 将 'YOUR_CARD_ID' 替换为实际的 Trello 卡片 ID。
注意事项：
- 确保你的 PHP 版本支持 CurlFile 类 (PHP 5.5 及以上)。如果你的 PHP 版本较低，你需要使用 @ 符号来代替 CurlFile，但这已被弃用，不推荐使用。
- 替换 YOUR_TRELLO_API_KEY 和 YOUR_TRELLO_API_TOKEN 为你自己的 Trello API 密钥和令牌。
- 确保服务器具有上传文件的权限。
- 上传大文件时，可能需要调整 PHP 的 upload_max_filesize 和 post_max_size 配置。
总结：
使用 CurlFile 类是使用 cURL 上传文件到 Trello API 的关键。通过正确设置 CURLOPT_POSTFIELDS 和其他 cURL 选项，可以确保文件正确上传，并且文件名和内容都能正确显示。 记住处理错误，并采取必要的安全措施来保护你的 API 密钥和令牌。
