2015-10-20

리눅스 파일 구조와 파일 권한 읽기, 명령어 소개

파일 구조

ls -l 명령어로 파일 목록 출력했을 때 보이는 화면
형식: {파일유형} : {파일권한} : {링크수} : {소유 계정} : {그룹명} : {파일크기} : {마지막 변경 일자} : {파일명}
ex> d : rwxr-xr-x. : 2 : root : root : 4096 : Feb 3 13:48 : Desktop

ls -l 명령어로 보는 파일 구조

파일 유형

  • -: 파일
  • d: 디렉토리
  • b: 블록 디바이스
  • c: 문자 디바이스
  • l: 링크

허가권

  • r: 읽기 허가- 파일 내용을 읽을 수 있는지 결정
  • w: 쓰기 허가- 파일을 작성하거나 지울 수 있는지 결정
  • x: 실행 허가- 파일을 실행할 수 있는지 결정
 r  w  x   r   w   x   r   w   x 
 user  user    user    group  group    group    other  other   other 
user는 사용자 계정 본인
group은 사용자 계정이 속한 그룹에 있는 계정
other는 본인도 아니고 그룹에 속한 계정도 아닌 계정들이다. 

ex> d rwxr-xr-x. 2 root root 4096 Feb 3 13:48 Desktop
    - rwxr-xr-x: 유저는 읽고 쓰고 실행(rwx)할 수 있는 권한을 가지고 있으며 그룹은 읽고 실행(r-x)할 수 있는 권한을 가지고 있고 그룹을 제외한 타인들은 읽고 실행(r-x)할 수 있는 권한을 가지고 있다는 의미이다.

chown : 소유권 변경  

자신이 다른 계정의 파일을 복사해 왔을 때 파일의 소유권이 여전히 다른 사람 그대로이다.
ex> chown {아이디}(:{그룹})


chmod : 허가권 변경

상징모드와 절대모드 2가지 방법으로 허가권을 변경
ex> chmod {숫자/기호} {아이디}

 기호 의미  기호  의미 
 + 허가 권한 부여  사용자(소유자) 권한 
 - 허가 권한 제거  그룹 권한 
 = 허가 권한 유지  타인 권한 
 $ 소유자 또는 그룹만 실행  소유자, 그룹 타인 모두 권한 

1. 상대모드

ex> chmod ugo+rwx {파일/디렉토리이름}
    - 소유자u, 소유그룹g, 타인o 모든 계정이 읽고r 쓰고w 실행x을 가능+하게 함.
ex> chmod go-rwx {파일/디렉토리이름}
    - 소유그룹g, 타인o 계정이 읽고r 쓰고w 실행x을 불가능-하게 함.

2. 절대모드 (자주 사용하며 쉬움)

- 사용자+그룹+타인, 읽기4, 쓰기2, 실행1
ex> 444: 사용자, 그룹, 타인 모두 읽기 가능
ex> 666: 사용자, 그룹, 타인 모두 읽기 쓰기 가능 (4+2)
continue reading 리눅스 파일 구조와 파일 권한 읽기, 명령어 소개
Share This:    Facebook Twitter

2015-10-17

대표적인 리눅스 파일 디렉터리 설명

리눅스는 기본적으로 FHS(Filesystem Hieranchy Standard) 시스템이기 때문에 모든 것을 파일로 처리하고 있다. 그래서 폴더별로 기능이 분명하다.
/는 기본적으로 최상위 폴더를 의미하며 최상위에 속해 있는 1단계 디렉터리만 정리하는 것으로 하였다. 예외적으로 /usr 디렉터리에 대해서만 2단계 디렉터리 내용을 정리하였다.

/dev

  • 마우스, 모니터, 비디오 카드, 하드디스크 같은 주변 장치가 파일로 등록되어 있는 디렉터리

/etc

  • 시스템 설정 파일이 들어있는 디렉터리
  • 시스템 환경을 결정하는 파일들 (사용자 정보, 그룹, 파일 시스템 테이블, 네트워크 등)이 등록 되어 있음 

/bin

  • 기본적인 처리 명령들이 실행 파일 형태로 저장
  • 어느 곳에서나 실행 가능 (경로를 /bin으로 바꾸지 않아도 실행 가능)

/lib

  • 공유 라이브러리 파일이 저장
  • 부팅과 응용프로그램 실행에 필요한 코드 저장(중요)

/home

  • 새로운 계정을 만들면 계정 폴더가 이 디렉터리에 생성
  • 각각의 홈 디렉터리는 새로 등록된 사용자들의 소유권, 허가 권이 설정됨
  • 사용자는 자신의 개인 파일들을 이 디렉터리 밑에 저장

/root

  • 루트 계정을 위해 제공되는 홈 디렉터리
  • 일반 홈 디렉터리와 같은 개념이지만 루트를 위한 디렉터리이기 때문에 일반 사용자는 접근 불가

/proc

  • 고유의 시스템 정보를 실시간으로 확인할 수 있는 특별한 내용 포함
  • ex> 시스템 상태 모니터링

/sbin

  • 전반적인 시스템 관리 명령이 들어있는 디렉터리
  • root 계정만 사용 가능

/tmp

  • 어떠한 작업을 위해 임시로 파일을 만들거나 지우는 공간
  • 임시 공간

/var

  • 시스템을 운영하면서 생기는 각종 임시 파일을 저장하는 디렉터리
  • 임시 공간

/usr

  • 시스템 응용 프로그램에서 필요한 파일이 저장되어 있는 디렉터리
  • 선택 설치

/usr/bin

  • 추가 사용자 프로그램이 저장되는 곳
  • 필수 명령 외에 대부분 명령 파일

/usr/games

  • 게임 프로그램이 설치되는 디렉터리

/usr/include

  • 프로그래밍과 관련된 헤더 파일

/usr/lib

  • 각종 라이브러리

/usr/local

  • 사용자가 직접 설치하는 프로그램이 저장되는 디렉터리

/usr/sbin

  • 관리자 용 추가 프로그램이 있는 곳
  • 주로 네트워크 데몬이 있음

/usr/src

  • 프로그램의 소스가 있는 곳
continue reading 대표적인 리눅스 파일 디렉터리 설명
Share This:    Facebook Twitter

2015-10-06

리눅스 명령어 정리 - 기본

리눅스에 대한 관심이 생겨나던 때, 리눅스의 첫 걸음은 당연히 명령어를 살펴보는 것이었다. 당시에 정리해 둔 요약이 있어서 하나씩 업로드 해볼 생각이다. 옛 생각이 새록새록 나기도 하고 정리해두면 언젠간 다시 와서 볼 것 같다.

PWD

현재 경로보기
현재 경로는 /root라고 표시되어 있다.

CD

해당 디렉토리 이동하기
사용법: cd {인자값}
  • cd.: 현재 디렉토리로 이동
  • cd..: 상위 디렉토리로 이동
  • cd~: 홈 디렉토리로 이동
  • cd-: 이전 작업 디렉토리로 이동
/usr 폴더로 이동하였다.

LS

파일 내역 출력
사용법: ls {옵션} {디렉토리/파일}
  • -a: 모든 파일과 디렉토리 표시 
  • -l: 자세히 출력 
  • -d: 디렉토리 정보 출력 
  • -n: UID, GID 출력 
  • -R: 하위 경로와 모든 파일 나열 
/usr 폴더의 모든 파일과 디렉토리를 자세히 출력

CP

파일, 디렉토리 복사
사용법: cp {옵션} {복사소스} {복사위치}
  • -f: 강제로 복사 
  • -r: 하위 경로 포함하여 복사 
  • -v: 복사 진행 상황 출력 
  • -s: 링크 정보 유지하여 복사 

/tmp/amy2/test2.txt 파일을 /tmp 폴더에 하위 경로를 포함하여 복사
팁: 생성후 바로 cp명령어를 사용하면 사용 중이기 때문에 'omitting directory'에러가 날 것이다. 그땐 -r 옵션으로 강제로 복사하자

MV

파일, 디렉토리 이동
사용법: mv {옵션} {이동소스} {이동타겟}
  • -i: 이동에 대한 실행 여부 물음 
  • -f: 강제로 이동 
  • -u: 이동 대상 위치보다 최근 파일 시 이동 
  • -v: 이동 진행 상태 출력 
  • -b: 대상 파일이 이미 있어 백업 파일 생성 

amy1 디렉토리에서 test1.txt 파일 생성 후에 amy2로 이동하여 확인

MKDIR

디렉토리 생성
사용법: mkdir {옵션} {이름}
  • -m: 디렉토리 생성 시 기본 권한 설정 
  • -p: 상위 디렉토리 생성
  • --help: 도움말 
  • --version: 버전 표시 

777 권한의 amy1 디렉토리를 생성 한 후 그 폴더가 잘 생성되었는지 검색

RM

파일 디렉토리 삭제
사용법: rm {옵션} {디렉토리/파일}
  • -f: 강제삭제 
  • -r: 디렉토리 삭제 시 하위 경로와 파일 삭제 
  • -v: 파일 삭제 정보를 자세히 보여줌 

/tmp/amy1 폴더를 삭제하는데 폴더 하위에 포함된 파일 까지 모두 삭제

CAT

텍스트 파일 내용 출력
사용법: cat ({옵션}) {파일 이름}
  • >: 내용 덮어 씌우기 
  • >>: 기존 파일 내용 추가 
test1.txt파일에 내용 추가후 조회하며, >>명령어를 통해 내용을 추가하였다. 내용 저장은 Ctrl+d

TOUCH

파일 생성 및 시간 정보 변경
사용법: touch {옵션} {파일이름}
  • -r: 시간 동기화 
  • -t: 지정 시간으로 변경 

HEAD

파일 내용 중 처음부터 10줄 출력
사용법: head {파일이름}

TAIL

파일 내용중 마지막부터 10줄 출력
사용법: tail {파일이름}

MORE

파일 내용 화면 단위로 출력
사용법: more {파일이름}
more 명령어를 통해 파일을 열었고 화면 크기인 4줄이 출력되며 60%내용이 남아있음

FILE

파일 종류 확인
사용법: file {파일이름}

FIND (중요)

