Где следует установить phpDocumentor 2?


Я хочу вручную установить phpDocumentor 2 на Unix с помощью установщика.

У меня ограниченные знания о командной строке, но у меня есть корневой доступ. В инструкции говорится, чтобы загрузить установщик в нужное место . Итак, где я должен скачать / установить его?

Я понимаю, что могу поместить его куда угодно, но мне интересно знать некоторые стандартные места и почему одно место может быть лучше другого.

Кроме того, установщик будет создать собственный родительский каталог? Или я должен создать это? Я никогда этого не понимал. Например, я не хочу заканчивать с /usr / bin/phpDoc / phpDoc

2 2

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