개요
curl 은 command line 용 data transfer tool 이다. download/upload 모두 가능하며HTTP/HTTPS/FTP/LDAP/SCP/TELNET/SMTP/POP3 등 주요한 프로토콜을 지원하며 Linux/Unix 계열 및 Windows 등 주요한 OS 에서 구동되므로
여러 플랫폼과 OS에서 유용하게 사용할 수 있다. 또 libcurl 이라는 C 기반의 library 가 제공되므로 C/C++ 프로그램 개발시 위의 protocol 과 연계가 필요하다면 libcurl 을 사용하여 손쉽게 연계할 수 있다. 또 libcurl은 PHP, ruby, PERL 및 여러 언어에 바인딩되어 있으므로 사용하는 언어나 개발환경에 맞게 libcurl 을 사용할 수 있다.
설치
Linux나 Mac OS X 에는 기본 탑재되어 있다. Windows는 build 된 바이너리를 설치해도 되고 compiler 가 있다면 소스를 받아서 직접 빌드해도 된다.(curl windows 에서 빌드하기)
Windows 버전은 cygwin나 MinGW 로 빌드한거 보다는 VIsual Studio 로 빌드한 버전을 다운받는게 좋다. (Win32-Generic, Win64 - Generic 항목에서 받으면 된다.)
CentOS/RHEL 계열에서 최신 버전 설치는 RHEL/CentOS 6 에서 curl 최신 버전 설치 문서를 참고하자.
사용법
curl [options...] <url> 형식으로 사용하면 된다.
option 처리는 GNU getopt 를 사용하므로 하이픈 하나를 붙이는 short 형식의 옵션과 하이픈 두개로 시작되는 long 형식의 options 이 있다.
주요 options (http/https 관련 옵션만 정리)
short | long | 설명 | 비고 |
---|---|---|---|
-k | --insecure | https 사이트를 SSL certificate 검증없이 연결한다. | wget 의 --no-check-certificate 과 비슷한 역할 수행 |
-l | --head | HTTP header 만 보여주고 content 는 표시하지 않는다 | |
-D | --dump-header <file> | <file> 에 HTTP header 를 기록한다. | |
-L | --location | 서버에서 HTTP 301 이나 HTTP 302 응답이 왔을 경우 redirection URL 로 따라간다. --max-redirs 뒤에 숫자로 redirection 을 몇 번 따라갈지 지정할 수 있다. 기본 값은 50이다 | curl -v daum.net 을 실행하면 결과값으로 다음과 같이 HTTP 302 가 리턴된다. -L 옵션을 추가하면 www.daum.net 으로 재접속하여 결과를 받아오게 된다. |
-d | --data | HTTP Post data | FORM 을 POST 하는 HTTP나 JSON 으로 데이타를 주고받는 REST 기반의 웹서비스 디버깅시 유용한 옵션이다 |
-v | --verbose | 동작하면서 자세한 옵션을 출력한다. | |
-J | --remote-header-name | 어떤 웹서비스는 파일 다운로드시 Content-Disposition Header 를 파싱해야 정확한 파일이름을 알 수 있을 경우가 있다. -J 옵션을 주면 헤더에 있는 파일 이름으로 저장한다. | curl 7.20 이상부터 추가된 옵션 |
-o | --output FILE | curl 은 remote 에서 받아온 데이타를 기본적으로는 콘솔에 출력한다. -o 옵션 뒤에 FILE 을 적어주면 해당 FILE 로 저장한다. (download 시 유용) | |
-O | --remote-name | file 저장시 remote 의 file 이름으로 저장한다. -o 옵션보다 편리하다. | |
-s | --silent | 정숙 모드. 진행 내역이나 메시지등을 출력하지 않는다. -o 옵션으로 remote data 도 /dev/null 로 보내면 결과물도 출력되지 않는다 | HTTP response code 만 가져오거나 할 경우 유리 |
사용예(Example, Sample)
HTTP/HTTPS Download
HTTP로 다운로드
이어받기
-C/--continue-at <offset> 옵션을 주면 이어받기 가능(offset 에 - 를 주면 전송이후 부분부터 이어받음)
특정일 이전/이후 변경되었으면 받기
-z/--time-cond <time>
HTTP 헤더에 If-Modified-Since: 헤더를 추가하여 특정일 이후에 변경되었으면 다운로드 수행
아래 예제는 2011년 12월 21일 이후에 변경되었으면 다운로드 수행
날자앞에 - 를 추가하면 If-Unmodified-Since: 헤더를 추가하여 특정일 이전에 변경되었으면 다운로드 수행
아래 예제는 2011년 12월 21일 이전에 변경되었으면 다운로드함 (날자에 - 추가)
http response code 만 출력
HTTP Header 나 contents 는 빼고 HTTP Response code 만 출력한다. 서버의 정상 작동 여부 점검때 유용하다.
HTTP 인증
id/pwd 가 필요한 사이트의 경우 -u(–user) 옵션 뒤에 userid:password 를 지정하여 인증할 수 있다.
결과값에 HTTP Header 포함
-i 옵션을 사용하면 서버의 응답에 서버가 보낸 HTTP 헤더를 추가하여 출력한다. 디버깅에 유용한다.
HTTP/HTTPS POST
HTTP FORM POST
-X POST 옵션을 추가하거나 -d( --data) 옵션을 지정하면 기본값으로 POST 로 설정됨
POST 데이타는 "param1=value1¶m2=value2" 형식으로 전달
데이타에 공백이나 기타 특수 문자가 있을 경우 URL encoding 을 해야 한다.
공백일 경우 일일이 + 로 변환해서 전송해야 하지만 최신 버전의 curl(7.18.0 이후) 은 FORM 파라미터를 URL Encoding 해주는 --data-urlencode 옵션을 사용하면 별도로 인코딩을 해주지 않아도 된다.
Hidden field 전송시 일반 필드처럼 name=value 형식으로 전송하면 된다.
HTTP POST File
file POST할 경우 file name 앞에 @ 를 붙여줌
HTTP POST Binary File
curl 은 POST 시 데이타를 text 로 취급하므로 binary 데이타는 깨질 수 있다. 제대로 전송하려면 --data-binary 옵션을 추가해야 한다.
HTTP File Upload Form
다음과 같은 파일 업로드 FORM 이 있을때
localfilename 은 upload 할 파일명, submit 은 press=OK
HTTP Header 설정
특정한 HTTP Header 를 설정해서 보내야 할 경우(Ex: json data등) -H (–header) 옵션으로 헤더를 설정할 수 있다.
Content-Type Header 설정
User-Agent 설정
특정 브라우저인(Browser) 것처럼 동작하기 위해서는 -A ( --user-agent) 옵션을 사용할 수 있다. (http://www.useragentstring.com/)
USER-AGENT CHROME 24.0
USER-AGENT MSIE(INTERNET EXPLORER) 10.0
USER-AGENT FIREFOX 29.0
Referer 설정
Referer 를 체크하는 사이트일 경우 -e (–referer) 옵션으로 Referer URL 을 설정할 수 있다.
아니면 -H 옵션으로 referer 헤더를 지정해도 된다.
SSL/TLS 옵션
TLS Version 지정
SSL 의 후속 버전인 TLS 의 버전을 지정할 수 있다. 지정하지 않을 경우 서버와 negotiation하여 결정한다.
- -1, --tlsv1 Use => TLSv1 (SSL)
- --tlsv1.0 Use TLSv1.0 (SSL)
- --tlsv1.1 Use TLSv1.1 (SSL)
- --tlsv1.2 Use TLSv1.2 (SSL)
SSL Version 지정
다음 옵션으로 사용할 SSL 의 버전을 지정할 수 있다. 지정하지 않을 경우 서버와 negotiation하여 결정한다. SSL 은 오래 됐으니 SSL 보다는 TLS 를 사용하는게 좋다.
- -2, --sslv2 Use SSLv2 (SSL)
- -3, --sslv3 Use SSLv3 (SSL)
REST API 와 연계
위의 옵션들이 익숙해졌으면 REST 기반의 웹서비스를 개발할 때 curl 을 이용해서 테스트 및 디버깅을 수행할 수 있다. REST API 를 제공하는 유명한 Web App 와 연계하는 방법을 정리해 본다.
curl로 Atlassian JIRA REST API 연계하기
Sonatype nexus Admin API
관리자 암호 변경
'참고소스 > Docker' 카테고리의 다른 글
Docker 기본 사용법 (0) | 2017.02.20 |
---|