Постоянно приходится копать в сторону нужных команд терминала. Адрес официальной документации часто теряется. Сохраняю:
Ubuntu 10
’tag’Документация по командам терминала Ubuntu
Tags: Ubuntu 10, терминал Ubuntu, терминал Ubuntu 10, терминал Ubuntu lucid
Записано в
Ubuntu | Постоянная ссылка
Установка phpDocumentor в Ubuntu 10 и связанные проблемы
Если ранее PhpDocumentor не был установлен в Ubuntu 10, то проблем не возникнет.
Поиск в Интернете позволил мне найти очень хорошую статью на эту тему на английском:
Прежде установки самого phpDocumentor следует установить LAMP. Как это сделать хорошо написано в данной статье:
Установка 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
Можно пробовать открыть следующий адрес:
Установка 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
Сегодня я уже сделал одну большую ошибку, решив установить phpDocumentor версии 2. Сломалась, как версия 1.4.4, так и 2 не стала работать.
Еще ранее я нечаянно удалил папку с phpDocumentor:
/var/www/PhpDocumentor
Если пробовать заново установить 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 здесь:
Потом скопировал его в папку /var/www/phpDocumentor2
. Затем запустил installer.php
. Не помню, но вроде ничего не произошло.
Увидел рекомендации разработчиков по установке. Выполнил в Терминале 2 команды:
pear channel-discover pear.phpdoc.org pear install phpdoc/phpDocumentor-alpha
После этого более ни одна из версий phpDocumentor не работала и пришлось все восстанавливать несколько часов.
Tags: LAMP, phpDocumentor, phpDocumentor 2, Ubuntu 10
Записано в
Ubuntu | Постоянная ссылка