Fala pessoal, andei me debatendo bastante para instalar o phpDocumentor aqui, então resolvi deixar esta dica rápida para quem está tentando instalar o PHPDocumentor em versões acima da 2.8.1 (que é a última que o pear consegue instalar no Windows sem erros) usando o pear.

Lembrando que para utilizar esta ferramenta é necessário ter o PHP instalado e configurado, caso queira ver como fazer isso aqui vai Tutorial PHP: Instalando o PHP

O Erro na instalação do phpDocumentor

Aparentemente o pessoal que desenvolve o phpDocumentor alterou o caminho de instalação de algo nele, mais especificamente o nome de um diretório, causando o erro a seguir:

Este problema é descrito neste issue no GitHub oficial: https://github.com/phpDocumentor/phpDocumentor2/issues/1608

A solução

Iremos precisar de algum compactador de arquivos capaz de lidar com arquivos TAR e TGZ, recomendo o 7-zip.

Primeiramente acesse o link abaixo e baixe a versão mais atual do mesmo:

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

Segunda etapa, precisamos descompactar o arquivo em uma pasta só para ele:

Obs.: Se o arquivo baixado tiver a extensão .tgz pode ser necessário descompactar novamente, pois esse formato trabalha com um pacote .tar compactado.

Depois vamos editar o arquivo package.xml com um editor de código de nossa preferência.

Mais especificamente vamos editar esta linha:

Podemos observar que a linha indica um caminho para um arquivo, e no Windows não é permitido o uso do caractere “:” para nomes de arquivos e diretórios, sendo assim basta alterarmos este trecho destacado de:

template:init

para:

template_init

Ficando com o nó do XML desta forma:

<file baseinstalldir="/phpDocumentor" 
    md5sum="d41d8cd98f00b204e9800998ecf8427e" 
    name="features/4. Browsing the documentation/1. Creating a new template/4.1.1. Generate skeleton using template_init task.feature" 
    role="data">
        <tasks:replace from="@php_bin@" to="php_bin" type="pear-config" />
</file>

Feiro isso, agora vamos recompactar o pacote, para isso use o compactador de sua preferência e compacte a pasta com a extensão tar ou tgz.

Para finalizar a instalação voltamos ao Prompt, e realizamos a instalação através deste pacote que acabamos de gerar apontando para ele dentro da pasta onde ele estiver.

Se o arquivo gerador tiver a extensão .tar:

pear install --nocompress phpDocumentor.tar

Caso tenha a extenção tgz:

pear install  phpDocumentor.tgz

Observação Final

Aparentemente na versão 2.9.0 este problema foi corrigido, porém esta versão até a data deste post não foi disponibilizada no repositório pear, então basta baixar ela através do link do início deste post e instalar utilizando um dos comandos acima.

Bom, é isso, espero que a dica seja útil, para mim demorou um pouco para encontrar a solução, então espero facilitar o trabalho de outros que precisem.