cgibashopts

CGIBASHOPTS : CGI BASH 옵션 구문 분석

Cgibashopts는 이진 파일 업로드를 사용하여 Bash Shell Web CGI 스크립트의 웹 양식 매개 변수를 구문 분석하는 작고 빠른 순수한 Bash 라이브러리입니다. 제한없이 무료로 사용할 수 있습니다 (MIT 라이센스). (c) Colas Nahaboo 2017

QuickStart

• 서버 어딘가에 cgibashopts 파일을 복사하십시오. 예를 들어 /usr/local/bin/cgibashopts
• CGI Bash 스크립트의 시작 부분 에이 파일을 소스하십시오. 예 : source /usr/local/bin/cgibashopts 또는 . /usr/local/bin/cgibashopts
• 웹 양식 매개 변수 foo 의 값 (예 : html 페이지 : <input type=text name=foo> )을 쉘 환경의 값 변수로서 $FORM_foo 로 찾을 수 있습니다.

문제 해결 :

• 문제가 발생하면 서버의 Cgibashopts 디렉토리에서 tests/tewiba -v 실행하여 테스트 스위트가 문제를 감지하는지 확인하십시오.
• cgibashopts에는 bash , grep , sed 의 GNU 버전이 필요합니다. 이것을 테스트하려면 grep -P . /dev/null , 오류가 발생하지 않아야합니다. 그렇다면 MacOS , BusyBox, FreeBSD, BSD 및 SYSV 파생 상품과 같이 기본적으로 GNU 유틸리티를 사용하지 않는 UNIX와 같은 시스템에 설치해야합니다.
  • MACOS에서는 문제 #10을 참조하십시오
  • Busybox에서는 bash , coreutils , grep , sed 의 GNU 버전 패키지를 설치해야합니다.
  • freebsd에서는 Freshports를 사용하십시오

특징

• 사용하기 간단 : 단 하나의 파일 만.
• 빠르고 작습니다.
• Grep, Sed 및 Bruncate의 사용을 제외한 순수한 배쉬.
• 매개 변수를 인코딩하는 모든 메소드와 함께 요청 및 게시 요청을 처리합니다.
• 레거시 인덱스 검색 쿼리 문자열도 처리합니다
• 이진 파일의 업로드 및 UNIX 또는 DOS Newlines가있는 텍스트 파일을 처리합니다. CGI 쉘 프로그래밍 에이 기능을 제공하는 기존 라이브러리를 찾지 못했습니다.
• Bash의 "Classic"기능 만 사용하고 오래된 Bash 버전과 함께 작동해야합니다. 4.1+가 생각합니다.

선적 서류 비치

