( 최종적으로 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
요약/정리
- phar 다운로드
- 명령어 입력해서 docs만들기
-
- 명령어 : $php /Users/innonext/Downloads/phpDocumentor.phar -d. -t docs/api
- 명령어 해석 : $phpdoc -d “변환할 폴더” -t “변환 후 저장 이름”
- 확인
< 방법(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