72540
Saiba como instalar e configurar nossa SDK em PHP para API Pix e API Boletos (Bolix)
A seguir, confira os procedimentos para instalação da SDK da Gerencianet em PHP:
composer require gerencianet/gerencianet-sdk-php
Link do git https://github.com/gerencianet/gn-api-sdk-php
git clone https://github.com/gerencianet/gn-api-sdk-php.git cd gn-api-sdk-php/ composer install
É importante frisar que as extensões cURL, json, ext-simplexml & openssl devem estar ativadas.
Atualmente, disponibilizamos quatro versões da SDK. A versão 1.x e 2.x é compatível com versões do PHP superiores à versão 5.4 e inferiores à 7.0, possuindo também alguns componentes desatualizados, como o Guzzle. Caso você tenha uma versão do PHP superior à 5.5 e inferior a 7.0, sugerimos utilizar a versão 3.x da nossa SDK. Para versões do PHP maior ou igual 7.2, sugerimos que instale a versão 4.x da SDK.
Vá direto ao ponto - utilize o índice abaixo e veja diretamente o que você precisa:
Os seguintes pré-requisitos devem ser considerados, de acordo com a branch utilizada:
| Versão da branch | Status | Packagist | Repositório | Versão do PHP |
|---|---|---|---|---|
|
Mantido |
|
|
||
|
Mantido |
|
|
||
|
Mantido |
|
|
||
|
Mantido |
|
|
Para a utilização da biblioteca em PHP, recomendamos a instalação através do Composer (gerenciador de dependências).
Caso prefira prosseguir sem o Composer, basta seguir os procedimentos descritos no título 4. Instalação biblioteca PHP da Gerencianet sem o Composer.
Instalaremos o Composer no Windows para baixar as nossas bibliotecas. Se preferir, pode seguir neste link o tutorial do próprio site oficial do Composer.
a) Primeiramente, vamos baixar o instalador do Composer para Windows neste link e, assim que o download for finalizado, execute-o;
b) Você precisará informar o caminho de instalação do seu PHP. Caso você esteja utilizando um servidor Wamp, por exemplo, e na instalação surgir uma mensagem relacionada ao arquivo "openssl", você precisará informar seu arquivo *.exe do PHP contido no diretório raiz do Wamp (geralmente em \wamp\bin\php\php.7.2\). Cabe frisar que a pasta php.7.2 refere-se a versão do PHP que está sendo utilizado na confecção dessas instruções, portanto, esse diretório poderá estar com outro nome, conforme a versão do seu PHP;
c) Durante a instalação, após indicar o diretório do seu PHP, clique em next. A instalação poderá retornar uma mensagem de alerta relacionado à configuração do "openssl". Trata-se de uma mensagem comum que significa que o "openssl" está desabilitado, contudo, vamos resolver de forma rápida e fácil.
Caso não seja retornada nenhuma mensagem sobre o "openssl", apenas prossiga para o subtítulo Baixando as dependências, localizado mais abaixo.
Para habilitar seu "openssl", será necessário alterar o arquivo php.ini.
a) Abra o diretório de instalação do seu php e localize o arquivo php.ini;
b) Abra o arquivo php.ini em um editor de texto (p. ex: notepad++, sublime, etc) e pressione CTRL + F e pesquise pela palavra “openssl” (sem as aspas);
c) O sinal de ponto e vírgula ( ; ) desabilita o arquivo php_openssl.dll. Apague este sinal e ele habilitará o arquivo, ou seja:
Está assim: ;extension=php_openssl.dll
Deve ficar assim: extension=php_openssl.dll
Agora, salve o documento (pressione CTRL + S) e feche o arquivo.
d) A extensão estará habilitada e você poderá continuar com a instalação. Para que a instalação seja atualizada em relação ao procedimento, é importante que você retorne uma tela e depois avance com a instalação normalmente.
a) Crie uma pasta chamada composer no seu diretório Wamp, dentro da pasta www, de forma que tenha essa estrutura: \wamp\www\composer
b) Agora, vamos realizar a instalação das dependências. Abra o prompt de comando do Windows (cmd) e navegue até o diretório raiz, em \wamp\www\composer
c) Vamos executar o comando de instalação das dependências (SDK PHP da Gerencianet) dentro desse diretório. Para tal, execute o comando abaixo:
composer require gerencianet/gerencianet-sdk-php
d) Após a execução do comando, todas as dependências serão instaladas em seu diretório, inclusive a pasta vendor com o arquivo autoload.php.
Pronto, agora é só começar a utilizar as soluções de integração da Gerencianet. Veja a tabela com os tipos de integrações.
É possível instalar o Composer em cada projeto (instalação local) ou ter acesso a ele em qualquer parte do sistema (instalação global). Se preferir, pode seguir neste link o tutorial do próprio site oficial do Composer. Aqui, vamos efetuar a instalação global. Para tal, execute no Terminal o seguinte comando:
$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
Um dos principais arquivos para se trabalhar com o Composer é o composer.json. É nele que as instruções sobre os pacotes que serão usados no projeto ficam contidas. Este é um arquivo de extensão .json comum que deve ficar na raiz de seu projeto.
A diretiva require no arquivo composer.json informa ao Composer quais os pacotes necessários para o projeto - neste caso, o repositório central é o Packagist.
Agora, vamos informar ao Composer que a Gerencianet fará parte do gerenciamento de dependências inserindo o conteúdo abaixo no final do arquivo composer.json (que deve ficar na raiz do projeto):
{"require":
{
"gerencianet/gerencianet-sdk-php": "^4.*"
}
}
É hora de instalar os pacotes. Vá até o diretório em que está seu projeto no Terminal e execute:
$ composer install
E pronto! O download das dependências irá acontecer automaticamente, estas serão armazenadas em suas respectivas pastas e o Composer continuará com o restante do trabalho ao gerar o arquivo composer.lock.
Cabe frisar que, caso você necessite, por exemplo, excluir um pacote, basta deletar sua referência do arquivo composer.json e atualizar o Composer através do seguinte comando:
$ composer update
Dessa forma, o Composer será atualizado e, como não há mais a presença do pacote na diretiva require, ele será imediatamente "desinstalado".
composer.json, a SDK da Gerencianet que será instalada;$ composer install;
O uso do Composer (gerenciador de dependências) é recomendável, mas não obrigatório. Caso seja de seu interesse prosseguir sem utilizá-lo, você pode baixar diretamente uma de nossas branches, descompactar e subir a pasta (inclusive o arquivo "autoload.php") para o diretório de seu projeto.
Atualmente, oferecemos quatro branches, intituladas master, 3.x, 2.xe 1.x, sendo:
master: utiliza versão recente do guzzle (^7.0.0) e é compatível com versões recentes do PHP acima da 7.2. Esta é a versão padrão quando se baixa pelo Composer, sendo indicada para todos os projetos. Acesse o Packagist.
3.x: utiliza até a versão guzzle (6.0.0) e é compatível com versões do PHP (5.5, 5.6, 7.x). Acesse o Packagist.
2.x: utiliza até a versão guzzle (6.0.0) e é compatível com versões do PHP (5.5, 5.6, 7.0 e 7.1). Acesse o Packagist.
1.x: versão anterior da SDK, compatível com PHP 5.4 e 5.5 e utiliza guzzle 5.3.0. Baixe neste link.
A branch master é a default, porém, você pode instalar a branch 1.x. No decorrer desta página você encontrará orientações para as duas versões.
Importante reforçar que o conteúdo presente neste .zip é apenas um requisito para que você possa começar a utilizar a SDK em PHP da Gerencianet. Esta pasta por si só não é um "exemplo pronto" de uso da API Gerencianet, mas a SDK em PHP da Gerencianet que permite a utilização da API.
Os erros a seguir não são da API Gerencianet, mas relacionados à componentes de seu servidor. Confira abaixo os erros mais comuns durante a instalação de nossa API e veja as soluções:
Saiba como instalar e configurar nossa SDK em PHP para API Pix e API Boletos (Bolix)
A seguir, confira os procedimentos para instalação da SDK da Gerencianet em PHP:
composer require gerencianet/gerencianet-sdk-php
Link do git https://github.com/gerencianet/gn-api-sdk-php
git clone https://github.com/gerencianet/gn-api-sdk-php.git cd gn-api-sdk-php/ composer install
É importante frisar que as extensões cURL, json, ext-simplexml & openssl devem estar ativadas.
Atualmente, disponibilizamos quatro versões da SDK. A versão 1.x e 2.x é compatível com versões do PHP superiores à versão 5.4 e inferiores à 7.0, possuindo também alguns componentes desatualizados, como o Guzzle. Caso você tenha uma versão do PHP superior à 5.5 e inferior a 7.0, sugerimos utilizar a versão 3.x da nossa SDK. Para versões do PHP maior ou igual 7.2, sugerimos que instale a versão 4.x da SDK.
Vá direto ao ponto - utilize o índice abaixo e veja diretamente o que você precisa:
Os seguintes pré-requisitos devem ser considerados, de acordo com a branch utilizada:
| Versão da branch | Status | Packagist | Repositório | Versão do PHP |
|---|---|---|---|---|
|
Mantido |
|
|
||
|
Mantido |
|
|
||
|
Mantido |
|
|
||
|
Mantido |
|
|
Para a utilização da biblioteca em PHP, recomendamos a instalação através do Composer (gerenciador de dependências).
Caso prefira prosseguir sem o Composer, basta seguir os procedimentos descritos no título 4. Instalação biblioteca PHP da Gerencianet sem o Composer.
Instalaremos o Composer no Windows para baixar as nossas bibliotecas. Se preferir, pode seguir neste link o tutorial do próprio site oficial do Composer.
a) Primeiramente, vamos baixar o instalador do Composer para Windows neste link e, assim que o download for finalizado, execute-o;
b) Você precisará informar o caminho de instalação do seu PHP. Caso você esteja utilizando um servidor Wamp, por exemplo, e na instalação surgir uma mensagem relacionada ao arquivo "openssl", você precisará informar seu arquivo *.exe do PHP contido no diretório raiz do Wamp (geralmente em \wamp\bin\php\php.7.2\). Cabe frisar que a pasta php.7.2 refere-se a versão do PHP que está sendo utilizado na confecção dessas instruções, portanto, esse diretório poderá estar com outro nome, conforme a versão do seu PHP;
c) Durante a instalação, após indicar o diretório do seu PHP, clique em next. A instalação poderá retornar uma mensagem de alerta relacionado à configuração do "openssl". Trata-se de uma mensagem comum que significa que o "openssl" está desabilitado, contudo, vamos resolver de forma rápida e fácil.
Caso não seja retornada nenhuma mensagem sobre o "openssl", apenas prossiga para o subtítulo Baixando as dependências, localizado mais abaixo.
Para habilitar seu "openssl", será necessário alterar o arquivo php.ini.
a) Abra o diretório de instalação do seu php e localize o arquivo php.ini;
b) Abra o arquivo php.ini em um editor de texto (p. ex: notepad++, sublime, etc) e pressione CTRL + F e pesquise pela palavra “openssl” (sem as aspas);
c) O sinal de ponto e vírgula ( ; ) desabilita o arquivo php_openssl.dll. Apague este sinal e ele habilitará o arquivo, ou seja:
Está assim: ;extension=php_openssl.dll
Deve ficar assim: extension=php_openssl.dll
Agora, salve o documento (pressione CTRL + S) e feche o arquivo.
d) A extensão estará habilitada e você poderá continuar com a instalação. Para que a instalação seja atualizada em relação ao procedimento, é importante que você retorne uma tela e depois avance com a instalação normalmente.
a) Crie uma pasta chamada composer no seu diretório Wamp, dentro da pasta www, de forma que tenha essa estrutura: \wamp\www\composer
b) Agora, vamos realizar a instalação das dependências. Abra o prompt de comando do Windows (cmd) e navegue até o diretório raiz, em \wamp\www\composer
c) Vamos executar o comando de instalação das dependências (SDK PHP da Gerencianet) dentro desse diretório. Para tal, execute o comando abaixo:
composer require gerencianet/gerencianet-sdk-php
d) Após a execução do comando, todas as dependências serão instaladas em seu diretório, inclusive a pasta vendor com o arquivo autoload.php.
Pronto, agora é só começar a utilizar as soluções de integração da Gerencianet. Veja a tabela com os tipos de integrações.
É possível instalar o Composer em cada projeto (instalação local) ou ter acesso a ele em qualquer parte do sistema (instalação global). Se preferir, pode seguir neste link o tutorial do próprio site oficial do Composer. Aqui, vamos efetuar a instalação global. Para tal, execute no Terminal o seguinte comando:
$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
Um dos principais arquivos para se trabalhar com o Composer é o composer.json. É nele que as instruções sobre os pacotes que serão usados no projeto ficam contidas. Este é um arquivo de extensão .json comum que deve ficar na raiz de seu projeto.
A diretiva require no arquivo composer.json informa ao Composer quais os pacotes necessários para o projeto - neste caso, o repositório central é o Packagist.
Agora, vamos informar ao Composer que a Gerencianet fará parte do gerenciamento de dependências inserindo o conteúdo abaixo no final do arquivo composer.json (que deve ficar na raiz do projeto):
{"require":
{
"gerencianet/gerencianet-sdk-php": "^4.*"
}
}
É hora de instalar os pacotes. Vá até o diretório em que está seu projeto no Terminal e execute:
$ composer install
E pronto! O download das dependências irá acontecer automaticamente, estas serão armazenadas em suas respectivas pastas e o Composer continuará com o restante do trabalho ao gerar o arquivo composer.lock.
Cabe frisar que, caso você necessite, por exemplo, excluir um pacote, basta deletar sua referência do arquivo composer.json e atualizar o Composer através do seguinte comando:
$ composer update
Dessa forma, o Composer será atualizado e, como não há mais a presença do pacote na diretiva require, ele será imediatamente "desinstalado".
composer.json, a SDK da Gerencianet que será instalada;$ composer install;
O uso do Composer (gerenciador de dependências) é recomendável, mas não obrigatório. Caso seja de seu interesse prosseguir sem utilizá-lo, você pode baixar diretamente uma de nossas branches, descompactar e subir a pasta (inclusive o arquivo "autoload.php") para o diretório de seu projeto.
Atualmente, oferecemos quatro branches, intituladas master, 3.x, 2.xe 1.x, sendo:
master: utiliza versão recente do guzzle (^7.0.0) e é compatível com versões recentes do PHP acima da 7.2. Esta é a versão padrão quando se baixa pelo Composer, sendo indicada para todos os projetos. Acesse o Packagist.
3.x: utiliza até a versão guzzle (6.0.0) e é compatível com versões do PHP (5.5, 5.6, 7.x). Acesse o Packagist.
2.x: utiliza até a versão guzzle (6.0.0) e é compatível com versões do PHP (5.5, 5.6, 7.0 e 7.1). Acesse o Packagist.
1.x: versão anterior da SDK, compatível com PHP 5.4 e 5.5 e utiliza guzzle 5.3.0. Baixe neste link.
A branch master é a default, porém, você pode instalar a branch 1.x. No decorrer desta página você encontrará orientações para as duas versões.
Importante reforçar que o conteúdo presente neste .zip é apenas um requisito para que você possa começar a utilizar a SDK em PHP da Gerencianet. Esta pasta por si só não é um "exemplo pronto" de uso da API Gerencianet, mas a SDK em PHP da Gerencianet que permite a utilização da API.
Os erros a seguir não são da API Gerencianet, mas relacionados à componentes de seu servidor. Confira abaixo os erros mais comuns durante a instalação de nossa API e veja as soluções: