Caros Amigos,
Resolví criar este tópico depois de muito pesquisar, ler, aprender e
querer aprender mais (com o Walker e Cia.). O conteúdo hoje no site
(hoje é dia 17/11/2009 - Terça) é muito vasto, porém com pouca
abordagem de como realmente iniciar no "grosso" da coisa em outras
palavras de como fazer o sistema rodar para quem sabe colaborar com os
códigos implementado ainda mais e chegando a um patamar melhor.
Listei algumas dúvidas minhas e de algumas outras pessoas que ví aqui
na lista, aí vão elas:
1 - Baixando os arquivos.
2- Upload de arquivos.
3 - Configuração dos arquivos.
4 - Instalação do banco de dados.
5 - Tarefas CRON e definição de arquivos que farão parte da tarefa.
6 - Upload do .TXT ou .XML gerado apartir do ERP.
7 - Impressão de Danf-e em tela.
Resumindo, o funcionamento do sistema como um todo.
Nesta primeira postagem vou mostrar como Baixar os arquivos (1), fazer
o Upload para um servidor externo (2) e indicar a parte de
configuração dos arquivos (3). Que justamente foi tudo o que eu fiz
até agora e até este "pé", obtive bastante sucesso.
Vamos lá:
1 - Baixando os arquivos.
Como vimos na página oficial do projeto em:
http://www.nfephp.org
existe um link levando até o portal assembla:
http://www.assembla.com/wiki/show/nfephp
neste endereço existe uma páginas com informações, dúvidas,
discussões, e claro os arquivos, na aba FILES listamos todos os
arquivos do projeto. E como ficaria chato baixar um a um usaremos um
cliente especial para baixarmos via SVN e esse cliente precisa de uma
url específica que nos podemos encontrar na aba SOUCE/SVN.
SVN Url:
http://subversion.assembla.com/svn/nfephp
SVN? sim SVN, na wikipédia SVN quer dizer: Subversion (também
conhecido por svn) é um sistema de controle de versão desenhado
especificamente para ser um substituto moderno do CVS, que se
considera ter algumas limitações.
Um sistema de controle de versão (ou versionamento), VCS (do inglês
version control system) ou ainda SCM (do inglês source code
management) na função prática da Ciência da Computação e da Engenharia
de Software, é um software com a finalidade de gerenciar diferentes
versões no desenvolvimento de um documento qualquer. Esses sistemas
são comumente utilizados no desenvolvimento de software para controlar
as diferentes versões – histórico e desenvolvimento – dos códigos-
fontes e também da documentação.
Esse tipo de sistema é muito presente em empresas e instituições de
tecnologia e desenvolvimento de software. É também muito comum no
desenvolvimento de software livre. É útil, em diversos aspectos, tanto
para projetos pessoais pequenos e simples como também para grandes
projetos comerciais.
Entre os mais comuns encontram-se as soluções livres: CVS e SVN; e as
comerciais: SourceSafe e ClearCase. O desenvolvimento de software
livre prefere o SVN que vem substituindo o clássico CVS. Muitas
empresas também adotam o SVN, embora algumas empresas prefiram uma
solução comercial, optando pelo ClearCase (da IBM) ou SourceSafe (da
Microsoft). Optar por uma solução comercial geralmente está
relacionada à garantia, pois as soluções livres não se responsabilizam
por erros no software e perdas de informações[1], apesar das soluções
livres poderem ter melhor desempenho e segurança que as comerciais.
A eficácia do controle de versão de software é comprovada por fazer
parte das exigências para melhorias do processo de desenvolvimento de
certificações tais como CMMI e SPICE.
Enfim vamos lá, vou mostrar aqui como se trabalhar com o cliente SVN:
TORTOISE SVN
Download direto (Versão WIN 32bits):
http://downloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.6.6.17493-win32-svn-1.6.6.msi?download
Download direto (Versão WIN 64bits):
http://downloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.6.6.17493-x64-svn-1.6.6.msi?download
Após baixarmos (+ ou - 18mb) efetuamos a instalação normalmente :
next, next, next finish :). Pronto nosso cliente SVN foi instalado com
êxito.
Crie uma pasta em qualquer local e dê a ela o nome de NFePHP (esse
nome não é obrigatório, pode ser qualquer nome) e após sua criação
clique com o botão direito do mouse em cima e logo irá visualizar as
opções que seu menu direito ganhou após a instalação do TORTOISE SVN,
são elas: SVN CHECKOUT E TOITOISE SVN, vc irá escolher a opção: SVN
CHECKOUT que abrirá uma janela logo em seguida solicitando a url
repository SVN que vc quer baixar, neste campo irá entrar com a
seguinte url:
http://subversion.assembla.com/svn/nfephp (url SVN do
projeto NFePHP), e clique em ok.Em seguida abrirá um monitor com os
arquivos sendo baixados.
Pronto todos os arquivos do projeto serão baixados na pasta que você
criou e configurou via cliente SVN.
VAMOS AGORA AO UPLOAD DOS ARQUIVOS:
2- Upload de arquivos.
No meu caso irei fazer upload para um servidor web externo (ip de
fora) onde tenho uma máquina alocada, bem a pasta com todos os
arquivos já está criada basta abrir um cliente FTP (usarei o CuteFTP)
acessar a conta na qual deseja acessar via FTP, conectar-se e fazer o
upload para o seu servidor.
Não vou testar local, porém que usar favor mostrar o procedimento,
qual servidor usou, como configurou e etc, será interessante.
VAMOS AGORA A CONFIGURAÇÃO DOS ARQUIVOS:
3 - Configuração dos arquivos.
Neste passo irei utilizar o material que Walker me passou, tendo em
vista que o arquivo a ser configurado incialmente será o:
config_inc.php.
conteúdo retirado do manual passo a passo oficial do projeto:
https://www.assembla.com/wiki/show/nfephp/Passo_a_passo
Para o correto funcionamento da API, alguns parâmetros devem ser
informados, e são eles:
* Ambiente ( $ambiente ) : o modo de funcionamento da API, podendo
assumir os seguintes valores:
1. Produção
2. Homologação/testes
3. Contingência (Homologação/testes)
4. Contingência (Produção)
* Diretórios ( $entradasDir, $assinadasDir, etc... ) : pastas das
notas, de bibliotecas, dos certificados e, por fim, dos squemas
* Dados do certificado ( $keyPass, $passPhrase, $certName ) :
senha da chave privada, senha para a decriptografia e nome do arquivo
do certificado .pfx
* Dados da empresa ( $empresa, $cUF, $UF ) : razão social, código
da UF (veja tabela do IBGE) e sigla da UF (AM, RJ, SP... etc). Obs:
CNPJ e outros dados do emitente são fornecidos durante a geração da
nota
Bem pessoal até este estágio tudo que expliquei e fiz aqui no meu eu
obtive sucesso, como mus conhecimentos ainda são limitados deixarei
para outros listarem o restante dos tópicos sugeridos que são:
4 - Instalação do banco de dados.
5 - Tarefas CRON e definição de arquivos que farão parte da tarefa.
6 - Upload do .TXT ou .XML gerado apartir do ERP.
7 - Impressão de Danf-e em tela.
Gostaria de encarecidamente pedir a quem for colaborar neste tópico
usar uma linguagem ampla para um melhor entendimento de todos.
Desde Já reforço minha idéia de contribuir com a Lista e com o
projeto, creio que será um grande sucesso NFePHP.
Abraços