Chuyển đổi curl sang ColdFusion

cfhttp là tag và hàm tích hợp sẵn của ColdFusion để thực hiện các yêu cầu HTTP. Nó hỗ trợ GET, POST, PUT, DELETE và tải tệp lên với sự tích hợp nguyên bản vào các phạm vi biến của ColdFusion. Không cần cài đặt — nó là một phần của runtime ColdFusion/Lucee. curl2code tạo mã cfhttp/CFML cho các chuyển đổi ColdFusion.

Thẻ cfhttp sử dụng CFML markup với các thuộc tính được đặt tên — truyền thống, chi tiết và dễ đọc trong các file template. Hàm cfhttp() sử dụng CFScript với các đối số trong ngoặc đơn: cfhttp(url=url, method="GET") — hiện đại và súc tích. Cả hai đều biên dịch thành cùng một lệnh gọi engine. Sử dụng CFScript để đảm bảo tính nhất quán trong các dự án ColdFusion hiện đại. Đối với các lựa chọn cú pháp tương tự, hãy xem curl sang PHP.

Thêm các header với cfhttpparam type="header" name="Authorization" value="Bearer #token#". Đối với Basic auth, sử dụng trực tiếp các thuộc tính username và password trên cfhttp. ColdFusion tự động xử lý mã hóa Base64 cho Basic auth. curl2code chuyển đổi các cờ xác thực sang CFML.

Sử dụng cfhttpparam type="file" name="upload" file="#filePath#" để tải tệp lên. Đối với các trường form: cfhttpparam type="formfield" name="key" value="value". ColdFusion tự động thiết lập Content-Type multipart và các boundary. curl2code xử lý các chuyển đổi cờ -F.

Bao bọc trong try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Kiểm tra cfhttp.statusCode để lấy trạng thái HTTP và cfhttp.errorDetail để lấy thông tin lỗi. Các phản hồi không phải 2xx không ném ra lỗi theo mặc định — hãy luôn kiểm tra mã trạng thái một cách thủ công.

Sử dụng deserializeJSON(cfhttp.fileContent) để phân tích JSON thành các struct và array của ColdFusion. Để gửi JSON: serializeJSON(data). Các hàm JSON của ColdFusion tự động xử lý các cấu trúc lồng nhau phức tạp, chuyển đổi liền mạch giữa các kiểu dữ liệu CFML và JSON.

Truyền tham số timeout: cfhttp(url=url, timeout=30). Giá trị tính bằng giây. Không có cơ chế thử lại tích hợp sẵn — hãy triển khai bằng vòng lặp và try/catch. Timeout mặc định thay đổi tùy theo phiên bản ColdFusion/Lucee.

Truyền các tham số proxy: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Đối với xác thực proxy, thêm các tham số proxyUser và proxyPassword. curl2code chuyển đổi các cờ -x sang cài đặt proxy CFML.

Chuyển đổi một lệnh curl POST như curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL sang ColdFusion bằng cách sử dụng curl2code. Mã được tạo sử dụng cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code tự động phát hiện các cờ -d/--data với nội dung JSON và thiết lập header Content-Type phù hợp trong mã cfhttp.

Cung cấp curl -H "Authorization: Bearer YOUR_TOKEN" URL cho curl2code và nó sẽ tạo mã cfhttp với header xác thực: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code phát hiện Bearer tokens từ cả hai cờ -H "Authorization: Bearer ..." và --oauth2-bearer. Đối với Basic auth, hãy sử dụng -u user:pass.

curl2code chuyển đổi curl -H "Content-Type: application/json" URL sang mã cfhttp với header chính xác: cfhttpparam type='header' name='Content-Type' value='application/json'. Đối với dữ liệu -d, curl mặc định là application/x-www-form-urlencoded; đối với tải lên biểu mẫu -F, nó sử dụng multipart/form-data. curl2code ánh xạ từng loại tới cfhttp API chính xác.