• Cgibashopts 라이브러리는 사용될 때 웹 서버가 CGI 표준에 따라 웹 서버가 스크립트에 다양한 환경 변수로 제공하는 브라우저에서 보낸 매개 변수를 디코딩합니다. cgibashopts는 변수, 함수 및 파일과 같은 사용하기 쉬운 형태로 스크립트를 포함시킬 수 있도록합니다.
• 라이브러리를 사용하려면 스크립트의 시작 부분에서 최대한 빨리 스크립트에서 사용할 수있는 변수와의 충돌을 피하기 위해 최대한 빨리 소스하십시오.
• 라이브러리는 Get 및 Post 요청의 매개 변수를 디코딩하며 매개 변수를 인코딩하는 모든 방법 ( "Enctype").
• 매개 변수 이름 목록은 $FORMS 으로 공간 분리 된 이름 문자열로 나열됩니다. 예 : echo "$FORMS" ==> foo bar gee . 매개 변수 이름은 HTML 양식의 다양한 HTML 요소의 name 속성으로 지정된 이름이거나 wget 또는 curl 같은 명령을 통해 전송 된 이름입니다. 매개 변수 이름은 배쉬의 법적 변수 이름이어야합니다. 영숫자 문자 및 밑줄은 숫자로 시작하지 않아야합니다.
• 유효하지 않은 매개 변수 이름 (예 : 0To60, AB, A : B, ...)은 조용히 무시됩니다.
• 각 매개 변수 값은 form_- 접두사 환경 변수의 값으로 복사됩니다. 예 : foo 라는 HTML 양식 요소의 경우 $FORM_foo .
• 멀티 라인 매개 변수 값은 UNIX 끝으로 변환됩니다 (캐리지 리턴 및 Newline 대신 Newline)
• 파일 업로드 : 파일을 업로드 할 때 <input type=file name=file1> 와 같은 양식 요소를 통해 Cgibashopts는 매개 변수 이름 (여기서 file1 )을 변수 $ formfiles에 배치합니다. 업로드 된 파일의 실제 이름은 변수 값 (여기 $FORM_file1 )에서 찾을 수있는 반면 파일의 내용은 $CGIBASHOPTS_DIR 디렉토리의 변수별로 명명 된 로컬 파일에서 찾을 수 있습니다 (여기 $CGIBASHOPTS_DIR/file1 ).
  • 실제로 업로드 된 파일만이 방식으로 생성되고 나열됩니다. 사용자가 양식에서 파일을 선택하지 않으면 쉘 변수가 정의되지 않거나 생성 된 파일이 없습니다.
  • 그러나 빈 업로드 된 파일이 생성됩니다. 물론 그들은 비어있을 것입니다.
  • 클라이언트가 DOS 형식으로 업로드 한 경우에도 (Newline 텍스트 형식으로 끝나는 지) (Newline으로 끝)로 수신 된 바이너리 및 텍스트 파일은 변환되지 않습니다 . 따라서 업로드 된 텍스트 파일에서 DOS 라인을 처리 할 준비가되어 있어야합니다.
  • 경고 : BASH CLEANUP 기능 cgibashopts_clean 스크립트 끝에서 호출 하여 임시 디렉토리 $CGIBASHOPTS_DIR 업로드 된 파일을 저장하는 경우 -n 옵션 (아래 참조)이 사용되지 않은 경우. cgibashopts는 trap cgibashopts_clean 0 사용하여 스크립트 끝 에서이 함수가 자동으로 호출되도록하므로 trap 0 직접 사용하지 않는 한 아무것도 할 필요가 없으므로 Exit 신호를 cgibashopts_clean 에 extit 신호를 처리해야합니다.
    • cgibashopts 소싱하면 이전에 수행 된 trap 0 이 지워집니다. 따라서 cgibashopts 소싱 후 트랩을 0으로 설정하십시오
    • 호출 cgibashopts_clean 호출 실제로 HTML 양식 유형 file 의 입력 요소를 사용하는 경우에만 필요합니다.
    • 업로드 된 파일을 처리하자마자 cgibashopts_clean 기능을 직접 호출 할 수 있으므로 더 이상 필요하지 않으며 나중에 원하는대로 트랩을 자유롭게 사용할 수 있습니다.
    • 파일이 업로드 될 것으로 예상되지 않으면 -n 옵션을 사용할 수 있습니다 (아래 참조).
• 명령 줄 옵션 :
  • -N은 파일 업로드 요청을 무시하고 버릴 수 있습니다. 일부 공격자가 가짜 파일을 업로드하려고하지만 필수는 아니지만 일부 컴퓨팅로드를 저장할 수 있으므로 파일을 업로드 할 것으로 예상하지 않는 경우 권장됩니다. 또한 변수 $CGIBASHOPTS_DIR 또는 함수 cgibashopts_clean 정의하지 않으며 트랩을 사용하지 않습니다. 참고 : 이것은 버전 3 이상에서만 사용할 수 있습니다. 사용의 예 : . cgibashopts -n
  • -D 디렉토리는 파일 업로드의 경우 CGIBAShOptions가 임시 파일을 관리 할 위치를 지정합니다. 기본값 /tmp . cgibashoptions는 cgibashopts-files.$$ 하위 디렉토리 ( $$ 는 $CGIBASHOPTS_DIR 변수에 표시된 $$가 인스턴스 당 고유 한 Bash 프로세스 번호입니다).
