Erro de Instalação do phpDocumentor com pear no Windows

Blog Sobre tecnologia

Erro de Instalação do phpDocumentor com pear no Windows

Resolvendo Erro de Instalação do phpDocumentor com pear no Windows

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

Figura 1 – Erro ao desempacotar phpDocumentor-2.8.5

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.