본문 바로가기
카테고리 없음

phpdoc 설치

by 프로그래머콩 2019. 3. 31.

( 최종적으로 1번 방법 사용함... ) 

 

< 방법(1) - pahr 파일 이용해서 phpdoc 설치 >

최신 PHAR 파일은 http://www.phpdoc.org/phpDocumentor.phar 에서 다운로드 할 수 있습니다 .

중대한

 

일부 PHP를 설치하면 phar 파일을 실행하는 데 문제가 발생할 수 있습니다. 문제가있는 경우 먼저 다음 웹 사이트를 참조하십시오.http://silex.sensiolabs.org/doc/phar.html#pitfalls

phar 파일은 단순히 php를 호출하고 phar 파일을 매개 변수로 제공하여 사용할 수 있습니다.

$ php phpDocumentor.phar -d. -t docs / api

 

요약/정리

  1. phar 다운로드
  2. 명령어 입력해서 docs만들기
    1. 명령어 :  $php /Users/innonext/Downloads/phpDocumentor.phar -d. -t docs/api
    2. 명령어 해석 : $phpdoc -d “변환할 폴더” -t “변환 후 저장 이름
  3. 확인

< 방법(2) - git 폴더 다운로드 후 압축풀기 >

https://github.com/phpDocumentor/phpDocumentor2/releases/download/v2.9.0/phpDocumentor-2.9.0.tgz

 

다운로드 > 압축풀기 

 

 

 

 

$phpdoc -d “변환할 폴더” -t “변환 후 저장 이름

 

$/Users/innonext/Downloads/phpDocumentor-2.9.0/phpDocumentor-2.9.0/bin/phpdoc -d "./include" -t "./docs/include"

 

 

 

< 방법(3) - pear이용해서 설치 >

 

 

 

<pear 설치 하는 방법 >

 

>>download & install

 

$curl -O http://pear.php.net/go-pear.phar

$sudo php -d detect_unicode=0 go-pear.phar

 

아래와 같이 나타나는데,

아래처럼 입력 해주기 ( 경로 /usr/local/pear 로 입력하기 )

 

(1) 1 > enter > ‘/usr/local’ 입력

 

 

 

설치확인

 

$pear version

 

 

< pear 이용해 phpdoc install >

 

phpdoc 만들 폴더에서

아래 명령어 순서대로 입력

 

 


$ pear channel-discover pear.phpdoc.org


$ pear install phpdoc/phpDocumentor

 

 

 >> phpdoc 명령어 이용해 output 테스트 해보기

$ phpdoc

 

 

 

 

< 방법(4) - composer이용해서 설치 >

   < composer 설치 >

설치

  • PHP 5.3.2+  이상이 필요하다.
  • openssl extension 이 활성화되어야 한다.

Linux/Unix/Mac OS X

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

또는 curl 이 없을 경우 php 로 바로 설치. (https 관련 에러가 날 경우 php.ini 의 openssl extension 이 주석해제 되었는지 확인)

php -r "readfile('https://getcomposer.org/installer');" | php -- --install-dir=/usr/local/bin/

 

사용하기 쉽게 symbolic link 를 건다.

sudo ln -s /usr/local/bin/composer.phar /usr/local/bin/composer

 

< composer과 phpdoc >

 

1. composer.phar 생성

    phpdoc 작업을 시작할 폴더에서 인스톨러 파일을 제작하기.

명령어 : 

php -r "eval('?>'.file_get_contents('https://getcomposer.org/installer'));"

 

    composer.phar 파일 생성 확인

 

 

2. composer.bat이라는 실행파일 생성하기 (bat은 윈도우실행파일 아닌가...일단 ㄱㄱ)
    composer.phar를 이용해 bat파일로 생성

   $echo @php “%~dp0composer.phar” %*>composer.bat

 

 

3. composer.json 설정파일 만들기

 

    $nano composer.json

 

    {
            "require-dev":{
                "phpdocumentor/phpdocumentor": "2.*"
            }
    }

 

    입력 후 저장

 

 

 

 

 

 

4. composer이용해 phpdoc 사용할 수 있도록 다운로드 진행

 

    $php composer.phar install