Ubuntu 10

Если ранее PhpDocumentor не был установлен в Ubuntu 10, то проблем не возникнет.

Поиск в Интернете позволил мне найти очень хорошую статью на эту тему на английском:

• http://www.greenhughes.com/content/how-install-phpdocumentor-ubuntu

Прежде установки самого phpDocumentor следует установить LAMP. Как это сделать хорошо написано в данной статье:

• http://easylinux.ru/node/299/

Установка LAMP

Приведу пример установки Apache + PHP 5 версии + MySQL + PhpMyAdmin. Далее команды терминала:

apt-get update
aptitude install apache2 php5 libapache2-mod-php5
aptitude install mysql-server mysql-client php5-mysql
apt-get install phpmyadmin

Если команды с префиксом "aptitude" не работают, то можно элементарно открыть Менеджер пакетов Synaptic и в ручную найти, отметить для установки и установить следующие компоненты:

• apache2
• php5
• libapache2-mod-php5

После установить:

• mysql-server
• mysql-client
• php5-mysql

И в завершение:

• phpmyadmin

В процессе установки будет предложено задать пароль для MySQL и PhpMyAdmin, если не ошибаюсь. Желательно использовать один и тот же пароль в обоих случаях во избежание путаницы.

После открываем следующий файл:
/etc/apache2/apache2.conf

и в любое место вставляем строку:
Include /etc/phpmyadmin/apache.conf

Останавливаем и вновь запускаем Apache:

sudo /etc/init.d/apache2 stop
sudo /etc/init.d/apache2 start

Можно пробовать открыть следующий адрес:

•  http://localhost/

Установка phpDocumentor

Теперь что касается непосредственно установки phpDocumentor:

sudo apt-get install php-pear
sudo pear config-set data_dir /var/www
sudo pear install --alldeps PhpDocumentor

phpDocumentor установлен. Теперь осталось задать папку, где будут храниться папки документации:

sudo mkdir /var/www/PhpDocumentor-output
sudo chown www-data /var/www/PhpDocumentor-output

Документацию можно сформировать через Терминал:

phpdoc --output HTML:frames:DOM/earthli --directory /var/www/joomla17/ --target /var/www/PhpDocumentor-output/joomla17/ --title 'Joomla 1.7' --defaultpackagename 'Joomla' --defaultcategoryname 'Joomla' --parseprivate on --sourcecode on

Список параметров и описания к ним можно отобразить в Терминале с помощью команды:

phpdoc -h

Описания параметров и примеры использования phpDocumentor можно найти на этой странице:

• phpDocumentor Tutorial

Проблемы при установке phpDocumentor

Сегодня я уже сделал одну большую ошибку, решив установить phpDocumentor версии 2. Сломалась, как версия 1.4.4, так и 2 не стала работать.

Еще ранее я нечаянно удалил папку с phpDocumentor:
/var/www/PhpDocumentor

Если пробовать заново установить phpDocumentor по схеме, указанной выше, то ничего не получится. Для того, чтобы решить проблему сначала нужно скачать оригинальные файлы от версии 1.4.4:

• http://sourceforge.net/projects/phpdocu/files/PhpDoc/phpDocumentor-1.4.4/

На странице по ссылке нужно сверху нажать на ссылку "Download PhpDocumentor-1.4.4.zip". Затем распаковать архив на компьютере и перенести его в папку:
/var/www/PhpDocumentor

Если же была неудачная попытка установить phpDocumentor2, то необходимо:

• удалить папки:
• /var/www/PhpDocumentor
• /usr/share/php/PhpDocumentor
• /usr/share/php/PEAR
• удалить файл:
• /usr/bin/phpdoc

После этого через виртуальную машину Oracle VM VirtualBox или на другой компьютер установить Ubuntu 10 и поставить на него phpDocumentor 1.4.4. Затем скопировать папки и файл, который мы удалили ранее. Все должно работать.

Что касается phpDocumentor2, то более даже не буду пробовать его установить.

Изначально скачал phpDocumentor2 здесь:

• https://github.com/phpDocumentor/phpDocumentor2

Потом скопировал его в папку /var/www/phpDocumentor2. Затем запустил installer.php. Не помню, но вроде ничего не произошло.

Увидел рекомендации разработчиков по установке. Выполнил в Терминале 2 команды:

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

После этого более ни одна из версий phpDocumentor не работала и пришлось все восстанавливать несколько часов.