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

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:

<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.

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:

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.

 

Sobre Rodrigo Teixeira Andreotti

Técnico em Informática formado pela ETEC Lauro Gomes Analista de Sistemas Pela universidade Metodista. Impacta Certified Specialist - Linux Programador PHP desde 2007, atuando em diversos projetos de sistemas internos, migrações, desenvolvimento de API's e sites públicos tanto como freelancer quanto com contrato com empresas. Também atuante como administrador Linux, administrando dois servidores próprios com CentOS, além de prestar serviços de administração e manutenção em servidores para algumas empresas.



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

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:

<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.

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:

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.

 

Sobre Rodrigo Teixeira Andreotti

Técnico em Informática formado pela ETEC Lauro Gomes Analista de Sistemas Pela universidade Metodista. Impacta Certified Specialist - Linux Programador PHP desde 2007, atuando em diversos projetos de sistemas internos, migrações, desenvolvimento de API's e sites públicos tanto como freelancer quanto com contrato com empresas. Também atuante como administrador Linux, administrando dois servidores próprios com CentOS, além de prestar serviços de administração e manutenção em servidores para algumas empresas.