Где следует установить phpDocumentor 2?
Я хочу вручную установить phpDocumentor 2 на Unix с помощью установщика.
У меня ограниченные знания о командной строке, но у меня есть корневой доступ. В инструкции говорится, чтобы загрузить установщик в нужное место . Итак, где я должен скачать / установить его?
Я понимаю, что могу поместить его куда угодно, но мне интересно знать некоторые стандартные места и почему одно место может быть лучше другого.Кроме того, установщик будет создать собственный родительский каталог? Или я должен создать это? Я никогда этого не понимал. Например, я не хочу заканчивать с /usr / bin/phpDoc / phpDoc
2 ответа:
Где установить
Если намерение состоит в том, чтобы установить его в общем общем месте,
/opt
было бы хорошим местом.Цитирование из стандарта иерархии файловой системы
/opt зарезервирован для установки дополнительных пакетов прикладных программ.
Родительский Каталог
Установщик для ручной установки, похоже, исчез с момента публикации вопроса. Но согласно их домашней странице , вы можно скачать tarball (не исходный код!) из GitHub и распакуйте его в каталог назначения.
Если вы откроете tarball, то увидите, что верхний каталог-phpDocumentor-2.3.0 (где 2.3.0-версия). Поэтому, когда вы извлекаете это, вы получите /path / to/current/dir/phpDocumentor-2.3.0/...
Рассмотрим грушу
Вы должны рассмотреть возможность установки PEAR. Сама PEAR - это просто менеджер пакетов. Установка диспетчера пакетов не устанавливает все дополнительные компоненты. Грушевые пакеты. Это действительно легко установить PEAR с помощью менеджера пакетов, таких как
yum
илиapt-get
.Есть несколькопреимуществ установки phpDocumentor с PEAR .
- легче обновить, когда есть новый релиз.
- вы можете назвать его просто
phpdoc
вместо[PHPDOC_FOLDER]/bin/phpdoc.php
Установка с грушей
Если вы используете команду
pear install PhpDocumentor
, Вы получаете самую новую версию, доступную из канала по умолчанию. На момент написания статьи, это 1.5. 0a1 (Альфа), который является устаревшим.Чтобы получить новейший релиз, установите его с канала phpdoc.
pear channel-discover pear.phpdoc.org pear install phpdoc/phpDocumentor
Используйте следующую команду для установки phpdoc.
sudo pear install PhpDocumentor password *****
Или
pear install PhpDocumentor
Он будет установлен по следующему пути.
cd /usr/lib/php/pear/data/PhpDocumentor
Введите следующую команду, чтобы просмотреть справку.
phpdoc -h
Для создания документации PHP используйте следующую команду.
phpdoc -o HTML:frames:earthli -f pathofthefile/sample1.php -t docs