파일 찾기
꼭 알아두기!
  • *: 모든것을 의미
  • $와 같이 쉘에서 의미를 갖는 문자를 검색할경우 \와 함께 작성
  • 단어 검색 시 single quotaion(')을 앞뒤에 붙인다. 
  • 각 옵션은 혼합하여 사용가능
  • 숫자 옵션 +n : n이상인 파일 검색,
    -n: n이하인 파일 검색,
    n: n과 일치하는 파일 검색

파일명 검색 -name

파일 명에 'php'가 들어간 파일 검색 : # find .-name '*php'

용량 검색 -size

용량이 100KB 이상인 파일 검색 : # find .-size +100k

파일 형식 -type


  • f: 일반파일
  • d: 디렉터리
  • l: 심볼릭 링크 파일
  • s: 소켓파일
디렉터리이면서 이름중에 melong이 들어간 것을 검색 : # find .-type d -name '*melong*'

파일의 소유자 -user

소유자가 nobody인 파일 검색 : # find .-user nobody

파일의 수정일자 -mtime

  • mtime +n : 오늘을 기준으로 n일 이전에 변경된 파일 검색
  • mtime -n : 오늘을 기준으로 n일 이내에 변경된 파일 검색
3일 이내에 변경된 파일 검색 : #find .-mtime -3

    파일의 액세스 일자 -atime

    • atime +n : 오늘을 기준으로 n일 이전에 엑세스한 적이 있는 파일 검색
    • atime -n : 오늘을 기준으로 n일 이내에 엑세스한 적이 있는 파일 검색
    10일 이전에 엑세스한 적이 있는 파일 검색 : # find .-atime +10

      검색할 디렉터리 깊이 지정 -maxdepth

      지정한 디렉터리에서 n개 깊이의 디렉터리까지 검색한다. 
      2개의 깊이에 있는 디렉터리까지 검색하여 파일명에 'php'가 있는 파일 검색 : # find .-name '*php*' -maxdepth 2

      검색한 파일에 대한 특정 명령을 실행 -exec 명령어 {} \;

      -exec 명령어 {} \;: {}안에는 찾은 파일명이 들어가게 된다.
      파일명이 bak로 끝나는 파일을 찾아서 삭제 : # find .-name '*bak' -exec rm {} \;

      ifconfig

      네트워크 정보 출력
      윈도우 명령어 ipconfig와 상응하는 리눅스 명령어이다.
      ifconfig 명령어를 통해 네트워크 정보 출력

      Route

      게이트웨이 설정 & 확인
      route 명령어로 게이트웨어 설정을 확인

      Shutdown

      시스템 종료
      사용법: shutdown {옵션} {시간} "메세지"
      • -k: 모든 사용자에게 메세지 전송 
      • -h: 시스템 종료 
      • -r: 시스템 재부팅 
      • +m: 종료 시점 시간 지정 
      • now: 명령어를 수행하는 순간 종료

      파이프(|)와 필터

      파이프(|)

      앞 프로그램 결과를 뒤 프로그램 입력 값으로 전달
      사용법: ls -al /usr/bin | more

      필터(grep)

      표준 입력으로부터 자료를 읽어 간단한 처리 후 표준 출력으로 보내는 프로그램
      사용법: ps aux | grep xfs

      리다이렉션(Redirection) 

      • 표준 출력 리다이렉션 : 출력을 파일로 전환
        사용법: ls /usr/bin > list_file
      • 표준 오류 리다이렉션 : 실행에서 오류가 있을 시 오류만 파일로 전환
        사용법: ls /usr/bin 2>/dev/null
      참고: /dev/null은 리눅스에서 휴지통을 의미한다.
      continue reading 리눅스 명령어 정리 - 기본
      Share This:    Facebook Twitter

      2015-09-03

      [번역] 의존성 관리 도구 컴포저 - 명령어 줄 인터페이스 / 명령어

      * 원문: https://getcomposer.org/doc/03-cli.md

      워낙 양이 많아서 나눠서 해볼까 고민하다가 한 페이지인데 나눠서 뭐하나 싶기도 해도 한꺼번에 번역해보았습니다.



      명령어 줄 인터페이스 / 명령어

      여러분은 이미 명령어 줄 인터페이스를 어떻게 사용하는지 배웠다. 이 장은 사용할 수 있는 명령어를 모은 문서이다.

      명령어 줄에서 도움을 받으려면 모든 명령어 리스트를 보기 위해 간단하게 composercomposer list를 호출하고 정보를 얻고 싶은 명령어와 --help를 합쳐서 호출하면 된다.

      전역 옵션

      다음 옵션은 모든 명령어에 사용할 수 있다.
      • --verbose (-v): 메세지의 자세하게 표시한다.
      • --help (-h): 도움말 정보를 표시한다.
      • --quiet (-q): 어떤 메세지도 출력하지 않는다.
      • --no-interaction (-n): 어떤 대화식 질문도 하지 않는다.
      • --working-dir (-d): 지정되면 작업 디렉토리로 지정된 디렉토리를 사용한다.
      • --profile: 타이밍과 메모리 사용 정보를 표시한다.
      • --ansi: ANSI로 강제 출력한다.
      • --no-ansi: ANSI 출력을 비활성화 한다.
      • --version (-V): 애플리케이션 버전을 표시한다.

      종료 코드 과정

      • 0: OK
      • 1: 일반/알 수 없는 오류 코드
      • 2: 의존성 해결 오류 코드

      init

      라이브러리 장에서 우리는 수동으로 composer.json를 어떻게 만드는지 살펴보았다. init 명령어는 이러한 절차를 조금 더 쉽게 할 수 있다.

      이 명령어를 실행하면 일부 기본 값을 사용하면서 대화형으로 항목을 기입할 수 있을 것이다.

      php composer.phar init

      옵션

      • --name: 패키지 이름
      • --description: 패키지 설명
      • --author: 패키지 제작자 이름
      • --homepage: 패키지 홈페이지
      • --require: 패키지 버전 제약 조건을 요구한다. foo/bar:1.0.0 형식이어야 한다.
      • --require-dev: 개발 요구 사항, --require 참고
      • --stability (-s): minimun-stability항목 값

      install

      install 명령어는 현재 디렉터리에서 composer.json 파일을 읽고 종속성을 해결하고 vendor로 설치한다.

      php composer.phar install

      현재 디렉터리에 composer.lock 파일이 있으면 composer.json 파일을 해결하는 대신 그 파일에서 정확한 버전을 사용할 것이다. 라이브러리를 사용하는 모든 사람은 같은 의존성을 얻는다는 것을 보장한다.

      composer.lock 파일이 없으면 컴포저는 종속성 작업을 처리한 후에 파일을 생성할 것이다.

      옵션

      • --prefer-source: 패키지를 다운로드하는 방법에는 sourcedist 이렇게 2가지 방법이 있다. 안정 버전의 경우 컴포저는 기본적으로 dist를 사용한다. source는 버전 관리 저장소이다. --prefer-source를 사용할 수 있고 존재한다면 컴포저는 source에서 설치할 것이다. 이는 프로젝트에 버그 수정을 하고 직접 종속성의 로컬 git 클론을 얻을 때 유용하다.
      • --prefer-dist: --prefer-source의 반대이다. 컴포저는 가능하면 dist에서 설치한다. 이 명령어는 빌드 서버와 일반적으로 벤더 업데이트를 실행하지 않는 다른 경우에 대체로 설치 속도를 높일 수 있다. 이 옵션은 올바른 설정이 없는 경우 git의 문제를 회피하는 방법이다.
      • --ignore-platform-reqs: php, hhvm, lib-*, ext-* 요청을 무시하고 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참고하라.
      • --dry-run: 만약 실제로 패키지 설치 없이 설치를 통해 실행하고 싶으면 여러분은 --dry-run을 사용할 수 있다. 이것은 설치를 시뮬레이션하고 어떤 일이 일어나는지 보여준다.
      • --dev: require-dev에서 나열된 패키지를 설치한다 (기본 동작이다).
      • --no-dev: require-dev에서 나열된 패키지 설치를 건너뛴다. 자동 로드 생성은 자동 로드-개발 규칙을 건너 뛴다.
      • --no-autoloader: 자동 로드 생성을 건너뛴다.
      • --no-scripts: composer.json에서 정의된 스크립트 실행을 건너 뛴다.
      • --no-plugins: 플러그인을 비활성화 한다.
      • --no-progress: 백 스페이스 문자를 처리하지 않는 일부 터미널이나 스크립트를 엉망으로 만들 수 있는 진행 표시를 제거한다.
      • --optimize-autoloader (-o): 빠른 오토로드를 얻기 위해 PSR-0/4를 클래스 맵으로 변환한다. 특히 실제품에 추천하지만 실행하는데 시간이 더 걸리므로 기본적으로 수행하지 않는다.

      update

      의존성 최신 버전을 받고 composer.lock 파일을 업데이트 하기 위해서 update 명령어를 사용해야 한다.

      php composer.phar update
      이것은 프로젝트에서 모든 의존성을 해결하고 composer.lock에 정확한 버전을 작성할 것이다.

      만약 여러분이 몇몇 패키지와 일부를 업데이트 하고 싶으면 여러분은 다음와 같이 나열할 수 있다.

      php composer.phar update vendor/package vendor/package2
      또한 한번에 패키지를 업데이트하기 위해 와일드 카드 문자(*)를 사용할 수 있다.

      php composer.phar update vendor/*

      옵션

      • --prefer-source: 사용할 수 있을 때 source로 패키지를 설치한다.
      • --prefer-dist: 사용할 수 있을 때 dist로 패키지를 설치한다.
      • --ignore-platform-reqs: php, hhvm, ext-* 요청을 무시하고 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참조하라.
      • --dry-run: 실제 동작 없이 명령어를 시뮬레이션한다.
      • --dev: require-dev에서 설치한 패키지를 나열한다 (기본 동작이다).
      • --no-dev: require-dev에서 설치한 패키지를 나열하는 것을 건너 뛴다. 자동 로드 생성은 autoload-dev 규칙을 건너뛴다.
      • --no-autoloader: 자동 로드 생성을 건너뛴다.
      • --no-scripts: composer.json에서 정의한 스크립트 실행 동작을 건너뛴다.
      • --no-plugins: 플러그인을 비활성화 한다.
      • --no-progress: 백스페이스를 다룰 수 없는 몇몇 터미널이나 스크립트에서 엉망으로 만들 수도 있는 진행바 표시를 제거한다.
      • --optimize-autoloader (-o): 빠른 오토로드를 얻기 위해 PSR-0/4를 클래스 맵으로 변환한다. 특히 실제품에 추천하지만 실행하는데 시간이 더 걸리므로 기본적으로 수행하지 않는다.
      • --lock: 오래된 잠금 파일에 대해 경고를 숨기기 위해 잠금 파일 해시를 업데이트만 한다.
      • --with-dependencies: 허용 목록을 위해 허용된 패키지의 모든 의존성을 추가한다.
      • --prefer-stable: 안정적인 의존성 버전을 우선 시 한다.
      • --prefer-lowest: 가장 낮은 의존성 버전을 우선 시 한다. 최소 요구를 테스트할 때 유용하고 일반적으로 --prefer-stable와 같이 사용한다.

      require

      require 명령어는 현재 디렉터리에서 composer.json 파일에 새 패키지를 추가한다. 파일이 존재하지 않으면 바로 파일을 하나 생성한다.

      php composer.phar require
      추가/변경 요청 후에 수정 요구는 설치되거나 업데이트 될 것이다.

      만약 대화형으로 요구 사항을 선택하고 싶지 않으면 이 명령어를 통해 통과하면 된다.

      php composer.phar require vendor/package:2.* vendor/package2:dev-master

      옵션

      • --prefer-source: 사용할 수 있을 때 source로 패키지를 설치한다.
      • --prefer-dist: 사용할 수 있을 때 dist로 패키지를 설치한다.
      • --ignore-platform-reqs: php, hhvm, ext-* 요청을 무시하고 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참조하라.
      • --dev: require-dev로 패키지를 추가한다.
      • --no-update: 의존성을 자동으로 업데이트 하는 것을 비활성화 한다.
      • --no-progress: 백 스페이스 문자를 처리하지 않아서 일부 터미널이나 스크립트를 혼란스럽게 할 진행 표시를 제거한다.
      • --update-no-dev: no-dev 옵션으로 의존성 업데이트를 실행한다.
      • --update-with-dependencies: 새롭게 패키지를 요구한 의존성을 업데이트한다.
      • --sort-packages: composer.json에서 패키지가 정렬되는 것을 유지한다.

      remove

      remove 명령어는 현재 디렉터리의 composer.json 파일에서 패키지를 제거한다.

      php composer.phar remove vendor/package vendor/package2
      요청대로 제거한 후에 수정된 요구 사항은 삭제 된다.

      옵션

      • --ignore-platform-reqs: php, hhvm, ext-* 요청을 무시하고
      • 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참조하라.
      • --dev: require-dev로 패키지를 제거한다.
      • --no-update: 의존성을 자동으로 업데이트 하는 것을 비활성화 한다.
      • --no-progress: 백 스페이스 문자를 처리하지 않아서 일부 터미널이나 스크립트를 혼란스럽게 할 진행 표시를 제거한다.
      • --update-no-dev: --no-dev 옵션과 함께 의존성 업데이트를 실행한다.
      • --update-with-dependencies: 제거한 패키지의 의존성을 업데이트 한다.

      global

      전역 명령어는 마치 COMPOSER_HOME 디렉터리에서 실행한 것처럼 install, require, update같은 다른 명령어를 실행할 수 있다.

      이 명령어는 환경 변수 $PATH$COMPOSER_HOME/vendor/bin를 추가한다면 전역으로 CLI 유틸리티를 설치할 때 사용할 수 있다. 여기에 예제가 있다.

      php composer.phar global require fabpot/php-cs-fixer:dev-master
      이제 php-cs-fixer 바이너리는 (당신이 경로를 조정했다는 가정 하에) 전역으로 사용할 수 있다. 만약 여러분이 나중에 바이너리를 업데이트 하고 싶으면 전역 업데이트를 실행하면 된다.

      php composer.phar global update

      search

      검색 명령어는 현재 프로젝트 패키지 저장소를 통해 검색할 수 있다. 보통 이 방법은 패키지스트가 할 것이다. 여러분은 단순히 검색할 조건을 전달한다.

      php composer.phar search monolog
      여러분은 다중 인자를 통해 둘 이상의 용어를 검색할 수 있다.

      옵션

      • --only-name (-N): 이름으로만 검색

      show

      사용할 수 있는 패키지를 나열하기 위해서 show 명령어를 사용할 수 있다.

      php composer.phar show monolog/monolog
      
      name     : monolog/monolog
      versions : master-dev, 1.0.2, 1.0.1, 1.0.0, 1.0.0-RC1
      type     : library
      names    : monolog/monolog
      source   : [git] https://github.com/Seldaek/monolog.git 3d4e60d0cbc4b888fe5ad223d77964428b1978da
      dist     : [zip] https://github.com/Seldaek/monolog/zipball/3d4e60d0cbc4b888fe5ad223d77964428b1978da 3d4e60d0cbc4b888fe5ad223d77964428b1978da
      license  : MIT
      
      autoload
      psr-0
      Monolog : src/
      
      requires
      php >=5.3.0

      옵션

      • --installed (-i): 설치된 패키지 목록.
      • --platform (-p): 플랫폼 패키지 목록 (php & 확장 기능).
      • --self (-s): 루트 패키지 정보 목록


      browse / home

      browse (별칭 home)는 브라우저에서 패키지 저장소 URL이나 홈페이지를 연다.

      옵션

      • --homepage (-H): 저장소 URL 대신 홈페이지를 연다.


      suggests

      현재 설치된 패키지 세트는 모든 패키지 목록을 제안한다. 여러분은
      그들의 패키지에 의해 만들어진 제안 결과물을 제한하기 위해
      vendor/package 형식에서
      선택적으로 하나 또는 여러개 패키지 이름을 건너뛸 수 있다.

      옵션

      • --no-dev:require-dev 패키지에서 제안을 제외한다.
      • --verbose: (-v): 증가된 상세 내용은 제안한 패키지 이름과 제안 이유를 추가한다.


      depends

      depends 명령어는 다른 패키지가 특정 패키지에 의존한다는 것을 말한다. 여러분은 리스트에 포함되어야 하는 링크 유형(require, require-dev) 을 지정할 수 있다. 기본적으로 모두 사용된다.

      php composer.phar depends --link-type=require monolog/monolog
      
      nrk/monolog-fluent
      poc/poc
      propel/propel
      symfony/monolog-bridge
      symfony/symfony

      옵션

      • --link-type : 링크 유형을 여러번 지정할 수 있다.


      validate

      여러분은 composer.json 파일을 실행하기 전에 혹은 태그를 릴리즈하기 전에 항상 validate를 실행해야 한다. composer.json가 유효하다면 확인할 것이다.

      php composer.phar validate

      옵션

      • --no-check-all: composer.json에 있는 요구사항이 언바운드 버전 제약이면 경고 (warning) 를 표시하지 않는다.
      • --no-check-lock: composer.lock 파일이 존재하거나 최신 파일이 아니면 에러 (error) 를 표시하지 않는다.
      • --no-check-publish: composer.json 파일이 패키지스트에 패키지로 발행하기에 적합하지 않으면 에러 (error)를 표시하지 않지만 그렇지 않으면 유효하다.

      status

      만약 여러분이 의존성 코드나 설치된 소스를 자주 수정한다면 status 명령어는 여러분이 로컬에서 변경되었는지 확인할 수 있다.

      php composer.phar status

      --verbose 옵션를 함께 쓰면 여러분이 변경된 정보에 대해 더 자세히 알 수 있다.

      php composer.phar status -v
      
      You have changes in the following dependencies:
      vendor/seld/jsonlint:
          M README.mdown

      self-update

      컴포저 스스로 최신 버전으로 업데이트하기 위해서 그냥 self-update 명령어를 실행하면 된다. 이 명령어는 composer.phar 파일을 최신 버전으로 교체할 것이다.

      php composer.phar self-update

      특정 릴리즈를 간단하게 업데이트 하려면 다음과 같이 사용하면 된다.

      php composer.phar self-update 1.0.0-alpha7

      전체 시스템 (전역 설치 참고) 에 설치된 컴포저가 있다면 root 권한으로 명령어를 실행할 것이다.

      sudo composer self-update

      옵션

      • --rollback (-r): 설치된 마지막 버전으로 롤백한다.
      • --clean-backups: 업데이트 하는 동안 오래된 백업을 삭제한다. 업데이트 후에 컴포저의 현재 버전이 사용할 수 있는 백업 하나를 만든다.

      config

      config 명령어는 여러분이 로컬 composer.json 파일이나 전역 config.json 파일에서 몇몇 컴포저 기본 설정을 수정할 수 있도록 해준다.

      php composer.phar config --list

      사용

      config [options] [setting-key] [setting-valu1] ... [setting-valueN]

      setting-key는 설정 옵션 이름이고 setting-value1은 설정 값이다.
      (github-protocols 같이) 배열 값일 경우 허용된 설정 값 인자가 하나 이상이다.

      유효한 설정 옵션을 보려면 설정 장을 참고하라.

      옵션

      • --global (-g): 기본으로 $COMPOSER_HOME/config.json에 위치한 전역 설정 파일을 운영한다.
        이 옵션이 없으면 이 명령어는 로컬 composer.json 파일이나 --file로 지정된 파일에 영향을 미친다.
      • --editor (-e): 환경 변수 EDITOR가 정의한 텍스트 에디터에서 로컬 composer.json 파일을 사용하여 연다. --global 옵션을 사용하면 전역 설정 파일을 연다.
      • --unset: setting-key가 지은 설정 요소를 제거한다.
      • --list (-l): 현재 설정 변수 리스트를 보여준다. --global 옵션을 사용하면 전역 설정만 출력한다.
      • --file="..." (-f): composer.json 대신에 특정파일을 운영한다. --global 옵션과 함께 사용할 수 없음을 숙지하자.
      • --absolute: 상대 경로 대신에 *-dir 설정값을 패치할 때 절대 경로로 반환한다.

      수정된 저장소

      추가적으로 설정 영역을 수정하려면 config 명령어는 다음과 같은 방법을 사용하여 변경 사항을 지원한다.

      php composer.phar config repositories.foo vcs https://github.com/foo/bar

      create-project

      여러분은 컴포저로 존재하는 패키지에서 새로운 프로젝트를 생성할 수 있다. 이는 vendor의 "컴포저 설치" 다음에 git 클론이나 svn 체크아웃을 하는 것과 같다.

      여기에 여러가지 애플리케이션이 있다.
      1. 여러분은 애플리케이션 패키지를 배치할 수 있다.
      2. 여러분은 어떤 패키지를 확인하고 예를 들어 패치에서 개발을 시작할 수 있다.
      3. 여러 개발자가 참여하는 프로젝트는 개발을 위해 초기 애플리케이션을 설정하기 위한 기능을 사용할 수 있다.

      컴포저를 사용하는 새 프로젝트를 생성하려면 여러분은 "create-project" 명령어를 사용할 수 있다. 패키지 이름을 전달하고 디렉토리에서 프로젝트를 만들 수 있다. 여러분은 또한 3번째 인자로 버전을 전달할 수 있고 전달하지 않으면 최신 버전이 사용된다.

      디렉토리가 현재 존재하지 않으면 설치하는 동안에 생성한다.

      php composer.phar create-project doctrine/orm path 2.2.*
      프로젝트를 초기 설정하기 위해 기존 composer.json로 디렉토리에서 파라미터 없이 명령어를 실행할 수도 있다.

      기본적으로 명령어는 packagist.org에서 패키지를 확인한다.

      옵션

      • --repository-url: 패키지를 찾기 위해 커스텀 저장소를 제공하고 패키지스트 대신에 사용된다.
        composer 저장소를 가리키는 HTTP URL이든 로컬 packages.json 파일 경로든 할 수 있다.
      • --stability (-s): 패키지의 최소 안정성. stable가 기본이다.
      • --prefer-source: 사용 가능할 때 source로 패키지를 설치한다.
      • --prefer-dist: 사용 가능할 때 dist로 패키지를 설치한다.
      • --dev: require-dev에서 설치한 패키지를 나열한다.
      • --no-install: vendor 설치를 비활성화한다.
      • --no-plugins: 플러그인을 비활성화한다.
      • --no-scripts: 루트 패키지에서 정의된 스크립트 실행을 비활성화한다.
      • --no-progress: 백스페이스를 다룰 수 없는 몇몇 터미널이나 스크립트에서 엉망으로 만들 수도 있는 진행바 표시를 제거한다.
      • --keep-vcs: 생성된 프로젝트를 위해 VCS 메타 데이터 제거하는 절차를 건너뛴다. 이 옵션은 인터렉티브하지 않은 환경에서 명령어를 실행한다면 아주 유용하다.
      • --ignore-platform-reqs: php, hhvm, lib-*, ext-* 요구사항을 무시하고
        로컬 기기에서 이행하지 않아도 강제로 설치한다.


      dump-autoload

      예를 들어 만약 여러분이 classmap 패키지에서 새로운 클래스 때문에 오토로드를 업데이트할 필요가 있다면 여러분은 설치나 업데이트를 쓸 필요 없이 "dump-autoload"를 사용하면 된다.

      추가적으로 성능상의 이유로 클래스 맵으로 PSR-0/4을 변환한 최적화 오토로더를 내려 받을 수 있다. 많은 클래스가 있는 큰 애플리케이션에서 오토로드는 매 요청 시간의 상당한 부분을 차지한다. 개발 할 때 전부 클래스맵을 사용하는 것은 그닥 편리하지는 않지만 이 옵션을 사용하여 편의를 위한 PSR-0/4와 성능을 위한 클래스 맵을 사용할 수 있다.

      옵션

      • --optimize (-o): 빠른 오토로드를 얻기 위해 PSR-0/4를 클래스 맵으로 변환한다. 특히 실제품에 추천하지만 실행하는데 시간이 더 걸리므로 기본적으로 수행하지 않는다.
      • --no-dev: 오토로드 개발용 규칙을 비활성화한다.


      clear-cache

      컴포터 캐시 디렉토리에 있는 모든 컨텐츠를 제거한다.

      licenses

      설치된 모든 패키지의 이름, 버전, 라이센스 목록을 출력한다. --format=json을 사용하여 기기가 읽을 수 있도록 결과물을 얻을 수 있다.

      옵션

      • --no-dev: 결과물에서 개발 의존성을 제거한다.
      • --format: 결과물 포맷: text나 json (기본값: "text")


      run-script

      옵션

      • --no-dev: 개발 모드를 비활성화
      • --list: 사용자가 정의한 스크립트를 나열한다.
      수동으로 이 명령어를 사용할 수 있는 스크립트를 실행하려면 그냥 스크립트 이름과 필요한 인수를 선택적으로 전달하면 된다.

      diagnose

      만일 여러분이 버그나 이상하게 동작하는 부분을 찾았다고 생각하면 여러분은 일반적인 문제에 대해 자동 검사를 수행하기 위해 diagnose 명령어를 실행하고 싶을 수도 있다.

      php composer.phar diagnose

      archive

      이 명령어는 주어진 버전에서 지정된 패키지를 위해 zip/tar 아카이브를 생성하는데 사용한다. 또한 제외나 무시되는 파일 없이 전체 프로젝트를 보관하는데 사용할 수도 있다.

      php composer.phar archive vendor/package 2.0.21 --format=zip

      옵션

      • --format (-f): 결과 아카이브의 포맷: tar, zip (기본값: "tar")
      • --dir: 이 디렉토리에 아카이브를 작성 (기본값: ".")


      help

      어떤 명령어에 대해 더 많은 정보를 얻고 싶으면 그냥 help를 쓰면된다.

      php composer.phar help install

      환경 변수

      여러분은 특정 설정을 재정의한 다양한 환경 변수를 설정할 수 있다. 가능하면 composer.json 대신 config 영역에서 이 설정을 지정하는 것이 좋다. 환경 변수 composer.json에서 지정된 값보다 항상 더 우선순위를 가지는 것에 대해 주목할 필요가 있다.

      COMPOSER

      COMPOSER 환경 변수를 설정하여 composer.json 파일이름을 다른 것으로 설정할 수 있다.

      예를 들어,
      COMPOSER=composer-other.json php composer.phar install
      이 예제를 실행하면 composer-other.lock라는 이름으로 잠금파일이 생성될 것이다.

      COMPOSER_ROOT_VERSION

      이 변수를 설정하면 VCS 정보에서 추측할 수 없고 composer.json에서 존재하지 않으면 여러분이 루트 패키지의 버전을 지정할 수 있다.

      COMPOSER_VENDOR_DIR

      이 변수를 설정하면 여러분은 vendor가 아닌 다른 디렉토리로 의존성을 설치할 수 있도록 한다.

      COMPOSER_BIN_DIR

      이 옵션을 설정하면 여러분은 vendor/bin가 아닌 다른 디렉토리로 bin (Vendor 바이너리) 로 변경할 수 있다.

      http_proxy나 HTTP_PROXY

      만일 HTTP 프록시 뒤에서 컴포저를 사용하는 경우 여러분은 표준 http_proxyHTTP_PROXY 환경 변수를 사용할 수 있다. 간단하게 여러분의 프록시 URL를 설정한다. 대다수의 운영 시스템은 이미 여러분을 위해 변수를 설정하고 있다.

      http_proxy (소문자) 를 사용하는 것이나 심지어 모두를 정의하는 것은 git이나 curl이 소문자 http_proxy 버전을 사용하는 몇몇 도구들 때문에 바람직할지도 모른다. 그렇게 하지 않으면 여러분은 git config --global http.proxy 를 사용하는 git 프록시를 정의할 수도 있다.

      no_proxy

      만일 프록시를 통하면서 특정 도메인을 해제하려는 경우 여러분은 no_proxy 환경 변수를 사용할 수 있다. 간단하게 프록시를 사용하지 않아야 하는 도메인을 쉼표로 구분하여 설정한다.

      환경 변수가 CIDR 표기법으로 작성한 도메인, IP 주소, IP 차단 주소를 승인한다. 여러분은 특정 포트에 제한을 걸 수 있다 (예: :80). 여러분은 *를 설정하여 모든 HTTP 요청 프록시를 무시할 수도 있다.

      HTTP_PROXY_REQUEST_FULLURI

      만일 프록시를 사용하지만 request_fulluri 플래그를 지원하지 않는다면 여러분은 컴포저에서 request_fulluri 옵션을 설정하는 것을 막기 위해 이 환경 변수를  false나 0으로 설정해야 한다.

      HTTPS_PROXY_REQUEST_FULLURI

      만일 프록시를 사용하지만 HTTPS를 요청하는 request_fulluri 플래그를 지원하지 않는다면 여러분은 컴포저에서 request_fulluri 옵션을 설정하는 것을 막기 위해 이 환경 변수를  false나 0으로 설정해야 한다.

      COMPOSER_HOME

      COMPOSER_HOME 변수는 여러분이 컴포터 홈 디렉토리를 변경하도록 해준다. 이는 모든 프로젝트가 공유되는 전역 (시스템 사용자별) 디렉토리이고 숨겨져 있다.

      기본적으로 *nix에서 /home//.composer, OSX에서 /Users//.composer, 윈도우에서 C:\Users\\AppData\Roaming\Composer를 가리키고 있다.

      COMPOSER_HOME/config.json

      여러분은 composer.json 파일을 COMPOSER_HOME이 가리키고 있는 위치에 놓을 수 있다. 컴포저는 여러분이 install이나 update 명령어를 실행하면 이 설정과 여러분의 프로젝트 composer.json를 병합할 것이다.

      이 파일은 여러분이 사용자 프로젝트의 저장소구성을 설정할 수 있도록 해준다.

      전역 설정이 로컬 설정이 충돌하는 경우에 프로젝트의 composer.json에 있는 로컬 설정이 항상 이긴다.

      COMPOSER_CACHE_DIR

      COMPOSER_CACHE_DIR 변수는 여러분이 컴포저 캐시 디렉토리를 변경할수 있도록 해주며 cache-dir 옵션을 통해 설정할 수도 있다.

      기본적으로 *nix, OSX에서 $COMPOSER_HOME/cache, 윈도우즈에서는 C:\Users\<user>\AppData\Local\Composer 또는 %LOCALAPPDATA%/Composer를 가리키고 있다.

      COMPOSER_PROCESS_TIMEOUT

      이 환경 변수는 명령어 (git 명령어 같은) 실행을 완수하기 위한 컴포저 대기시간을 조정한다. 기본값은 300초이다 (5분).

      COMPOSER_DISCARD_CHANGES

      이 환경 변수는 discard-changes 설정 옵션을 조정한다.

      COMPOSER_NO_INTERACTION

      1로 설정되어 있으면 이 환경 변수는 컴포저가 모든 명령어에 --no-interation를 전달하는 것처럼 동작할 것이다. 이것은 boxes/CI 빌드에서 설정할 수 있다.
      continue reading [번역] 의존성 관리 도구 컴포저 - 명령어 줄 인터페이스 / 명령어
      Share This:    Facebook Twitter

      2015-08-29

      [번역] 비밀번호와 가입 폼을 위한 UX 디자인

      * 원문: http://www.sitepoint.com/ux-design-passwords-registration-forms/

      확실히 폼 자체가 가지는 중요도는 높아지는 만큼 데이터를 최소한으로 입력하고자 하는 사용자 심리는 만국 공통인듯 하다. 그렇지만 어떻게 배치할 것인가에 대한 UX에 대한 판단은 각 나라별로 작게 또는 크게 차이가 날 수도 있다고 생각한다. 분명한 것은 모바일이 대두되면서 확실히 폼에 대한 개념이 많이 바뀌었으며 지금도 계속 변화하고 있다는 점이다.

      그런 의미로 가볍에 읽을만한 글이기에 번역해 보았다.


      비밀번호와 가입 폼을 위한 UX 디자인


      폼 양식은 특히 사용자 경험을 다듬는 것에 집중할 수 밖에 없는 모바일의 등장 이후로
      2015년 웹 디자인에서 결정적인 부분이다.

      폼은 전자상거래 사이트에서 강력한 영향을 미치는 전환의 핵심이고 좋은 설계는 보통 성공적으로 사용자를 가입하게 하거나 영원히 그들을 잃을 수 있는 차이를 낸다.

      사용자 관점에서 폼은 그들로부터 무엇을 요청할 지에 대해 사용자와 명백히 의사소통이 필요하다. 그들은 접속하는 기기에 상관없이 클릭하고 타자를 치는 것이 힘들지 않아야 한다. 그리고 적절하게 정렬된 라벨로 사용자가 입력해야 할 항목을 표시해야 한다.

      예전에는 어쩌면 나중에 필요할지도 모르기 때문에 될 수 있는 한 많은 정보를 요구하는 것이 일반적이었지만 요즘엔 그렇지 않다. 폼은 필요 이상으로 복잡해서는 안된다.



      이미지 제공: Will Scully-Power

      연구 결과에서는 짧은 폼이 수익이 160% 더 증가할 수 있다는 것을 보여주기에 잘못 설계된 폼이나 너무 많은 데이터를 요구하는 폼은 직접적으로 수익에 타격을 줄 수 있다고 한다.

      사용자는 가입하는 것을 좋아하지 않는다

      전통적인 가입 절차에 대해 저항하는 사용자가 점점 늘어나고 있고 사용자 계정을 생성하도록 강요하는 경우 최대 86% 정도가 자신의 행동 양식을 바꿀 것으로 나타났다.

      블루 리서치가 실시한 연구에서 설문을 통해 다음과 같은 내용을 발견하였다.
      • 54%는 어쩌면 사이트를 떠날 수 있다고 언급
      • 26%는 가입을 요구하지 않는 다른 사이트를 선택할 것이라고 함
      • 6%는 그들이 조만간 그 사이트를 피하거나 떠날 것이라고 함
      • 14%는 가입을 완료 할 것이라고 언급
      더 나아가 88%는 사이트에 가입할 때 폼 양식에 잘못된 정보를 기입했다고 말했고 90%는 앞서 가입한 그 사이트에서 계정 정보를 찾아보는 대신 간단하게 떠났다고 말했다.

      한결 같은 사용자 메세지는 분명하다. 사용자들은 가입하지 않는 것을 더 좋아하고 가능한 한 가입하는 상황을 피할 것이다. 한 술 더 떠서 이러한 저항은 점차 증가하고 있다. 계정 생성에 선택권이 주어진다면 많은 사용자들은 그들의 모든 계정을 아주 기꺼이 소셜 로그인을 사용할 것이다.

      그 결과 우리는 폼 양식이 더 단순하고 짧을 필요가 있고 사업적 관점에서 많은 고객 정보를 가지고 있으면 가끔은 유용해도 정말 수익성이 없다는 것을 깨닳았다.

      만족화

      그녀가 작성한 기사인 만족화: 웹 양식은 무엇을 의미하는가에서 제시카 엔더스는 이렇게 설명하고 있다.
      "만족화"라는 용어는 성공적으로 업무를 완수하기 위해 요청된 최소한의 에너지만을 쓰려 하는 사람의 경향과 관련이 있다. 이것은 잠재 의식에서 나오는 현상이다. (대부분의 시간에서) 우리는 어떤 일을 시작하지 않고 "난 이 일에 대해서 최소한으로만 소비할 거야" 라고 생각한다.

      그래서 폼 양식을 제작할 때 사용자 에러를 방지하도록 만족화를 기준으로 설계할 필요가 있다. 제시카는 사용자를 배려할 수 있는 가장 분명한 방법으로 여러분의 질문 구상에 대해서 특히 중요한 것을 제안한다.

      이 문제를 극복하기 위해 여러분은 다음과 같이 해야한다.
      마지막 보다는 첫 질문에서 기준을 배치하라

      이 이유는 사용자가 무의식적으로 대답해야 할 느낌이 들자마자 질문을 읽지 않으려 하기 때문이다.

      제시카는 다음과 같은 질문을 하는 것보다
      Q: 당신은 다른 곳에 2년 내에 거주한 적이 있습니까? (Y/N)

      이런 식으로 구성을 해야 한다고 말한다.
      Q: 최근 2년 내에 다른 곳에 거주한 적이 있습니까? (y/n)

      이것은 "사용자가 관심있는 부분적인 경험을 말한다." 그래서 여러분은 사용자가 선택하는 것을 확실히 하기 위해 중요한 정보를 "초기 단계"에 놓는 질문 형식으로 해야한다.

      만족하기에 대한 자세한 설명과 어떻게 여러분의 폼 설계를 극복할 수 있는지에 대해 전체 글을 확인하라.

      중복된 항목

      다른 애플리케이션에서 각기 다른 위치에 이메일이나 비밀번호 항목이 중복된 사이트를 심심치 않게 볼 수 있다. 이것은 사용자가 떠나도록 유도할 뿐 아니라 비밀번호 관리 프로그램으로 비밀번호를 저장하는 모든 사용자를 골치 아프게 할 수 있다.

      비밀번호 관리 프로그램은 일반적으로 전송 폼 이벤트로 동작하고 이름 (name) 이나 값 (value) 필드를 저장하기 때문이다.

      폼을 설계할 때 이 비밀번호 항목들이 서로 다른 이름으로 지정되어 있지 않으면 비밀번호 관리 프로그램이 항목 이름을 맞출 수 없기 때문에 폼을 채울 수 없을 것이다.

      이런 일은 흔히 일어나는 문제이며 해결하기 위해 Mammal에서는 (정말로 2개를 포함해야 하는 경우) 각 비밀번호 항목의 이름 값이 고유한지 확인하라고 조언한다. 가입 할 때 사이트에 사용자 비밀번호를 요청하지 않지만 사용자 이름은 요청하는 사이트일 경우 Mammal에서 사용자가 비밀번호를 설정하는 위치로 이동할 때 숨긴 이름 항목을 사용하는 것을 추천한다. 그 내용은 아래와 같다.

      <!-- Set password -->
      
      <form action="/signup" method="post">
        <input name="username" style="display:none;" type="text" value="{{ username }}"/>
        <input name="password" placeholder="Password" type="password"/>
        <input type="submit"/>
      </form>
      이는 새로운 사용자가 폼을 전송했을 때 비밀번호 관리 프로그램이 사용자 이름과 비밀번호 입력 항목 모두 인지 할 수 있고 저장할 수 있다는 것을 의미한다.

      이메일 항목이 중복된다면 사이트의 대부분은 보통 잘못 사용 (예: 첫 번째 항목에 입력된 내용을 복사하여 붙여넣기) 되었을 뿐 아니라 안좋은 영향을 미칠 것이라고 바로 이해한다.

      게리 개프니 같은 일부 사람들은 더욱 더 나아간다. 게리가 말하길
      나는 건방지고 불필요하게 이메일 주소를 반복적으로 요청하는 것을 발견했다. 내가 정말 어떤 서비스를 바라고 있는 상태에서 내 이메일 주소를 잘못 입력했다면 요청했던 서비스를 받지 못한 것을 알아 차릴 것이다. 나는 반복된 이메일 주소를 의미하는 손 잡아 주기 방식이 실제로 필요하지 않다.

      나는 확실히 사용자가 이런 방향을 더 이상 원하지 않다고 본다. 우리는 모두 웹 양식을 사용하는 것이 익숙하기에 배제 시킨다. 대신 여러분은 보다 쉽게 사용자가 입력하는 것을 볼 수 있도록 할 방법을 고려한다.

      • 입력을 명확히 하도록 공백을 충분히 줌
      • 흰 배경에 검은색을 사용
      • 입력 항목 크기를 키움
      여러분은 현재 이메일을 표시하는 이메일 항목 아래에 등록 정보가 전송되는 곳이므로 주소를 다시 검토해야 한다고 말하는 텍스트와 입력한 이메일 주소를 덧붙여 메세지를 추가하는 방법을 고려할 수도 있다.



      이미지 소스: LukeW Ideation and Design

      이 그림에서는 이메일 주소를 빨간색으로 표시하고 있는데 이렇게 하면 어떤 사용자는 자신이 뭔가 잘못 입력했다고 느낄 수 있고 이로 인해 사용자의 불만이 생길 수 있다. 이런 점에서 보자면 특정 요소가 각기 다른 색상을 나타내는 A/B 테스트를 고려해볼 수도 있다.

      폼 라벨

      가입 폼에서 흔히 실수 하는 것 중에 하나가 폼 라벨과 그 위치이고 심지어 모바일 혁명이 시작된 이후에 더 많이 일어난다.

      비록 데스크탑에서 완벽하게 보여도 (보통 왼쪽 정렬 된 라벨이고 이런 이유로 인해 지양해야 함) 모바일 기기에서 볼 때 폼 항목과 라벨이 일치하지 않은 항목은 심심치 않게 볼 수 있다.

      라벨은 항목의 위 또는 아래에 포함하는 가장 일반적인 옵션을 포함하여 몇 가지 다른 방법으로 위치한다. 안쪽이든 바깥쪽이든 항목 위에 라벨이 있는 것은 라벨이 항목 옆에 있을 때 보다 폼을 두 배로 긴 형태로 만든다. 길게 보이는 폼은 만족감을 느낄 것이다.

      4월에 UX Movment에서 엔소니가 '안쪽에 상단 정렬된 폼 라벨은 더 빠르게 훑어본다' 라는 글을 포스팅했지만 5월 후속 포스팅에서 제시카가 설명한대로 아직 확실히 논란의 여지가 있다.

      한 번 더 다른 라벨 위치의 장단점에 대한 전체적인 개요를 알고 싶다면 확실한 가이드를 참고하라.

      추가 자원

      폼은 이제 믿을 수 없을 만큼 디자인에서 중요한 부분이고 충분한 정성을 들여야 한다. 가능한 한 간단하게 사용하도록 해야하고 짧을수록 여러분은 잘 해낼 수 있다. 소셜 등록은 바람직하지만 UX 품질 저하와 사이트 속도 저하를 이유로 우선적으로 생각해서는 안된다.


      도움이 될만한 글:
      continue reading [번역] 비밀번호와 가입 폼을 위한 UX 디자인
      Share This:    Facebook Twitter

      2015-07-16

      [번역] 의존성 관리 도구 컴포저 - 라이브러리

      * url: https://getcomposer.org/doc/02-libraries.md

      라이브러리

      이번 장은 컴포저를 통해서 설치할 수 있는 라이브러리를 만드는지 이야기할 것이다.

      모든 프로젝트는 패키지이다

      디렉토리에서 composer.json파일을 만드는 즉시 그 디렉토리는 패키지가 된다. 여러분은 require를 프로젝트에 추가할 때 다른 패키지에 의존하는 패키지를 만드는 셈이다. 여러분의 프로젝트와 라이브러리의 차이점은 여러분의 프로젝트가 이름 없는 패키지라는 점이다.

      그 패키지를 설치 가능하도록 하기 위해서 이름을 지정해야한다. composer.json 파일에서 name 속성을 추가한다.

      {
          "name": "acme/hello-world",
          "require": {
              "monolog/monolog": "1.0.*"
          }
      }
      프로젝트 이름이 acme/hello-world인 경우에 acme 부분은  벤더 이름이다. 벤더 이름을 제공하는 것은 필수이다.
      참고: 만약 여러분이 벤더 이름을 어떤 것으로 사용 할 지 모르겠다면 보통 GitHub 사용자 이름이 괜찮다. 패키지 이름은 대소문자를 구별하고 있지만 모두 소문자로 하고 단어 구분은 하이픈으로 사용하는 것을 규칙으로 하고 있다.

      플랫폼 패키지

      컴포저에는 플랫폼 패키지가 있는데 시스템에 설치되어 있는 가상 패키지이지만 실제로는 컴포저가 설치한 것이 아니다. 이는 PHP 자체, PHP 확장 기능, 몇몇 시스템 라이브러리를 포함하고 있다.
      • php는 제약 조건을 적용할 수 있도록 사용자 PHP 버전을 나타낸다. 예: >=5.4.0. PHP에 64비트 버전을 요청하기 위해 여러분은 php-64bit 패키지를 요청할 수 있다.
      • hhvm는 HHVM 실행 시간 (아카 힙홉 가상 머신) 버전을 나타내고 제약 조건을 적용할 수 있다. 예: '>=2.3.3'.
      • ext-<name>은 PHP 확장 기능 (코어 확장을 포함) 을 요구할 수 있다. 버전 지정은 여기에 아주 일치하지 않을 수도 있기에 보통 별표 (*) 로 제약 조건을 설정하는 것이 좋다. 확장 패키지 이름 예시는 ext-gd이다.
      • lib-<name>은 PHP가 사용하는 라이브러리 버전을 만들도록 제약 조건을 걸 수 있다. 다음은 <name> 부분에 사용할 수 있는 내용이다 : curl, iconv, icu, libxml, openssl, pcre, uuid, xsl.
      로컬에서 사용할 수 있는 플랫폼 패키지 리스트를 보려면 show --platform을 사용하면 된다.

      버전 지정하기

      패키지스트에서 여러분의 패키지를 발행할 때 VCS (git, svn, hg) 정보에서 버전을 유추할 수 있다. 이는 여러분이 명시적으로 선언할 필요가 없다는 것을 의미한다. 버전 숫자가 어떻게 추출되는지 태그브랜치를 읽어보자.

      수동으로 패키지를 만들어서 거나 명시적으로 지정해야 하는 경우 여러분은 그저 version 항목을 추가하면 된다.

      {
          "version": "1.0.0"
      }
      참고: 여러분은 되도록이면 명시적으로 버전 항목을 지정하지 않도록 해야한다. 왜냐하면 태그 값은 태그 이름과 일치해야 하기 때문이다.

      태그

      버전처럼 보이는 모든 태그의 경우 해당 태그의 패키지 버전이 생성될 것이다. 패키지 버전은 -patch (-p), -alpha (-a), -beta (-b), RC의 선택적인 접미사와 함께 'X.Y.Z'나 'vX.Y.Z' 형식과 일치해야 한다. 접미사 뒤에는 숫자가 따라올 수도 있다.

      다음은 유효한 태그 이름의 예제들이다.
      • 1.0.0
      • v1.0.0
      • 1.10.5-RC1
      • v4.4.4-beta2
      • v2.0.0-alpha
      • v2.0.4-p1
      참고: 여러분의 태그가 v로 시작할지라도 require 구문에서 버전 제약은 접두사 없이 지정해야한다. (예: 태그 v1.0.0은 버전 1.0.0가 된다.)

      브랜치

      모든 브랜치의 경우 패키지 개발 버전이 생성된다. 브랜치 이름이 버전 이름과 같으면 버전은 {branchname}-dev가 될 것이다. 예를 들어 브랜치 2.02.0.x-dev 버전을 얻는다 (.x는 브랜치로 인식하기 위해 기술적인 이유로 추가됨). 또한 2.0.x 브랜치는 유효할 뿐 아니라 2.0.x-dev로 전환된다. 만약 브랜치가 버전과 같지 않으면 dev-{branchname}가 될 것이다. masterdev-master 버전이 된다.

      다음은 버전 브랜치 이름에 관련된 예시이다.
      • 1.x
      • 1.0 (1.0.x와 같음)
      • 1.1.x
      참고: 여러분이 개발 버전을 설치하면 그 source에서 자동으로 가져올 것이다. 더 자세한 내용은 install를 참고하라.

      별칭

      버전에 브랜치 별칭을 지정할 수 있다. 예를 들어 여러분은 dev-master1.0.x-dev로 지정하고 모든 패키지에서 1.0.x-dev를 요구할 수 있다.

      더 자세한 내용은 별칭을 참고하라.

      잠금 파일

      라이브러리의 경우에 여러분이 원하면 composer.lock 파일을 커밋할 수 있다. 이는 여러분의 팀이 동일한 의존성 버전으로 테스트할 수 있도록 도와준다. 그러나 이 잠금 파일은 그것에 의존하는 다른 프로젝트에 어떤 영향도 주지 않을 것이다. 메인 프로젝트에만 영향을 줄 뿐이다.

      만약 여러분이 잠금파일을 원하지 않으면서 git을 사용하고 있다면 .gitignore에 추가하라.

      VCS로 발행하기

      만약 composer.json 파일을 포함하는 VCS 저장소 (버전 관리 시스템, 예: git) 가 있으면 여러분의 라이브러리는 이미 컴포저가 설치할 수 있는 상태이다. 이 경우에 우리는 github.com/username/hello-world 밑에서 GitHub에 acme/hello-world 라이브러리를 발행할 것이다.

      이제 acme/hello-world 패키지를 설치 테스트하기 위해서 로컬에 새 프로젝트를 생성한다. 우리는 acme/blog를 호출할 것이다. 이 블로그는 acme/hello-world에 의존하고 또 그것은 monolog/monolog에 의존하고 있을 것이다. 우리는 어딘가에 새 blog 디렉토리를 생성하고 composer.json를 포함하여 수행할 수 있다.

      {
          "name": "acme/blog",
          "require": {
              "acme/hello-world": "dev-master"
          }
      }
      우리는 라이브러리로 이 블로그를 발행하고 싶지 않기 때문에 이 경우에 이름은 반드시 필요하지 않는다. 이름은 composer.json에 기술되는 것을 명확히 하기 위해 추가하였다.

      이제 우리는 블로그 앱이 hello-world 의존성을 찾도록 설정해야한다. 우리는 블로그의 composer.json 패키지에 저장소 사양을 추가하여 이 작업을 수행할 수 있다.

      {
          "name": "acme/blog",
          "repositories": [
              {
                  "type": "vcs",
                  "url": "https://github.com/username/hello-world"
              }
          ],
          "require": {
              "acme/hello-world": "dev-master"
          }
      }
      패키지 저장소가 동작하는 것과 사용할 수 있는 다른 종류에 대해서 더 자세히 알고 싶다면
      저장소를 참고하라.

      그게 다이다. 여러분은 이제 컴포저 install 명령어를 실행하여 의존성을 설치할 수 있다!

      요약: composer.json 를 포함하는 모든 git/svn/hg 저장소는 캐피지 저장소를 지정하고 require 항목에서 의존성을 정의하는 것으로 여러분의 프로젝트에 추가할 수 있다.

      패키지스트 발행하기

      자, 이제 여러분은 패키지를 발행할 수 있다. 그러나 매번 VCS 저장소를 지정하 것은 번거롭다. 여러분은 모든 사용자가 그렇게 하도록 강요하면 안된다.

      여러분이 눈치챈 다른 것은 monolog/monolg를 위한 패키지 저장소를 지정하지 않았다는 것이다. 어떻게 동작하는 것일까? 대답은 패키지스트이다.

      패키지스트는 컴포저를 위한 매인 패키지 저장소이고 기본적으로 활성화되어 있다. 패키지스트에서 발행된 모든 것은 컴포저를 통해서 자동으로 사용 가능하다. 모놀로그는 패키지스트에 있기 때문에 우리는 저장소를 추가로 지정하지 않고도 의존할 수 있다.

      만약 전세계에 hello-world를 공유하고 싶다면 물론 패키지스트에 발행하면 된다. 이렇게 하면 정말 간단하다.

      여러분은 간단히 패키지스트에 방문하고 "Submit"을 누른다. 가입되어 있지 않다면 가입하라는 메세지가 뜰 것이고 패키지스트가 크롤링을 시작하는 지점에서 여러분의 VCS 저장소에서 URL을 전송할 수 있도록 한다. 완료되면 여러분의 패키지는 누구나 사용 할 수 있다!

      continue reading [번역] 의존성 관리 도구 컴포저 - 라이브러리
      Share This:    Facebook Twitter

      2015-07-09

      [번역] 의존성 관리 도구 컴포저 - 기본 사용법(Basic usage)

      개인 소장용으로 번역한 자료입니다.
      참고용으로만 봐주시고, 틀린 점이 있으면 언제든 태클 걸어주세요.

      * url: https://getcomposer.org/doc/01-basic-usage.md

      기본 사용법

      소개

      기본 사용법을 소개하면서 로깅 라이브러리인 monolog/monolog를 설치할 것이다. 아직 컴포저를 설치하지 않았다면 소개 장을 참조하라.
      참고: 단순화를 위해 이 소개는 컴포저의 로컬 설치를 가정할 것이다.

      composer.json: 프로젝트 세팅

      프로젝트에 컴포저를 사용하기 위해서 여러분은 composer.json 파일이 필요하다. 이 파일은 여러분의 프로젝트의 의존성에 대해서 기술할 뿐 아니라 다른 메타데이터도 포함할 수 있다.

      require

      composer.json에서 지정할 첫 번째 (또는 자주 할) 일은 require 키이다. 여러분은 프로젝트에 의존하는 패키지를 컴포저에 간단히 지정할 수 있다.

      {
          "require": {
              "monolog/monolog": "1.0.*"
          }
      }
      보다시피 require은 패키지 이름 (예: monolog/monolog) 을 패키지 버전 (예: 1.0.*) 으로 매핑한 객체를 가져온다.

      패키지 이름

      패키지 이름은 벤더 이름과 프로젝트 이름으로 구성된다. 보통 벤더 이름과 프로젝트 이름은 동일하다. 벤더 이름은 그저 이름 충돌을 막기 위해 존재하기 때문이다. 벤더 이름은 서로 다른 두 사람이 각각 igorw/jsonseldaek/json으로 json이라는 같은 이름의 라이브러리를 생성할 수 있도록 한다.

      우리는 여기서 monolog/monolog를 요구하고 있고 벤더 이름은 프로젝트의 이름과 동일하다. 고유한 프로젝트 이름을 사용하는 것이 좋다. 나중에 같은 네임스페이스 아래서 연관된 프로젝트를 많이 추가할 수 있기 때문이다. 여러분이 라이브러리를 유지한다면 더 작은 부분으로 나누기 쉬울 것이다.

      패키지 버전

      이전 예제에서 우리는 모놀로그 버전 1.0.* 을 요청했다. 이는 1.0 개발 브랜치의 버전을 의미한다. 그 버전은 >=1.0<1.1과 일치하는 버전에 해당한다.

      버전 제약은 몇 가지 방법으로 지정할 수 있고 이 주제에 대한 자세한 정보는 버전 문서를 참조하라.

      안정성

      기본적으로 안정된 릴리즈만 대상으로 한다. 만약 의존성의 RC, 베타, 알파, 개발 버전을 얻으려면 안정성 플래그를 사용하여 얻을 수 있다. 의존성 하나당 수행하는 것 대신 모든 패키지를 변경하려면 여러분은 최소 안정성 설정을 사용할 수 있다.

      의존성 설치

      프로젝트에서 정의된 의존성을 설치하려면 그저 install 명령어를 실행하면 된다.

      php composer.phar install
      이 명령어는 제공된 버전 제약과 일치하는 monolog/monolog의 최신 버전을 찾고 vendor 디렉토리로 다운로드 한다. 이것은 vendor라는 디렉토리로 외부 코드를 놓는 규약이다. 모놀로그의 경우 vendor/monolog/monolog로 놓는다.
      팁: 여러분의 프로젝트가 git을 사용한다면 아마 vendor.gitignore에 추가해야 한다. 절대 저장소의 모든 코드를 추가하면 안된다.

      여러분은 install 명령이 composer.lock 파일도 만들었다는 것을 알 수 있다.

      composer.lock - 잠금파일

      의존성 설치 후 컴포저는 composer.lock 파일에 설치해야 할 정확한 버전 리스트를 작성할 것이다. 이것은 특정 버전으로 프로젝트를 고정한다.

      버전 컨트롤에 애플리케이션의 (composer.json과 함께) composer.lock을 커밋한다.

      이 내용은 중요하다. 왜냐하면 잠금파일이 존재하면 install 명령어는 체크하여 그곳에 (composer.json에 뭐라고 적혀있든지) 지정된 버전을 다운로드 하기 때문이다.

      잠금 파일을 커밋하는 것은 프로젝트를 설정하는 그 누구도 의존성에서 정확히 같은 버전을 다운로드 하지 않을 것을 의미한다. 여러분의 CI 서버, 생산 기기, 여러분 팀의 다른 개발자, 모든 것과 모두는 구축하는 일부에 영향을 미치는 버그를 완화하는 동일한 의존성에서 실행한다. 심지어 여러분이 프로젝트 재설치로 6달 동안 혼자 개발할 때도 새로운 버전으로 많이 릴리즈 되더라도 설치된 의존성은 여전히 동작한다고 느낄 수 있다.

      만약에 composer.lock 파일이 없으면 컴포저는 composer.json에서 의존성과 버전을 읽고 updateinstall 명령어를 실행한 후에 잠금 파일을 만들 것이다.

      잠금 파일을 만든다는 것은 의존성의 새로운 버전이 나오더라도 여러분은 자동으로 업데이트 받지 않는다는 것을 의미한다. 새로운 버전으로 업데이트 하려면 update 명령어를 사용한다. 그러면 매칭되는 (여러분의 composer.json 파일에 따라서) 최근 버전을 받을 것이고 새로운 버전으로 잠금파일을 갱신할 것이다.

      php composer.phar update
      참고: composer.lockcomposer.json 파일이 동기화되어 있지 않으면 install 명령어를 실행할 때 경고를 표시할 것이다.

      만약 의존성 하나에만 설치나 업데이트를 원한다면 허용 목록에 추가할 수 있다.

      php composer.phar update monolog/monolog [...]
      참고: 라이브러리의 경우 잠금 파일을 반드시 커밋할 필요는 없다.
      라이브러리-잠금파일 참고

      패키지스트

      패키지스트는 메인 컴포저 저장소이다. 컴포저 저장소는 기본적으로 패키지를 얻을 수 있는 곳인 패키지 소스이다. 패키지스트는 모두가 사용하는 중앙 저장소가 되는 것이 목표이다. 이것은 사용 가능한 어떤 패키지든 자동으로 require할 수 있다는 것을 의미한다.

      패키지스트 웹사이트를 방문하면 여러분은 패키지를 둘러보고 검색할 수 있다.

      컴포저를 사용하는 어떤 오픈 소스 프로젝트도 자신의 패키지를 패키지스트에 발행하는 것이 좋다. 라이브러리는 컴포저가 사용하는 패키지스트에 있을 필요는 없지만 다른 개발자들이 더 빠르게 탐색하고 도입할 수 있게 해준다.

      오토로딩

      컴포저는 자동으로 로드하는 정보를 지정한 라이브러리의 경우에 vendor/autoload.php 파일을 생성한다. 여러분은 간단하게 이 파일을 포함하고 자유롭게 오토로딩을 할 수 있다.

      require 'vendor/autoload.php';
      이 코드는 실제로 외부 코드를 사용하기 쉽게 해준다. 예를 들면 프로젝트가 모놀로그에 의존하고 있다면 여러분은 그저 클래스를 사용하면 자동으로 클래스를 불러온다.

      $log = new Monolog\Logger('name');
      $log->pushHandler(new Monolog\Handler\StreamHandler('app.log', Monolog\Logger::WARNING));
      
      $log->addWarning('Foo');
      여러분은 심지어 composer.json에서 autoload 항목을 추가하는 것으로 오토로더를 여러분의 코드에 추가할 수 있다.

      {
          "autoload": {
              "psr-4": {"Acme\\": "src/"}
          }
      }
      컴포저는 Acme 네임스페이스로 PSR-4 오토로더를 등록할 것이다.

      여러분은 디렉토리에서 네임스페이스 매핑을 정의한다. src 디렉토리는 여러분의 프로젝트 루트에서 vendor 디렉토리와 같은 단계가 될 것이다. 예제 파일이름은 Acme\Foo 클래스를 포함한 src/Foo.php가 될 것이다.

      autoload 항목을 추가한 후에 여러분은 vendor/autoload.php 파일을 다시 생성하기 위해 dump-autoload를 재실행 해야한다.

      해당 파일을 포함하는 것 또한 오토로더 인스턴스를 반환합니다, 그래서 여러분은 변수에 해당 반환값을 저장하고 네임스페이스를 더 추가할 수 있다. 예를 들어 이 예제는 테스트 프로그램에서 클래스를 자동으로 불러오는 데에 유용할 수 있다.

      $loader = require 'vendor/autoload.php';
      $loader->add('Acme\\Test\\', __DIR__);
      PSR-4 오토로드에 추가적으로 컴포저에는 클래스 맵과 파일 오토로드인 PSR-0이 지원된다. 더 자세한 내용은 autoload 를 참조하면 된다.
      참고: 컴포저는 자신의 오토로드를 제공한다. 만약 여러분이 제공하는 것을 사용하고 싶지 않다면 자신의 오토로드를 구성할 수 있도록 연관배열을 반환하는 vendor/composer/autoload_*.php 파일을 포함하면 된다.

      continue reading [번역] 의존성 관리 도구 컴포저 - 기본 사용법(Basic usage)
      Share This:    Facebook Twitter

      2015-07-02

      [번역] 의존성 관리 도구 컴포저 시작하기 - 소개(Intro)

      컴포저에 대해서 소개글을 읽다보니 해석하느라 내용이 눈에 잘 안들어와서 번역 해 보았습니다. 시간 나면 다음 것도 번역해볼까 하지만, 발 번역이라 컴포저에 대한 국문 내용이 필요하신 분들께 죄송하네요. 이 글은 그냥 참고용으로만...

      * url: https://getcomposer.org/doc/00-intro.md

      소개s

      컴포저는 PHP 의존성 관리 도구이다. 프로젝트에서 요구하는 의존 라이브러리를 선언하고 프로젝트에 설치하는 것을 도와준다.

      의존성 관리

      컴포저는 패키지 관리자가 아니다. 그렇다, "패키지"나 라이브러리를 다루기는 하지만 프로젝트 단위로 관리하고 프로젝트 디렉토리 (예: vendor) 안에서 설치 한다. 기본적으로 절대 전역 설치하지는 않는다. 그래서 의존성 관리자이다.

      이 아이디어는 새로운 것은 아니며 컴포저는 nodejs의 npm이나 루비의 bundler에서 크게 영향을 받았다. 그러나 그 당시 PHP를 위한 도구같은 건 없었다.

      컴포저는 다음과 같은 문제를 해결 해 준다.

      a) 몇몇 라이브러리에 의존하는 프로젝트가 있다.
      b) 어떤 라이브러리는 다른 라이브러리에 의존적이다.
      c) 의존성을 선언한다.
      d) 컴포저는 설치에 필요한 패키지의 버전을 찾아서 설치한다 (프로젝트에 다운 받는 것을 의미한다).

      의존성 선언

      프로젝트를 생성하고 로그 기록하는 라이브러리가 필요하다고 해보자. 여러분은 monolog를 사용하기로 결정했다. 프로젝트에 추가하기 위해 해야 할 일은 composer.json 파일에 프로젝트 의존성을 선언하는 것이다.

      {
       "require": {
        "monolog/monolog": "1.2.*"
       }
      }
      우리는 프로젝트가 어떤 monolog/monolg 패키지를 요구하는지 간단하게 작성했다. 모든 버전은 1.2로 시작한다.

      시스템 요구

      컴포저는 PHP 5.3.2 이상이어야 동작한다. 몇몇 세심한 PHP 설정과 컴파일 표시가 필요하지만 설치 프로그램을 진행할 때 호환성에 대한 경고가 표시 된다.
      간단한 zip 아카이브 대신에 소스 패키지를 설치하려면 패키지 버전 컨트롤에 따라 git, svn, hg가 필요하다.
      컴포저는 멀티 플랫폼을 지원하고 우리는 윈도우, 리눅스, OSX에서 똑같이 동작하도록 노력하고 있다.

      설치 - 리눅스 / 유닉스 / OSX

      실행 가능 한 컴포저 다운로드

      짧지만 컴포저를 설치하는데 2가지 방법이 있다. 프로젝트의 일부분으로서 지역적으로 또는 어디에서나 실행가능하도록 전역적으로 설치하는 방법이 있다.

      지역 설치 (Locally)

      컴포저 지역 설치는 그냥 프로젝트 디렉토리 안에서 실행하면 된다.

      curl -sS https://getcomposer.org/installer | php
      참고: 어떠한 이유로 실패하면 php 대신에 인스톨러를 다운받을 수 있다.

      php -r "readfile('https://getcomposer.org/installer');" | php
      인스톨러는 몇몇 PHP 설정을 체크하고 작업 디렉토리에 composer.phar 를 다운받을 것이다. 이 파일은 컴포저 바이너리 파일이다. PHAR (PHP 아카이브) 라고 하는데 다른 것들 사이에서 명령줄로 실행할 수 있는 PHP 아카이브 형식이다.

      --install-dir 옵션을 사용하여 지정 디렉토리(절대 경로나 상대 경로일 수 있다)를 제공하는 것으로 컴포저를 특정 디렉토리에 설치할 수 있다.

      curl -sS https://getcomposer.org/installer | php -- --install-dir=bin

      전역 설치 (Globally)

      여러분은 이 파일을 여러분이 원하는 어디에나 놓을 수 있다. 시스템 속성 PATH에 설정하면 여러분은 전역적으로 접근할 수 있다. 유닉스 시스템에서 심지어 php 없이 실행가능하게 하고 호출 할 수 있다.

      여러분은 시스템 어디에나 쉽게 composer에 접근하기 위해서 이 명령어를 실행할 수 있다.

      curl -sS https://getcomposer.org/installer | php
      mv composer.phar /usr/local/bin/composer
      참고: 권한 때문에 실패했다면 sudo 권한으로 mv 줄을 다시 실행하라.
      참고: 요세미티 OSX에서 /usr 디렉토리는 기본적으로 존재하지 않는다.  "/usr/local/bin/composer: No such file or directory" 라는 에러가 나면  진행하기 전에 /usr/local/bin/ 폴더를 수동으로 생성한다.

      그리고 나서 컴포저를 실행하기 위해 php phpcomposer.phar 명령 대신에 composer 명령을 실행한다.

      설치 - 윈도우즈

      인스톨러 이용하기

      이 방법은 가장 쉽게 컴포저를 설정할 수 있는 방법이다.

      Composer-Setup.exe를 다운로드 받고 실행한다. 최신 컴포저 버전을 설치하고 PATH 를 세팅하면 어느 디렉토리에서나 명령 줄로 composer 명령을 그냥 실행하는 것으로 호출할 수 있다.
      참고: 현재 터미널을 닫는다. 새로운 터미널로 사용 테스트를 한다. 터미널 시작할 때 경로만 로드하기 때문에 중요하다.

      수동 설치

      환경변수 PATH 디렉토리를 변경하고 composer.phar를 다운 받을 수 있는 설치 조각을 실행한다.

      C:\Users\username>cd C:\bin
      C:\bin>php -r "readfile('https://getcomposer.org/installer');" | php
      노트: 위의 readfile 때문에 실패한다면 http 주소를 사용하거나 php.ini에서 php_openssl.dll을 사용 설정 한다.

      composer.phar 파일로 새 composer.bat 파일을 만든다.

      C:\bin>echo @php "%~dp0composer.phar" %*>composer.bat

      아직 설정되어 있지 않으면 환경변수 PATH에 디렉토리를 추가한다. 현재 터미널을 닫는다. 그리고 새 터미널을 열어서 테스트 한다.

      C:\Users\username>composer -V
      Composer version 27d8904


      컴포저 이용하기

      우리는 이제 컴포저로 프로젝트 의존성 설치할 것이다. 현재 디렉토리에 composer.json 파일이 없다면 기본 사용법 부분을 넘어가도 된다.

      의존성을 해결하고 다운로드하기 위해서 install 명령어를 실행한다.

      php composer.phar install
      만약 전역 설치를 했고 그 디렉토리에 phar가 없다면 이 명령어를 실행하라

      composer install
      위의 의존성 선언 예제를 따라서 vendor/monolog/monolog 디렉토리로 monolog를 다운로드 받을 것이다.

      오토로딩

      라이브러리를 다운로드 받는 것 외에 컴포저는 다운로드한 라이브러리의 어떤 클래스든 자동으로 불러올 수 있는 오토로드 파일을 준비한다. 컴포저를 사용하기 위해서는 그냥 코드의 부트 스트랩 과정에 저 줄을 따라서 추가해주면 된다.

      require __DIR__ . '/vendor/autoload.php';
      와우! 이제 monolog를 사용할 수 있다! 컴포저에 대해서 더 배우고 싶으면 "기본 사용법" 장을 계속 읽으면 된다.

      continue reading [번역] 의존성 관리 도구 컴포저 시작하기 - 소개(Intro)
      Share This:    Facebook Twitter

      2015-06-30

      정규식 패턴: 잃어버린 텍스트을 찾아서

      정규식은 위키에서는 다음과 같이 설명하고 있다.
      정규 표현식(正規表現式, 영어: regular expression, 간단히 regexp 또는 regex) 또는 정규식(正規式)은 특정한 규칙을 가진 문자열의 집합을 표현하는 데 사용하는 형식 언어이다.

        다시 말해서 정규식은 특정한 규칙에 해당하는 문자열을 뽑아내는 작업이라고 설명할 수 있을 것 같다. 예를 들면 이메일 형식의 문자만 추출하거나, URL 형식의 문자만 추출하거나 또는 다른 원하는 규칙에 해당하는 문자열을 다른 문자열로 바꾸고 싶을 때도 정규식을 사용할 수 있다. 이러한 정규식은 파이썬, 자바 스크립트, PHP 등등 많은 곳에서 응용하여 사용하고 있다. 늘 상 사용하는 기능은 아니지만 꼭 필요한 순간은 예고 없이 찾아온다.
        개인적으로 정규식에 대해서 항상 어렵다는 생각을 가지고 있었다. 지금 돌이켜보면 정규식에 대한 막연한 편견이었던 것 같다. 작업을 할 때 특수 문자가 주는 어려운 이미지 때문에 직접 작성하기 보다는 다른 방법으로 우회해서 사용하거나 꼭 필요한 경우에는 예제를 찾아서 변경하여 사용했었다. 어느 것이나 그렇지만 예제를 찾는다는 것은 내게 꼭 맞는 정규식은 아니었다. 그 때 정규식에 대해서 하나하나 뜯어보기 시작했는데 마음 먹고 들여다 본 정규식은 생각보다 어렵지 않았다. 다시 공부한 걸 생각도 할 겸 나와 같은 상황에 빠진 사람들에 조금이나마 도움이 되지 않을까 해서 정리해 보았다.
      기준은 PHP로 잡고 정리 했지만 큰 그림은 비슷하기 때문에 한 번 이해하면 어디에서든 쓸 수 있을 거라고 생각한다.

      정규식 예제에 사용 할 범주
      • /예제로 사용한 정규식/
      • 정규식을 적용할 문자열
      • []: 정규식을 찾고난 결과 값

      정규식의 기본 사용

      /blah-blah/
      양 쪽에 있는 슬래시(/) 안에 문자를 넣어서 사용한다. 슬래시 안의 문자들을 정규식 패턴으로 인식하고 그 안에 기술된 패턴대로 문자열을 찾기 시작한다. 예를 들어 a라는 글자를 찾고 싶으면 다음과 같이 입력하면 된다.

      /a/
      
      a ab abc
      
      [a]
      /aaa/
      
      a ab aaa
      
      [aaa]
      기본 사용법은 익혔으니 그 안의 내용을 작성하는 방법을 알아보자. 너무 겁 먹지 않아도 된다. 신경 쓸 게 많아 보이지만 생각보다 간단하다. 이 다음부터 나오는 모든 사용법은 슬래시 안에 작성해 주어야 한다.

      문장이 시작하거나 끝나는 지점

      ^blah : blah로 시작하는 패턴

      /^start/
      
      start begin!
      
      [start]
      전체 문장의 시작이 정확히 start라고 시작하는 패턴을 찾는다. 예를 들어 찾아야 할 텍스트가 everybody start begin!이라면 start로 시작하지 않기 때문에 규칙에 맞는 텍스트는 없을 것이다.

      end$ : end로 끝나는 패턴

      /end$/
      
      The end
      
      [end]
      찾아야할 문자열 중에서 가장 마지막 문자가 end로 끝나야만 한다. 예를 들어 찾아야 할 텍스트가 The end.라면 점(.)이 있기 때문에 규칙에 맞는 텍스트는 없다.

      A|B : A 또는 B

      /hell|hi/
      
      hell hi hello
      
      [hell]
      hello 또는 hi라는 문자열을 찾기 때문에 결과는 가장 처음에 나오는 hell을 찾을 것이다.

      여기에서 왜 hi를 찾지 않는지 궁금할 것이다. 이 쯤 해서 플래그에 대해서 알아야 할 것 같다. 기본적으로 규칙을 작성하게 되면 가장 처음 추출되는 문자열 하나를 찾는다. 그러나 제시한 텍스트에서 규칙에 해당하는 문자열을 모두 찾고 싶다면? 그때 플래그를 넣어주면 된다.

      옵션 플래그

      옵션 플래그에는 여러 가지가 있다. 그러나 가장 많이 사용하는 3가지만 소개하도록 한다. 물론 여기서 소개하지 않았다고 해서 중요하지 않거나 유용하지 않은 플래그라는 것은 아니다. 플래그는 하나만 사용할 수 도 있고 다른 플래그와 조합하여 여러개를 사용할 수 있다.

      g: 전체 지정

      /hell|hi/g
      
      hell hi hello
      
      [hell, hi, hell]
      g 플래그는 전체 문자열에서 작성한 규칙에 해당하는 문자열을 모두 찾아낸다. g 플래그를 붙이지 않으면 규칙에 맞는 가장 첫 번째 문자열만 찾고 책임을 다하지만 g 플래그를 붙이면 규칙에 해당하는 모든 문자열을 찾는다.

      i: 대소문자 무시

      /hell|hi/gi
      
      HELL hell HI hi hello
      
      [HELL, hell, HI, hi, hell]
      대소문자 상관없이 hell에 해당하는 문자열은 모두 찾는다. 또한 g 플래그가 붙었기 때문에 대소문자 구분 없이 hell, HELL 모두 찾아낸다.

      m: 여러 줄에 해당 내용을 지정

      /hello$/m
      
      HELL hell HI hi hello!
      HELL hell HI hi hello
      HELL hell HI hi hello
      
      [hello]

      /hello$/gm
      
      HELL hell HI hi hello!
      HELL hell HI hi hello
      HELL hell HI hi hello
      
      [hello, hello]
      m의 경우에 헷갈릴 수도 있을 것 같기도 한데 각 줄에서 해당하는 규칙을 찾아낸다. 다시 말해서 ^ 또는 $ 문자는 전체 문자열의 가장 처음 또는 가장 마지막 규칙을 찾아내는데 m 플래그를 사용할 경우 각 줄에서 마지막이 hello로 끝나는 단어를 찾아낸다. 그래서 바로 위의 예제에서는 hello로 끝나는 두 번째와 세 번째 hello를 반환 한다. g 플래그를 붙이지 않은 첫 번째 예제에서는 각 줄에서 작성한 규칙에 해당하는 두 번째 줄의 hello 문자열을 찾고 끝난다.

      문자 출력

      지금부터는 본격적인 규칙 작성을 시작한다. 가장 많이 사용하고 또 자유자재로 작성해야 할 문자들이다. 다음에서 소개할 내용은 반드시 숙지하고 있어야 하는데 어쩌면 암기하려 노력하지 여러 번 사용하면서 자연스럽게 외워질 수도 있다.

      . : 특수 문자 \n을 제외한 모든 문자 한 개

      /h./g
      
      HELL hell HI hi hello!
      HELL hell HI hi hello
      
      [he, hi, he, he, hi, he]

      * : 이전 문자가 0번 이상 반복 (반복하지 않거나 1번 이상)

      /d*/g
      
      a dd ddd dddd ddddd aaaaaa
      
      [ , ,dd, ,ddd, ,dddd, ,ddddd, ]
      별표(*)가 단독으로 쓰일 경우 0번 이상 반복하는 것까지 찾기 때문에 사실상 공백까지도 결과 범위에 포함한다.

      + : 이전 문자가 1번 이상 반복

      /a+/g
      
      a dd ddd dddd ddddd aaaaaa
      
      [a, aaaaaa]

      ? : 이전 문자가 존재하거나 하지 않거나

      /https?/g
      
      http:// https:// httpss://
      
      [http, https]
      물음표(?) 앞에 나오는 s가 없거나 있는 경우 모두 찾아낸다.

      {n,n} : 숫자를 반드시 지정해야 하며 그 안의 수 만큼 반복

      /d{3,4}/g
      
      a dd ddd dddd ddddd aaaaaa
      
      [ddd, dddd, dddd]
      d가 3번 이상 4번 이하 반복하는 문자열을 찾기 때문에 3번 반복하는 3번째 ddd부터 5번째에 있는 dddd까지 반환한다.

      문자 지정 또는 범위

      해당하는 문자 지정

      [] 문자열을 사용하면 []라고 감싼 부분이 하나의 문자로 인식 하고 그 안에 작성한 문자열이 해당하는 범위가 된다.

      /[ac3]/g
      
      1234
      abcd
      
      [3, a, c]
      위의 예제에서 보듯 [] 안에 a, c, 3이라는 3개의 문자열이 있다. []는 해당 자리에 문자가 하나 들어간 다는 뜻인데 그 하나의 문자열이 a나 c 또는 3일 때 해당 규칙이 성립한다고 본다. (물론 g 플래그를 사용했기 때문에 해당하는 문자열을 전부 추출한다.)

      - : 해당하는 문자 범위 지정

      만약 이 안에 하이픈(-)으로 지정하면 범위로 정해진다. 예를 들면 [0-9]라고 지정하면 0부터 9까지의 숫자를 의미하고 [a-z]라고 하면 소문자 알파벳 a부터 z까지가 해당한다. 같은 방식으로 대문자 알파벳 범위도 지정 가능하다. 또한 범위를 결합해서 사용할 수도 있다. 다시 말해서 [0-9a-z]라고 지정하면 숫자 0부터 9까지와 a부터 z까지에 해당하는 문자열 하나를 말한다. 물론 이 상황에서 대문자는 포함하지 않는다.
      결국 [0-9]는 모든 숫자를 의미하고, [a-z]는 모든 소문자 알파벳, [A-Z]는 모든 대문자 알파벳이고, 당연히 [a-zA-Z]는 모든 알파벳을 의미한다.
       
      /[0-9]/g
      
      1234
      abcd
      
      [1, 2, 3, 4]

      ^ : 해당하지 않는 문자 (또는 범위) 지정

      물론 해당 범주에 속하지 않도록 지정하는 규칙도 있다. ^ 문자를 사용하면 되는데 범위를 설정할 때는 문자열의 시작이라는 뜻이 아니라 부정의 의미를 담고 있다. 다음의 예제로 이해하면 더 쉬울 것이다. 0-9를 부정 (^) 하는 뜻이므로 숫자가 아닌 한 문자열을 의미하는 정규식이다.

      /[^0-9]/g
      
      1234
      abcd
      
      [a, b, c, d]

      자주 사용하는 특수 문자

      정규식에서는 특수 문자를 표현하는 문자로 패턴을 나타내기도 한다. 그 패턴은 일반 문자열 앞에 백슬래시(\)를 붙여서 특수한 용도로 사용한다. HTML 태그를 아는 사람은 익숙한 내용일 수도 있다. 다음은 자주 사용하는 특수 문자 리스트이다.
      • \n : 새로운 줄 (줄바꿈 용도로 사용하는 엔터와 같음)
      • \t : 탭 문자
      • \b : 공백 문자 (띄어쓰기 용도로 사용하는 스페이스와 같음)
      • \d : 정수 ([0-9]와 같음)
      • \D : 정수가 아닌 문자열 ([^0-9]와 같음)
      • \s : 공백 문자 (\n, \r, \t 등등이 해당됨)

      /[\d]/g
      
      1234
      abcd
      
      [1, 2, 3, 4]
      기본적으로 정규식은 문자 규칙을 작성하는 것이기 때문에 여러 문자를 조합해서 사용한다.
      그러나 실제로 \b라는 문자를 찾고 싶을 수도 있다. 그때는 역슬래시(\)를 해당 문자 앞에 붙여준다. 예를 들어 \b라는 문자를 찾고 싶다면 \\b라고 입력하면 된다.

      /\\b/g
      
      \b \a \t \b
      
      [\b, \b]

      문자 그룹화: ()

      찾아낸 문자를 교체한다던가 정규식에 포함되는 내용 중 특정 문자를 추출하고자 할 때는 그룹화해서 문자열을 추출한다. 만약 리스트 태그(<li>)를 추출하는데 그 중에서도 클래스 명이 name인 내용만 추출하고 싶다면 그룹화을 사용하여 작업할 수 있다.

      /<li.+?class="name">(.+?)<\/li>/g
      
      <ul>
      <li class="name">파무침</li>
      <li class="phone">000-0000-0000</li>
      <li class="name">파절임</li>
      <li class="phone">000-0000-0000</li>
      </ul>
      
      [파무침, 파절임]
      PHP에서는 preg_replace 함수를 이용하여 문자열을 교체할 수도 있다. 다음은 PHP 공식 홈페이지에서 가져온 preg_replace 예제이다. 첫번째 괄호는 ${1}또는 $1로 치환되고 두번째 괄호, 세번째 괄호는 각각 ${2} 또는 $2, ${3} 또는 $3으로 치환하여 사용한다.

      <?php
      $string = 'April 15, 2003';
      $pattern = '/(\w+) (\d+), (\d+)/i';
      $replacement = '${1}1,$3';
      echo preg_replace($pattern, $replacement, $string);
      ?>
      April1,2003

      탐욕스러운(Greedy), 게으른(Lazy, Non-Greedy)

      • greedy :+ * {n,}
      • lazy : +? *? {n,}?
      정규식이 살아있는 사람이라면 기본적으로 욕심많은 사람이다. 그러나 때론 욕심이 많으면 일을 그르칠 수도 있기에 욕심을 자제할 때도 있어야 하는 법이다. 욕심 많은 이 사람을 자제하거나 성격을 바꿀 수 있는 마법의 도구가 있다. 차이점을 알아차린 사람도 있겠지만 탐욕스러운 패턴에서 ?를 붙이면 마음이 조금 덜 탐욕스러워진다. 쉽게 설명하기 위해 가장 처음 요소인 <html>을 추출하려고 하는 아래의 예시를 같이 보도록 하자.
      /<.*>/
      
      <html><head><title>제목</title></head>
      
      [<html><head><title>제목</title></head>]
      모든 문자가 없거나 반복되는 내용으로 <>로 닫히는 태그를 찾고 있다. 그러나 출력되는 결과는 예상과는 다르다. 괄호로 닫히는 것은 맞지만 우리가 원했던 것은 <html>코드였지만 마지막 >까지 모두 추출해버렸다. 이 탐욕스러운 정규식!

      이제 이 탐욕스러운 마음을 조금 진정하도록 도와주자. 다음과 같이 물음표를 붙이면 된다.

      /<.*?>/
      
      <html><head><title>제목</title></head>
      
      [<html>]
      함께 살펴본 2가지의 예시와 같이 물음표 하나로 정규식의 마음을 쥐락펴락할 수 있다. 이 마법의 문자를 기억하고 황에 따라 조절하며 사용하기 바란다.

      예제

      이제 대부분의 정규식에 대해서 공부 해 봤으니 실제 예시를 통해서 정규식을 사용해 보도록 하자. 가장 기본적인 전화번호 추출 방식부터 생각해보자.

      전화번호(휴대폰 번호)

      쉬운 예시를 위해 국제 번호는 제외한 휴대폰 번호만 추출하도록 하자. 전화번호의 경우에는 다음과 같은 패턴을 가지고 있다. 각 자리에는 당연히 숫자만 허용할 수 있고 각 국번 사이에는 하이픈(-)으로 연결되어 있기에 숫자와 정확한 곳에 자리 잡은 하이픈이 필요하다. 그 내용은 다음과 같이 정리할 수 있다.
      {숫자 3자리}-{숫자 3자리 또는 4자리}-{숫자 4자리}
      요새는 많이 사용 하지 않지만 가운데 국번이 3자리인 휴대폰 번호도 존재한다. 최대한 모든 휴대폰 번호를 수용할 수 있는 패턴을 만들어야 오류 발생율이 적어지기 때문에 3자리도 같이 패턴으로 처리하도록 하자. 이러한 생각을 바탕으로 정규식은 다음과 같이 설계할 수 있다.
      /[0-9]{3}-[0-9]{3, 4}-[0-9]{4}/g
      
      010-0000-0000
      010-1234-1234
      
      [010-0000-0000, 010-1234-1234]

      주소 (URL)

      인터넷 주소의 경우에는 전화번호보다는 조금 더 복잡하다. 우선, 한글 도메인은 예시에서 제외하도록 하자. 실제로 한글 도메인이 존재하기 때문에 실 개발할 때 URL을 영문으로만 한정짓는 것은 현명하지 못한 선택일 수도 있다. 그러나 설명을 위한 예시이므로 무시하는 것으로 한다.
      URL 주소의 경우에는 워낙 종류도 많고 설정할 수 있는 규칙도 다양하기 때문에 이 내용이 정답이라고 할 수는 없다. {프로토콜}{주소}로 이루어져 있으며 그 중에서 프로토콜의 경우에는 http:// 또는 https:// 로 시작할 수도 있다. 이 부분만 정규식으로 표현한다면 다음과 같다. 슬러시(/) 문자는 정규식에서 사용하는 문자이기 때문에 역슬래시(\)를 작성하지 않으면 오류가 난다.
      https?:\/\/
      s 문자가 있을 수도 있고 없을 수도 있기 때문에 물음표를 입력하여 표현하였다. 주소 부분은 점(.)이나 하이픈(-) 그리고 문자열로 이루어져 있다. 이 내용은 다음과 같이 표현할 수 있다.
      [0-9a-z.-]+
      이 두 개의 정규식을 이어서 완성해 보면 다음과 같다.

      /https?:\/\/[0-9a-z.-]+\/?/g
      
      https://test010.com/
      http://test010.co.kr/
      https://test010.kr
      
      [https://test010.com/, http://test010.co.kr/, https://test010.kr]
      더 정확하게 표현하고 싶다면 이렇게 할 수도 있다.

      /https?:\/\/([0-9a-z.-]+).[a-z]\/?/g
      
      https://test010.com/
      http://test010.co.kr/
      https://test010.kr
      
      [https://test010.com/, http://test010.co.kr/, https://test010.kr]

      마무리

      어느 것이든 다 마찬가지지만 실제 해당 기술 자체 보다는 그 기술을 어떻게 응용하고 이용하느냐에 따라서 달라진다. 어쩌면 문자열을 추출하는 작업을 할 때 정규식이 아니라 다른 방식 (substr 함수를 사용한다던가 if문으로 분기로 처리한다던가) 으로 처리하는 것이 훨씬 나을 때가 있다. 그러나 분명 정규식을 사용했을 때 더 편리하거나 정확한 경우가 있다고 믿고 있다. 많은 방법을 알고 있을 수록 작업을 할 때 더 효율적으로 선택할 수 있을 것이다.
      모든 정규식을 외울 필요는 없지만 어느 정도 기본적인 지식이 있다면 정규식 검증 사이트에서 테스트를 해볼 수도 있다. 개인적으로 regex101이라는 사이트에서 많은 도움을 받았으나 정규식을 검증해주는 사이트는 얼마든지 많이 있다.


      참고:
      • https://ko.wikipedia.org/wiki/%EC%A0%95%EA%B7%9C_%ED%91%9C%ED%98%84%EC%8B%9D
      • https://wikidocs.net/1642
      • http://php.net/manual/en/function.preg-replace.php
      • https://regex101.com/
      continue reading 정규식 패턴: 잃어버린 텍스트을 찾아서
      Share This:    Facebook Twitter

      2015-03-31

      phpdocument, 우리의 코드를 예쁘게 포장하는 방법


      2015년 1/4분기 미니 프로젝트 

      * 혼자 공부하려고 만든 자료이기 때문에 정확하지 않는 내용이나 오류가 있을 수 있습니다. 잘못된 점은 언제든지 고쳐주시면 배우겠습니다.

      phpDocumentor란? 

      phpDocumentor는 제작한 프로젝트에 대해서 문서화 해주는 도구를 말한다. 공식 홈페이지에서는 'PHP에 대한 세계 표준 자동 문서 도구(phpDocumentor is the world standard auto-documentation tool for PHP.)'라고 설명하고 있다. 
      우선은 phpDocumentor가 왜 수면위로 떠오르게 되었는지에 대해서 짚고 넘어가야 할 것 같다. PHP는 본래 컴파일 없이 라인 단위로 처리하는 스크립트 언어이다. 아무래도 스크립트 언어는 라인별 처리라는 개념 덕분인지 진입장벽이 낮아 독학하기에 좋은 언어였다. 그로 인해 사용률이 많아지고 인기가 많아지는 동시에 스크립트 언어에 대한 약점에 대해서 생각하게 되었던 것 같다. PHP 5로 넘어가면서 본격적으로 객체에 대한 개념이 강화되고, 이를 이용한 다양한 프레임워크가 개발되고 있다. 스크립트 언어에 대한 약점을 컴파일 언어에서 그 해답을 찾고자 했던 것 같다. 
      컴파일 언어의 대표적인 사례인 JAVA에서는 이미 javadoc이라는 문서화 도구가 존재하고 있었다. 아마도 phpDocumentor는 javadoc의 php 버전이었으리라. 사용 방법도 javadoc과 크게 다르지 않다. php도 객체지향 개념이 나오면서 어떤 정형화된 패턴이 나오는 것이 가정해졌기 때문에 그 공통적인 부분을 문서를 만들 수 있게 되었다.

      주석

      주석은 자신을 포함하여 프로젝트에 참여하는 사람들에게 쉽게 알아볼 수 있도록 하는 역할을 해준다. 주석을 최소화하는 것을 장려하는 사람들도 있긴 하지만, 프로젝트가 커질 수록 작은 코드가 어떤 역할을 할 수 있는지 모를 수도 있다. 그때 작업자는 그 코드에 대해서 설명글을 달아줄 수 있다. 주석은 사람이 알아볼 수 있게 쓰는 일종이 메모의 역할을 한다.

      마무리 

      phpDocumentor로 대단한 것을 할 수 있는 것은 아니다. 어쩌면 이 도구로 할 수 있는 것은 자료보관일 뿐일 것이다. 
      사실 Phpdoc이 많은 곳에서 쓰이고 있지는 않다. 대부분의 개발자들은 코드를 보면 쉽게 알 수 있을 것이라고 말하거나 귀찮아 한다. 그만큼 손도 많이 가고 굳이 해야 하나 싶기도 하는 작업이 바로 이 작업이다. 프로젝트가 개발자에 종속되는 것은 매우 좋지 않은 현상이며, 많은 개발자들이 수긍할 수 있는 코드가 좋은 프로젝트라고 생각한다. 그들이 쉽게 프로젝트의 유지보수에 투입되려면 한눈에 정리되어있는 문서가 필요한데 문서의 유지보수는 생각보다 어렵다. 그래서 이 도구가 문서를 작성하는 데에 중요한 역할을 하는 것이다. 

      continue reading phpdocument, 우리의 코드를 예쁘게 포장하는 방법
      Share This:    Facebook Twitter