phpDocumentor на Ubuntu

Установка

Для простейшей установки необходим PEAR.

sudo apt-get install php-pear

Официальный способ установки

sudo pear channel-discover pear.phpdoc.org
sudo pear install phpdoc/phpDocumentor

На март 2018 года этот способ установки через PEAR не работает. Формально он работает, но phpdoc после такой устновки выдает ошибку связанную с dompdf.

PHP Warning:  require_once(/dompdf/dompdf/dompdf_config.inc.php): failed to open stream: No such file or directory in /usr/share/php/phpDocumentor/src/phpDocumentor/Bootstrap.php on line 178
PHP Fatal error:  require_once(): Failed opening required '/dompdf/dompdf/dompdf_config.inc.php' (include_path='.:/usr/share/php') in /usr/share/php/phpDocumentor/src/phpDocumentor/Bootstrap.php on line 178

Поэтому предлагается скачать tgz архив с репозитария phpDocumentor на GitHub и запустить PEAR установку с этого пакета.

wget https://github.com/phpDocumentor/phpDocumentor2/releases/download/v2.9.0/phpDocumentor.phar
sudo pear install phpDocumentor-2.9.0.tgz

По окончании установки будет доступна команда phpdoc

phpdoc --version

Использование

В простейшем случае, находясь в директории проекта, просто запустите комнду phpdoc из консоли:

phpdoc -d ./

Основной ситаксис использования:

phpdoc -d ./src -t ./docs --template responsive

В приведенном примере выполняется проверка всех файлов в каталоге src и его подкаталогах, документация помещается в папку docs. Если опустить опцию -t, ты вывод будет записан в папку output. Для анализа выбранного каталого используется ключ -d, для выбранного файла — -f. В качестве шаблона используется responsive.

Список шаблонов:

phpdoc template:list

Похожие записи

Установка актуальной nodejs на ubuntu

В официальных репозиториях Ubuntu предлагется дореволюционная версия node.js. В этом руководстве рассказывется как установить актуальную Node.js на Ubuntu или в подсистему linux на Windows 10, что собственно говоря, одно и тоже.

16 июн 2017 г. в Linux

Ubuntu. В разделе /boot не осталось места.

Недавно столкнулся с проблемой, что система ubuntu не может обновиться. Пишет ошибки про неудвлетворенные зависимости и не дает возможности завершится командам.

31 авг 2017 г. в Linux

Как запускать shell (*.sh) скрипты?

Shell - это один из командных интерпретаторов, поставляемых вместе с ОС unix. Программа на языке Shell называется скриптом. Shell скрпитам указывают расширение *.sh и работают они Unix системах. Если вам надо запустить shell скрипт в windows, то можно установить подсистему Linux Ubuntu или установить отдельно интерпретатор Shell для windows.