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:

Erro: unable to unpack

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:

Linha com erro

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:

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.

Recompactar phpDocumentor

 

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:

Caso tenha a extenção 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.

 

Sobre Rodrigo Teixeira Andreotti

Técnico em Informática formado pela ETE Lauro Gomes
Cursando atualmente o curso de Análise e Desenvolvimento de sistemas.

Atuo como programador PHP há, pelo menos, 6 anos, sendo os dois últimos em empresas e os demais como Freelancer.