cURL与PHP实现Trello卡片附件添加

本文档将指导您如何使用 PHP 和 cURL 库，将文件作为附件上传到 Trello 卡片。我们将详细介绍如何构建请求，正确设置 cURL 选项，以及处理上传的文件数据，最终实现将文件成功附加到指定的 Trello 卡片。避免了常见的文件上传问题，确保附件能够正确上传并显示。

前提条件

在开始之前，请确保您已具备以下条件：

• 一个有效的 Trello 账号
• 一个 Trello API 密钥 (Key) 和 Token (Token)
• PHP 环境，并已启用 cURL 扩展
• 了解基本的 HTML 表单和 JavaScript 知识

HTML 表单 (JavaScript)

首先，我们需要一个 HTML 表单，允许用户选择要上传的文件。以下是一个简单的示例：

然后，使用 JavaScript 将选择的文件通过 FormData 对象发送到 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 类来正确处理文件上传。

 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);
    }
}

?>

代码解释：

1. CurlFile 类: 这是解决问题的关键。使用 new CurlFile() 创建一个文件对象，并传递文件的临时路径、MIME 类型和文件名。
2. $args 数组: 这个数组包含了所有需要传递给 Trello API 的参数，包括文件、API 密钥、Token、MIME 类型和文件名。
3. curl_setopt() 函数:
   • CURLOPT_URL: 设置 Trello API 的 URL，包括卡片 ID。
   • CURLOPT_POST: 指定这是一个 POST 请求。
   • CURLOPT_POSTFIELDS: 将 $args 数组作为 POST 数据传递。
   • CURLOPT_RETURNTRANSFER: 设置为 1，指示 cURL 将结果作为字符串返回，而不是直接输出。这允许您检查 API 的响应。
4. curl_exec() 函数: 执行 cURL 请求，并将结果存储在 $resultAttachments 变量中。
5. 错误处理: 建议添加错误处理代码，检查 $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 附件上传功能。