Updated to 1.1.4 version

Author: josantonius

.gitattributes

@@ -1,6 +1,4 @@
 /tests export-ignore
-/src/bootstrap.php export-ignore
-/vendor export-ignore
 .gitattributes export-ignore
 .gitignore export-ignore
 _config.yml export-ignore
@@ -10,6 +8,7 @@ phpunit.xml.dist export-ignore
 CONDUCT.md export-ignore
 contributors.txt export-ignore
 README.md export-ignore
+phpcs.ruleset.xml export-ignore
 README-ES.md export-ignore
 .editorconfig export-ignore
 composer.lock export-ignore

.gitignore

@@ -3,7 +3,7 @@ composer.phar
 composer.lock
 composer-test.lock
 build/artifacts/
-artifacts/
+vendor/
 docs/_build
 docs/*.pyc
 .git*/

.travis.yml

@@ -4,24 +4,42 @@ sudo: false
 
 dist: trusty
 
+branches:
+  only:
+    - master
+
 git:
   depth: 5
 
 php:
   - 5.6
   - 7.0
   - 7.1
+  - 7.2
   - hhvm
   - nightly
 
 matrix:
   fast_finish: true
+  include:
+    - php: 7.1
+      env: PHPCS=PSR2
+
   allow_failures:
     - php: nightly
 
 before_script:
-  - composer self-update
-  - composer install
+  - export PATH="./vendor/bin:$PATH"
+  - travis_retry composer self-update
+  - travis_retry composer install --no-interaction --prefer-source --dev
 
 script:
-  - composer test
+  - phpunit
+  - |
+    if [[ "$PHPCS" ]] ; then
+      phpcs --standard=phpcs.ruleset.xml $(find . -name '*.php')
+    fi
+    phpunit --coverage-clover=coverage.xml
+
+after_success:
+ - bash <(curl -s https://codecov.io/bash)

CHANGELOG.md

@@ -1,5 +1,27 @@
 # CHANGELOG
 
+## 1.1.4 - 2017-10-25
+
+* Implemented `PSR-4 autoloader standard` from all library files.
+
+* Implemented `PSR-2 coding standard` from all library PHP files.
+
+* Implemented `PHPCS` to ensure that PHP code complies with `PSR2` code standards.
+
+* Implemented `Codacy` to automates code reviews and monitors code quality over time.
+
+* Implemented `Codecov` to coverage reports.
+
+* Added `Curl/phpcs.ruleset.xml` file.
+
+* Deleted `Curl/src/bootstrap.php` file.
+
+* Deleted `Curl/tests/bootstrap.php` file.
+
+* Deleted `Curl/vendor` folder.
+
+* Changed `Josantonius\Curl\Test\CurlTest` class to  `Josantonius\Curl\CurlTest` class .
+
 ## 1.1.3 - 2017-09-11
 
 * Unit tests supported by `PHPUnit` were added.

README-ES.md

@@ -1,17 +1,17 @@
 # PHP Curl library
 
-[![Latest Stable Version](https://poser.pugx.org/josantonius/curl/v/stable)](https://packagist.org/packages/josantonius/curl) [![Total Downloads](https://poser.pugx.org/josantonius/curl/downloads)](https://packagist.org/packages/josantonius/curl) [![Latest Unstable Version](https://poser.pugx.org/josantonius/curl/v/unstable)](https://packagist.org/packages/josantonius/curl) [![License](https://poser.pugx.org/josantonius/curl/license)](https://packagist.org/packages/josantonius/curl) [![Travis](https://travis-ci.org/Josantonius/PHP-Curl.svg)](https://travis-ci.org/Josantonius/PHP-Curl)
+[![Latest Stable Version](https://poser.pugx.org/josantonius/Curl/v/stable)](https://packagist.org/packages/josantonius/Curl) [![Latest Unstable Version](https://poser.pugx.org/josantonius/Curl/v/unstable)](https://packagist.org/packages/josantonius/Curl) [![License](https://poser.pugx.org/josantonius/Curl/license)](LICENSE) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/5137ab63729545d78f4a417075a6ce02)](https://www.codacy.com/app/Josantonius/PHP-Curl?utm_source=github.com&utm_medium=referral&utm_content=Josantonius/PHP-Curl&utm_campaign=Badge_Grade) [![Total Downloads](https://poser.pugx.org/josantonius/Curl/downloads)](https://packagist.org/packages/josantonius/Curl) [![Travis](https://travis-ci.org/Josantonius/PHP-Curl.svg)](https://travis-ci.org/Josantonius/PHP-Curl) [![PSR2](https://img.shields.io/badge/PSR-2-1abc9c.svg)](http://www.php-fig.org/psr/psr-2/) [![PSR4](https://img.shields.io/badge/PSR-4-9b59b6.svg)](http://www.php-fig.org/psr/psr-4/) [![CodeCov](https://codecov.io/gh/Josantonius/PHP-Curl/branch/master/graph/badge.svg)](https://codecov.io/gh/Josantonius/PHP-Curl)
 
 [English version](README.md)
 
 Biblioteca PHP para hacer peticiones HTTP a través de CURL. Fácil integración con API REST.
 
 ---
 
-- [Instalación](#instalación)
 - [Requisitos](#requisitos)
-- [Cómo empezar y ejemplos](#cómo-empezar-y-ejemplos)
+- [Instalación](#instalación)
 - [Métodos disponibles](#métodos-disponibles)
+- [Cómo empezar](#cómo-empezar)
 - [Uso](#uso)
 - [Tests](#tests)
 - [Manejador de excepciones](#manejador-de-excepciones)
@@ -23,81 +23,242 @@ Biblioteca PHP para hacer peticiones HTTP a través de CURL. Fácil integración
 
 ---
 
+### Requisitos
+
+Esta clase es soportada por versiones de `PHP 5.6` o superiores y es compatible con versiones de `HHVM 3.0` o superiores.
+
 ### Instalación 
 
-La mejor forma de instalar esta extensión es a través de [composer](http://getcomposer.org/download/).
+La mejor forma de instalar esta extensión es a través de [Composer](http://getcomposer.org/download/).
 
-Para instalar PHP Curl library, simplemente escribe:
+Para instalar `PHP Curl library`, simplemente escribe:
 
     $ composer require Josantonius/Curl
 
-El comando anterior sólo instalará los archivos necesarios, si prefieres descargar todo el código fuente (incluyendo tests, directorio vendor, excepciones no utilizadas, documentos...) puedes utilizar:
+El comando anterior sólo instalará los archivos necesarios, si prefieres **descargar todo el código fuente** puedes utilizar:
 
     $ composer require Josantonius/Curl --prefer-source
 
-También puedes clonar el repositorio completo con Git:
+También puedes **clonar el repositorio** completo con Git:
 
     $ git clone https://github.com/Josantonius/PHP-Curl.git
 
-### Requisitos
+O **instalarlo manualmente**:
+
+[Descargar Curl.php](https://raw.githubusercontent.com/Josantonius/PHP-Curl/master/src/Curl.php):
+
+    $ wget https://raw.githubusercontent.com/Josantonius/PHP-Curl/master/src/Curl.php
+
+### Métodos disponibles
 
-Esta biblioteca es soportada por versiones de PHP 5.6 o superiores y es compatible con versiones de HHVM 3.0 o superiores.
+Métodos disponibles en esta biblioteca:
+
+`Realizar petición HTTP:`
+
+```php
+Curl::request($url, $params, $result);
+```
 
-### Cómo empezar y ejemplos
+| Atributo | Descripción | Tipo | Requerido | Predeterminado
+| --- | --- | --- | --- | --- |
+| $url | URL donde realizar la petición. | string | Yes | |
 
-Para utilizar esta biblioteca, simplemente:
+| Atributo | Clave | Descripción | Tipo | Requerido | Predeterminado
+| --- | --- | --- | --- | --- | --- |
+| $params | | Parámetros. | array | No | array() |
+| | 'referer' | URL de referencia. | string | No | |
+| | 'timeout' | Tiempo de espera. | int | No | |
+| | 'agent' | Useragent. | string | No | |
+| | 'headers' | Encabezados HTTP. | array | No | |
+| | 'data' | Parámetros para enviar. | array | No | |
+| | 'type' | Tipo de petición. | string | No | |
+
+| Atributo | Descripción | Tipo | Requerido | Predeterminado
+| --- | --- | --- | --- | --- |
+| $result | Devuelve el resultado como array u objeto. | string | No | 'array' |
+
+**# Return** (array|object) → respuesta
+
+### Cómo empezar
+
+Para utilizar esta clase con `Composer`:
 
 ```php
 require __DIR__ . '/vendor/autoload.php';
 
 use Josantonius\Curl\Curl;
 ```
 
-### Métodos disponibles
-
-Métodos disponibles en esta biblioteca:
+Si la instalaste `manualmente`, utiliza:
 
 ```php
-Curl::request();
+require_once __DIR__ . '/Curl.php';
+
+use Josantonius\Curl\Curl;
 ```
 
 ### Uso
 
 Ejemplo de uso para esta biblioteca:
 
+**Enviar petición GET y obtener respuesta como array:**
+
 ```php
-<?php
-require __DIR__ . '/vendor/autoload.php';
+Curl::request('https://graph.facebook.com/zuck');
+```
 
-use Josantonius\Curl\Curl;
+**Enviar petición GET y obtener respuesta como objeto:**
+
+```php
+Curl::request('https://graph.facebook.com/zuck', false, 'object');
+```
+
+**Enviar petición GET con parámetros y obtener respuesta como array:**
+
+```php
+$data = [
+    'timeout' => 10,
+    'referer' => 'http://site.com',
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data);
+```
+
+**Enviar petición GET con parámetros y obtener respuesta como objeto:**
+
+```php
+$data = [
+    'timeout' => 10,
+    'referer' => 'http://site.com',
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data, 'object');
+```
+
+**Enviar petición POST y obtener respuesta como array:**
+
+```php
+$data = [
+    'type'    => 'post',
+    'data'    => array('user' => '123456', 'password' => 'xxxxx'),
+    'timeout' => 10,
+    'referer' => 'http://' . $_SERVER['HTTP_HOST'],
+    'headers' => [
+        'Content-Type:application/json',
+        'Authorization:0kdm3hzmb4h3cf',
+    ],
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data);
+```
 
+**Enviar petición POST y obtener respuesta como objeto:**
+
+```php
 $data = [
+    'type'    => 'post',
+    'data'    => array('user' => '123456', 'password' => 'xxxxx'),
+    'timeout' => 10,
+    'referer' => 'http://' . $_SERVER['HTTP_HOST'],
+    'headers' => [
+        'Content-Type:application/json',
+        'Authorization:0kdm3hzmb4h3cf',
+    ],
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data, 'object');
+```
 
-    'type'      => 'post',
-    'data'      => array('user' => '123456', 'password' => 'xxxxx'),
-    'timeout'   => 10,
-    'referer'   => 'http://'.$_SERVER['HTTP_HOST'],
-    'headers'   => [
+**Enviar petición PUT y obtener respuesta como array:**
 
-        'Content-Type:application/json', 
-        'Authorization:0kdm3hzmb4h3cf'
-    ]
+```php
+$data = [
+    'type'    => 'put',
+    'data'    => array('email' => 'new@email.com'),
+    'timeout' => 30,
+    'referer' => 'http://' . $_SERVER['HTTP_HOST'],
+    'headers' => [
+        'Content-Type:application/json',
+        'Authorization:0kdm3hzmb4h3cf',
+    ],
 ];
+        
+Curl::request('https://graph.facebook.com/zuck', $data);
+```
 
-$response = Curl::request('https://graph.facebook.com/zuck', $data);
+**Enviar petición PUT y obtener respuesta como objeto:**
 
-echo "<pre>"; var_dump($response); echo "</pre>";
+```php
+$data = [
+    'type'    => 'put',
+    'data'    => array('email' => 'new@email.com'),
+    'timeout' => 30,
+    'referer' => 'http://' . $_SERVER['HTTP_HOST'],
+    'headers' => [
+        'Content-Type:application/json',
+        'Authorization:0kdm3hzmb4h3cf',
+    ],
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data, 'object');
+```
+
+**Enviar petición DELETE y obtener respuesta como array:**
+
+```php
+$data = [
+
+    'type'    => 'delete',
+    'data'    => ['userId' => 10],
+    'timeout' => 30,
+    'referer' => 'http://' . $_SERVER['HTTP_HOST'],
+    'headers' => [
+        'Content-Type:application/json',
+        'Authorization:0kdm3hzmb4h3cf',
+    ],
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data);
+```
+
+**Enviar petición DELETE y obtener respuesta como objeto:**
+
+```php
+$data = [
+    'type'    => 'delete',
+    'data'    => ['userId' => 10],
+    'timeout' => 30,
+    'referer' => 'http://' . $_SERVER['HTTP_HOST'],
+    'headers' => [
+        'Content-Type:application/json',
+        'Authorization:0kdm3hzmb4h3cf',
+    ],
+];
+        
+Curl::request('https://graph.facebook.com/zuck', $data, 'object');
 ```
 
 ### Tests 
 
-Para ejecutar las [pruebas](tests/Curl/Test) simplemente:
+Para ejecutar las [pruebas](tests) necesitarás [Composer](http://getcomposer.org/download/) y seguir los siguientes pasos:
 
     $ git clone https://github.com/Josantonius/PHP-Curl.git
 
     $ cd PHP-Curl
 
-    $ phpunit
+    $ composer install
+
+Ejecutar pruebas unitarias con [PHPUnit](https://phpunit.de/):
+
+    $ composer phpunit
+
+Ejecutar pruebas de estándares de código [PSR2](http://www.php-fig.org/psr/psr-2/) con [PHPCS](https://github.com/squizlabs/PHP_CodeSniffer):
+
+    $ composer phpcs
+
+Ejecutar todas las pruebas anteriores:
+
+    $ composer tests
 
 ### Manejador de excepciones
 
@@ -106,7 +267,7 @@ Esta biblioteca utiliza [control de excepciones](src/Exception) que puedes perso
 ### ☑ Tareas pendientes
 
 - [x] Completar tests
-- [ ] Mejorar la documentación
+- [x] Mejorar la documentación
 
 ### Contribuir