• 변수 CGIBASHOPTS_RELEASE 릴리스 버전을 보유하고 있으며 Cgibashopts Libray의 시맨틱 버전 (예 : 4.0.1, 4.4.3)을 사용합니다.
  • 변수 CGIBASHOPTS_VERSION 주요 버전 번호 (위의 CGIBASHOPTS_RELEASE 의 첫 번째 정수, 거꾸로 호환성을 유지합니다.
• 기타 케이크 :
  • 두 가지 편리한 bash 기능이 제공됩니다.
    • urldecode 변수에서 문자열을 가져 와서 디코딩 된 버전을 출력하고, 공백에서 + 변환하고 16 진수 ASCII 코드 XX (eg %41이 A)의 특성에서 %XX 변환하고 캐리지 리턴을 제거합니다.
    • 역 작동을 수행하는 urlencode . 둘 다 바이너리 Linux 명령보다 빠릅니다.
  • 두 가지 변수 $nl 과 $cr Newline과 Carriage Return 문자를 보유합니다.
  • 변수 값을 얻는 대체 방법은 param 함수를 통한 것입니다. 이것은 사용 된 사람들 (또는 스크립트)을위한 Bashlib와 호환되는 편의 기능입니다.
    • 인수가없는 param FORMS 의 값을 출력합니다
    • param foo FORM_foo 의 값을 출력합니다
    • param foo a string... FORM_foo 의 값을 "a string..." 로 설정합니다.
    • param -f 인쇄 $FORMFILES
    • param -f foo prints $FORMFILE_foo
    • param -f foo a string... FORMFILE_foo 의 값을 "a string..." 로 설정합니다.

테스트 스위트

테스트 스위트가 제공되며 ./tests/RUN-ALL-TESTS 가 실행할 수 있습니다. 자세한 내용은 디렉토리 tests 의 readme.md를 참조하십시오.

그것을 사용하는 프로젝트

• Watermark-PDF PipoProds의 PDF 워터 마킹 스크립트 용 웹 프론트 엔드
• 모든 github에서 모든 github 프로젝트를 참조하십시오.

피드백

이 프로젝트를 복사하고 향상시킬 수있을뿐만 아니라 버그 보고서, 피드백, 제안을 제공합니다.

• GitHub 계정이있는 경우 문제를 만듭니다.
• 제공된 GIT 보고서 양식을 사용하여 GitHib 계정이없는 경우 문제를 만듭니다.
• 이 프로젝트에 대한 토론을 만들거나 참여하십시오
• 또는 [email protected]으로 이메일을 보내주십시오

변화의 역사

• 2023-01-11 v4.1.3 : Bash 버전 <4.4의 버그를 피하기 위해 테스트 제품군의 수정. CGIBASHOPTS 실제 코드는 변경되지 않으며 레거시 시스템에서 테스트 스위트를 통과시키지 않으면 업그레이드 할 필요가 없습니다.
• 2023-01-08 v4.1.2 : 버그 수정 : 세미콜론 만 Content-Type 및 Content-Disposition HTTP 헤더에서 분리기로 이해되었습니다. 쉼표를 사용하도록 수정되었습니다. "Florin-CTU"에 의해보고 된 버그, #8 및 #9.
• 2022-11-24 v4.1.1 : 버그 수정 : 파일 업로드 필드가 무시한 후 형태 필드. 업그레이드하십시오! "PipoProds"의 버그 보고서, 문제 #7.
• 2021-12-23 v4.1.0 :
  • 새로운 var CGIBASHOPTS_RELEASE 와 함께 시맨틱 버전으로 전환했습니다
  • 임시 디렉토리를 지정하는 새로운 -D 옵션 ( "Aufschlauer"의 제안)
  • Github로 이동 : 테스트/Tewiba는 1.5.0으로 업그레이드 한 Tests/에서 대부분의 파일을 메인 뷰에서 옮겼습니다.
• 2020-04-16 버전 4 : Urlencode Goodie 함수가 추가되었습니다
• 2020-04-04이 문서와 테스트 (테스트 스위트 디어는 테스트로 이름이 바뀌 었음)의 일부 미용 변경이지만 Cgibashopts 코드 자체에 변경되지 않으므로 버전 번호는 증가하지 않습니다.
• 2020-03-27 버전 3 : -N 옵션이 추가되어 파일 업로드 비활성화
• 2018-10-09 버전 2 : 수정, 매개 변수 값의 공간은 +로 볼 수 있습니다.
• 2017-12-13 버전 1 : 다양한 MIME 유형의 파일 업로드에 대한 수정은 이제 -u 및 set -e를 사용하여 스크립트에서 라이브러리를 사용할 수 있습니다.
• 2017-12-07 프로젝트 제작