Конвертиране на curl в ColdFusion

Q: Какво е ColdFusion cfhttp?

cfhttp е вграденият таг и функция на ColdFusion за извършване на HTTP заявки. Той поддържа GET, POST, PUT, DELETE и качване на файлове с естествена интеграция в областите на видимост на променливите в ColdFusion. Не е необходима инсталация — той е част от средата за изпълнение на ColdFusion/Lucee. curl2code генерира cfhttp/CFML код за ColdFusion конверсии.

Q: cfhttp таг срещу cfhttp функция — кой синтаксис да използвам?

Тагът cfhttp използва CFML маркиране с именувани атрибути — традиционен, подробен и четим в шаблонни файлове. Функцията cfhttp() използва CFScript с аргументи в скоби: cfhttp(url=url, method="GET") — модерна и кратка. И двете се компилират до едно и също извикване на двигателя. Използвайте CFScript за последователност в модерните ColdFusion проекти. За подобни избори на синтаксис вижте curl към PHP.

Q: Как да се справя с автентикацията в ColdFusion?

Добавете хедъри с cfhttpparam type="header" name="Authorization" value="Bearer #token#". За Basic автентикация използвайте атрибутите username и password директно в cfhttp. ColdFusion автоматично обработва Base64 кодирането за Basic автентикация. curl2code конвертира флаговете за автентикация в CFML.

Q: Как да изпратя multipart form данни в ColdFusion?

Използвайте cfhttpparam type="file" name="upload" file="#filePath#" за качване на файлове. За полета на формуляр: cfhttpparam type="formfield" name="key" value="value". ColdFusion автоматично задава multipart Content-Type и границите. curl2code обработва конвертирането на флага -F.

Q: Как да обработвам HTTP грешки в ColdFusion?

Обвийте в try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Проверете cfhttp.statusCode за HTTP статуса и cfhttp.errorDetail за информация за грешката. Отговорите, различни от 2xx, не хвърлят грешка по подразбиране — винаги проверявайте статус кода ръчно.

Q: Как да парсвам JSON отговори в ColdFusion?

Използвайте deserializeJSON(cfhttp.fileContent), за да парснете JSON в структури и масиви на ColdFusion. За изпращане на JSON: serializeJSON(data). Функциите за JSON на ColdFusion автоматично обработват сложни вложени структури, преобразувайки безпроблемно между типовете данни на CFML и JSON.

Q: Как да задам таймаути в ColdFusion?

Подайте параметъра timeout: cfhttp(url=url, timeout=30). Стойността е в секунди. Няма вграден механизъм за повторен опит — имплементирайте го с цикъл и try/catch. Таймаутът по подразбиране варира според версията на ColdFusion/Lucee.

Q: Как да използвам прокси в ColdFusion?

Подайте параметри за прокси: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). За прокси автентикация добавете параметрите proxyUser и proxyPassword. curl2code конвертира флаговете -x в настройки за прокси на CFML.

Q: Как се изпраща POST заявка с JSON тяло в ColdFusion?

Конвертирайте curl POST команда като curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL в ColdFusion чрез curl2code. Генерираният код използва cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code автоматично разпознава -d/--data флагове с JSON съдържание и задава съответната Content-Type заглавна част в cfhttp кода.

Q: Как се добавя 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.

Конвертирайте curl команди в ColdFusion код, използвайки cfhttp. 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 примери за код

1Обикновена GET заявка

curl команда

curl https://api.example.com/users

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/users");
httpService.setMethod("GET");

result = httpService.send().getPrefix();
writeDump(result);

2POST с JSON тяло

curl команда

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/users");
httpService.setMethod("POST");
httpService.addParam(type="header", name="Content-Type", value="application/json");
httpService.addParam(type="body", value='{"name":"John","email":"john@example.com"}');

result = httpService.send().getPrefix();
writeDump(result);

3Заявка с Bearer токен

curl команда

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/me");
httpService.setMethod("GET");
httpService.addParam(type="header", name="Authorization", value="Bearer token123");

result = httpService.send().getPrefix();
writeDump(result);

4Качване на Multipart форма

curl команда

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/upload");
httpService.setMethod("POST");
httpService.addParam(type="file", name="file", file="#expandPath("document.pdf")#");
httpService.addParam(type="formfield", name="description", value="My file");

result = httpService.send().getPrefix();
writeDump(result);

5Персонализирани хедъри

curl команда

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/data");
httpService.setMethod("GET");
httpService.addParam(type="header", name="X-API-Key", value="abc123");
httpService.addParam(type="header", name="Accept", value="application/json");
httpService.addParam(type="header", name="X-Request-ID", value="req-456");

result = httpService.send().getPrefix();
writeDump(result);

Често задавани въпроси

Какво е 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") — модерна и кратка. И двете се компилират до едно и също извикване на двигателя. Използвайте CFScript за последователност в модерните ColdFusion проекти. За подобни избори на синтаксис вижте curl към PHP.

Как да се справя с автентикацията в ColdFusion?

Добавете хедъри с cfhttpparam type="header" name="Authorization" value="Bearer #token#". За Basic автентикация използвайте атрибутите username и password директно в cfhttp. ColdFusion автоматично обработва Base64 кодирането за Basic автентикация. curl2code конвертира флаговете за автентикация в CFML.

Как да изпратя multipart form данни в ColdFusion?

Използвайте cfhttpparam type="file" name="upload" file="#filePath#" за качване на файлове. За полета на формуляр: cfhttpparam type="formfield" name="key" value="value". ColdFusion автоматично задава multipart 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 в структури и масиви на 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 в ColdFusion чрез curl2code. Генерираният код използва 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 свързва всеки от тях с правилния cfhttp API.

Полезни връзки

cfhttp документация

cfdocs.org

Справочник на стандартната библиотека

helpx.adobe.com

curl man страница

curl.se

Ръководства за curl

Кодове за грешки на curl

Справка за всеки изходен код на curl — причини, решения и съвети за отстраняване на грешки.

Изтегляне на файлове с curl

Запазвайте файлове с -o, -O, следвайте пренасочвания, възобновявайте изтегляния и още.

SSL, TLS и прокси

Конфигурирайте сертификати, версии на TLS, HTTP/SOCKS проксита и персонализиран DNS.

Как да копирате curl от вашия браузър

ColdFusion примери за код

1Обикновена GET заявка

2POST с JSON тяло

3Заявка с Bearer токен

4Качване на Multipart форма

5Персонализирани хедъри

Често задавани въпроси

Полезни връзки

Ръководства за curl

Конвертиране на curl в други езици

ColdFusion примери за код

1Обикновена GET заявка

2POST с JSON тяло

3Заявка с Bearer токен

4Качване на Multipart форма

5Персонализирани хедъри