本文档将指导您如何使用 PHP 和 cURL 库，将文件作为附件上传到 Trello 卡片。我们将详细介绍如何构建请求，正确设置 cURL 选项，以及处理上传的文件数据，最终实现将文件成功附加到指定的 Trello 卡片。避免了常见的文件上传问题，确保附件能够正确上传并显示。
前提条件
在开始之前，请确保您已具备以下条件：
- 一个有效的 Trello 账号
- 一个 Trello API 密钥 (Key) 和 Token (Token)
- PHP 环境，并已启用 cURL 扩展
- 了解基本的 HTML 表单和 JavaScript 知识
HTML 表单 (JavaScript)
首先，我们需要一个 HTML 表单，允许用户选择要上传的文件。以下是一个简单的示例：
<input type="file" id="Trello attachment" multiple>
然后，使用 JavaScript 将选择的文件通过 FormData 对象发送到 PHP 服务器：
立即学习“PHP免费学习笔记（深入）”；
var files = document.getElementById('Trello attachment').files;
var formData = new FormData();
for (i = 0; i < files.length; i++) {
formData.append('file[]', files[i]);
}
var ajax = new XMLHttpRequest();
ajax.open('POST', 'assets/php/ajaxResponse.php');
ajax.send(formData);此 JavaScript 代码片段获取文件输入中的文件，并将它们附加到 FormData 对象。然后，它使用 XMLHttpRequest 将数据以 POST 请求的形式发送到 assets/php/ajaxResponse.php。
PHP 代码 (ajaxResponse.php)
现在，我们需要编写 PHP 代码来处理上传的文件，并使用 cURL 将它们附加到 Trello 卡片。关键在于使用 CurlFile 类来正确处理文件上传。
<?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', // 替换为你的 Trello API 密钥
'token' => 'YOUR_TRELLO_API_TOKEN', // 替换为你的 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/'); // 替换为你的 Trello 卡片 ID
curl_setopt($chAttachments, CURLOPT_POST, 1);
curl_setopt($chAttachments, CURLOPT_POSTFIELDS, $args);
curl_setopt($chAttachments, CURLOPT_RETURNTRANSFER, 1); // 返回结果到变量而不是直接输出
$resultAttachments = curl_exec($chAttachments);
curl_close($chAttachments);
// 可选：处理返回的结果
print_r($resultAttachments);
}
}
?>代码解释：
- CurlFile 类: 这是解决问题的关键。使用 new CurlFile() 创建一个文件对象，并传递文件的临时路径、MIME 类型和文件名。
- $args 数组: 这个数组包含了所有需要传递给 Trello API 的参数，包括文件、API 密钥、Token、MIME 类型和文件名。
-
curl_setopt() 函数:
- CURLOPT_URL: 设置 Trello API 的 URL，包括卡片 ID。
- CURLOPT_POST: 指定这是一个 POST 请求。
- CURLOPT_POSTFIELDS: 将 $args 数组作为 POST 数据传递。
- CURLOPT_RETURNTRANSFER: 设置为 1，指示 cURL 将结果作为字符串返回，而不是直接输出。这允许您检查 API 的响应。
- curl_exec() 函数: 执行 cURL 请求，并将结果存储在 $resultAttachments 变量中。
- 错误处理: 建议添加错误处理代码，检查 $resultAttachments 的内容，以确保文件上传成功。
注意事项
- 替换占位符： 请务必将 YOUR_TRELLO_API_KEY, YOUR_TRELLO_API_TOKEN, 和 YOUR_CARD_ID 替换为您的实际值。
- 安全性： 永远不要在客户端代码中暴露您的 API 密钥和 Token。将这些值存储在服务器端，并从服务器端发起 API 请求。
- 错误处理： 添加适当的错误处理机制，以便在文件上传失败时能够及时发现并处理。检查 curl_exec() 的返回值以及 Trello API 的响应，以确定是否发生了错误。
- 文件大小限制： Trello 对附件大小有限制。请确保上传的文件大小不超过 Trello 的限制。
- MIME 类型： 确保传递正确的 MIME 类型，以便 Trello 能够正确处理上传的文件。
总结
通过使用 CurlFile 类，我们可以正确地将文件作为附件上传到 Trello 卡片。请记住替换占位符，并添加适当的错误处理机制，以确保您的代码能够正常工作。这个教程提供了一个清晰的示例，展示了如何使用 PHP 和 cURL 实现 Trello 附件上传功能。
