Skip to content
Código fuente Transbank SDK para PHP
Branch: master
Clone or download
Latest commit 79de129 Jun 3, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
lib
tests Add a couple of tests for WidthHeight Dec 6, 2018
.editorconfig Add editorconfig Aug 27, 2018
.gitignore
CHANGELOG.md Prepare release 1.5.2 May 22, 2019
Dockerfile Change lib mcrypt to openssl to support php7 Oct 26, 2018
LICENSE Rename LICENSE.md to LICENSE Aug 1, 2018
Makefile Add --rm to composer Aug 29, 2018
README.md Prepare release 1.5.2 May 22, 2019
composer.json Prepare release 1.5.2 May 22, 2019
composer.lock Replace XMLSecurityKey Oct 29, 2018
docker-compose.yml Rename sdktest to sdktest.sh Aug 29, 2018
init.php Fix names of some files Dec 10, 2018
phpunit.xml Change OnePay to Onepay everywhere Jul 31, 2018
sdktest.sh Remove bootstrap on phpunit Oct 23, 2018

README.md

Build Status Latest Stable Version

Transbank PHP SDK

SDK Oficial de Transbank

Requisitos:

  • PHP 5.5+

Dependencias

En caso de instalar con Composer las siguientes dependencias deberían instalarse automaticamente, pero si usas el SDK de manera directa requerirás también:

  • ext-curl
  • ext-json
  • ext-mbstring
  • ext-soap

Instalación

Instalar con Composer

Para usar el SDK en tu proyecto puedes usar Composer, añadiendo el SDK como dependencia a tu proyecto:

    "require": {
        "transbank/transbank-sdk": "1.5.2"
    }

También puedes instalarlo desde la consola:

composer require transbank/transbank-sdk

O, si no deseas usar Composer, puedes descargar el código desde este repositorio y requerirlo directamente:

require_once('/directorio/del/sdk/init.php');

Documentación

Puedes encontrar toda la documentación de cómo usar este SDK en el sitio https://www.transbankdevelopers.cl.

La documentación relevante para usar este SDK es:

Información para contribuir y desarrollar este SDK

Requerimientos

  • Docker
  • Make
  • Plugin de editorconfig para tu editor favorito.

Standares

  • Para los commits respetamos las siguientes normas: https://chris.beams.io/posts/git-commit/
  • Usamos ingles, para los mensajes de commit.
  • Se pueden usar tokens como WIP, en el subject de un commit, separando el token con :, por ejemplo: WIP: This is a useful commit message
  • Para los nombres de ramas también usamos ingles.
  • Se asume, que una rama de feature no mezclada, es un feature no terminado.
  • El nombre de las ramas va en minúsculas.
  • Las palabras se separan con -.
  • Las ramas comienzan con alguno de los short lead tokens definidos, por ejemplo: feat/tokens-configuration

Short lead tokens

Commits
  • WIP = Trabajo en progreso.
Ramas
  • feat = Nuevos features
  • chore = Tareas, que no son visibles al usuario.
  • bug = Resolución de bugs.

Todas las mezclas a master se hacen mediante Pull Request.

Test

Para ejecutar los test localmente debes usar el siguiente comando en una terminal.

make test

Deploy de una nueva versión.

Para generar una nueva versión, se debe crear un PR (con un título "Prepare release X.Y.Z" con los valores que correspondan para X, Y y Z). Se debe seguir el estándar semver para determinar si se incrementa el valor de X (si hay cambios no retrocompatibles), Y (para mejoras retrocompatibles) o Z (si sólo hubo correcciones a bugs).

En ese PR deben incluirse los siguientes cambios:

Modificar el archivo CHANGELOG.md para incluir una nueva entrada (al comienzo) para X.Y.Z que explique en español los cambios de cara al usuario del SDK. Modificar el archivo composer.json para que la propiedad "version" apunte a la nueva versión X.Y.Z Modificar este README.md para que los ejemplos usen la nueva versión X.Y.Z

Luego de obtener aprobación del pull request, debe mezclarse a master e inmediatamente generar un release en GitHub con el tag X.Y.Z. En la descripción del release debes poner lo mismo que agregaste al changelog.

Con eso Travis CI generará automáticamente una nueva versión de la librería y la publicará en Packagist.

You can’t perform that action at this time.