Конвертувати 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 auth використовуйте атрибути username та password безпосередньо в cfhttp. ColdFusion автоматично обробляє кодування Base64 для Basic auth. curl2code конвертує прапорці автентифікації в CFML.

Q: Як надіслати multipart form data в 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-токена у 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 auth використовуйте атрибути username та password безпосередньо в cfhttp. ColdFusion автоматично обробляє кодування Base64 для Basic auth. curl2code конвертує прапорці автентифікації в CFML.

Як надіслати multipart form data в 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-токена у 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

Сторінка man для curl

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Користувацькі заголовки