تبدیل curl به ColdFusion
دستورات curl را با استفاده از cfhttp به کد ColdFusion تبدیل کنید. curl2code کاملاً در مرورگر شما از طریق WebAssembly اجرا میشود — دادههای شما خصوصی میمانند. برای PHP، مبدل curl به PHP ما را امتحان کنید. برای Java، curl به Java را ببینید. در ادامه مثالهای آماده ColdFusion آورده شده است.
نحوه کپی کردن curl از مرورگر
- 1
باز کردن DevTools
کلید F12 یا Ctrl+Shift+I را فشار دهید تا ابزارهای توسعهدهنده مرورگر باز شوند.
- 2
رفتن به تب Network
روی تب Network کلیک کنید و عملیاتی که باعث ارسال درخواست HTTP میشود را انجام دهید.
- 3
کپی به عنوان cURL
روی درخواست راستکلیک کنید ← Copy ← Copy as cURL. سپس آن را در بالا جایگذاری کنید.
سوالات متداول
ColdFusion cfhttp چیست؟
cfhttp تگ و تابع داخلی ColdFusion برای ایجاد درخواستهای HTTP است. این ابزار از GET، POST، PUT، DELETE و آپلود فایل با ادغام بومی در اسکوپهای متغیر ColdFusion پشتیبانی میکند. نیازی به نصب ندارد — بخشی از زمان اجرای ColdFusion/Lucee است. curl2code کد cfhttp/CFML را برای تبدیلهای ColdFusion تولید میکند.
تگ cfhttp در مقابل تابع cfhttp — از کدام سینتکس استفاده کنیم؟
تگ cfhttp از مارکآپ CFML با ویژگیهای نامدار استفاده میکند — سنتی، مفصل و خوانا در فایلهای قالب. تابع cfhttp() از CFScript با آرگومانهای پرانتزدار استفاده میکند: cfhttp(url=url, method="GET") — مدرن و مختصر. هر دو به یک فراخوانی موتور یکسان کامپایل میشوند. برای سازگاری در پروژههای مدرن ColdFusion از CFScript استفاده کنید. برای انتخابهای سینتکسی مشابه، curl به PHP را ببینید.
چگونه احراز هویت را در ColdFusion مدیریت کنیم؟
هدرها را با cfhttpparam type="header" name="Authorization" value="Bearer #token#" اضافه کنید. برای احراز هویت Basic، مستقیماً از ویژگیهای username و password در cfhttp استفاده کنید. ColdFusion انکودینگ Base64 را برای احراز هویت Basic به صورت خودکار انجام میدهد. curl2code فلگهای احراز هویت را به CFML تبدیل میکند.
چگونه دادههای فرم multipart را در ColdFusion ارسال کنیم؟
برای آپلود فایل از cfhttpparam type="file" name="upload" file="#filePath#" استفاده کنید. برای فیلدهای فرم: cfhttpparam type="formfield" name="key" value="value". ColdFusion مقدار Content-Type چندبخشی و مرزها را به صورت خودکار تنظیم میکند. curl2code تبدیلهای فلگ -F را مدیریت میکند.
چگونه خطاهای HTTP را در ColdFusion مدیریت کنیم؟
در try/catch قرار دهید: try { httpResult = cfhttp(...); } catch(any e) { ... }. مقدار cfhttp.statusCode را برای وضعیت HTTP و cfhttp.errorDetail را برای اطلاعات خطا بررسی کنید. پاسخهای غیر 2xx به طور پیشفرض خطا پرتاب نمیکنند — همیشه کد وضعیت را به صورت دستی بررسی کنید.
چگونه پاسخهای JSON را در ColdFusion پارس کنیم؟
از deserializeJSON(cfhttp.fileContent) برای پارس کردن JSON به ساختارها (structs) و آرایههای ColdFusion استفاده کنید. برای ارسال JSON: serializeJSON(data). توابع JSON در ColdFusion ساختارهای پیچیده تودرتو را به صورت خودکار مدیریت کرده و بین انواع داده CFML و JSON به شکلی یکپارچه تبدیل میکنند.
چگونه تایماوتها را در ColdFusion تنظیم کنیم؟
پارامتر timeout را پاس دهید: cfhttp(url=url, timeout=30). مقدار به ثانیه است. مکانیزم تلاش مجدد داخلی وجود ندارد — آن را با یک حلقه و try/catch پیادهسازی کنید. تایماوت پیشفرض بسته به نسخه ColdFusion/Lucee متفاوت است.
چگونه از پروکسی در ColdFusion استفاده کنیم؟
پارامترهای پروکسی را پاس دهید: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). برای احراز هویت پروکسی، پارامترهای proxyUser و proxyPassword را اضافه کنید. curl2code فلگهای -x را به تنظیمات پروکسی CFML تبدیل میکند.
چگونه یک درخواست POST با بدنه JSON در ColdFusion ارسال کنیم؟
یک دستور curl POST مانند curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL را با استفاده از curl2code به ColdFusion تبدیل کنید. کد تولید شده از cfhttpparam type='body' value='#serializeJSON(data)#' استفاده میکند. curl2code به طور خودکار فلگهای -d/--data با محتوای JSON را تشخیص داده و هدر Content-Type مناسب را در کد cfhttp تنظیم میکند.
چگونه احراز هویت با Bearer token را در ColdFusion اضافه کنیم؟
دستور curl -H "Authorization: Bearer YOUR_TOKEN" URL را به curl2code بدهید تا کد cfhttp را با هدر احراز هویت تولید کند: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code توکنهای Bearer را از هر دو فلگ -H "Authorization: Bearer ..." و --oauth2-bearer تشخیص میدهد. برای Basic auth، از -u user:pass استفاده کنید.
چگونه هدر Content-Type را در ColdFusion تنظیم کنیم؟
curl2code دستور curl -H "Content-Type: application/json" URL را به کد cfhttp با هدر مناسب تبدیل میکند: cfhttpparam type='header' name='Content-Type' value='application/json'. برای دادههای -d، دستور curl به طور پیشفرض از application/x-www-form-urlencoded استفاده میکند؛ برای آپلودهای فرم -F، از multipart/form-data استفاده میکند. curl2code هر کدام را به API صحیح cfhttp نگاشت میکند.