Merge branch 'develop'

# Conflicts:
#	src/Sephpa.php

.gitignore

@@ -1 +1,5 @@
-vendor/
+vendor/
+composer.lock
+
+.idea/
+tests/output/

.travis.yml

@@ -1,17 +1,14 @@
 language: php
+dist: trusty
 
 php:
   - 5.6
   - 7.0
   - 7.1
+  - 7.2
   - hhvm
 
-matrix:
-  allow_failures:
-    php: hhvm
+install:
+  - composer install --prefer-source --no-interaction
 
-before_script:
-  - composer self-update
-  - composer install --prefer-source --no-interaction --dev
-
-script: phpunit
+script: vendor/phpunit/phpunit/phpunit

CHANGE_LOG.md

@@ -1,30 +1,74 @@
 Sephpa - Change Log
 ===============
 
-##1.3.1 - Not released yet##
-- corrected some doc comments
-
-##1.3.0 - Feb 5, '15##
+## 2.0.0 - *** *, '18
+This is a new major release. It comes with many new features and changes. This also effects the
+interface (highlighted with **bold** text). The changes are as minimal as possible to make it as easy as possible to migrate to
+the new version, but still old code will not work with this version. To be clear: You should migrate
+to the new version, since version 1 is no longer supported.
+
+- new: support for PHP 7.0, 7.1, 7.2 and HHVM.
+- new: support for pain.001.001.03 and pain.008.001.02<br>
+Notice that this implementation fits the new german standard that is valid from November 2016. 
+It is said that this is compatible with the formats with the same name from 2009 that is used 
+in many other countries but germany. But since it has less restrictions than the file format 
+from 2009, you can choose witch one you need via the SepaUtilities constants `SEPA_PAIN_001_001_03`
+for the old version and `SEPA_PAIN_001_001_03_GBIC` for the new german version of SEPA credit 
+transfer files (respectively `SEPA_PAIN_001_001_03` and `SEPA_PAIN_001_001_03_GBIC` for direct 
+debit files).
+- new: support for pain.008.001.02.austrian.003
+- new: an autoloader file that can be used out of the box if you don't want to use composer.
+- new: SephpaMultiFile class to easier handle multiple Sephpa files.
+- **changed**: SEPA files no longer Support multiple collections. This change was made because the
+banks seem not to support this feature of the file scheme and either split the files up them self
+or just don't take the file and request the user to split the files up.
+So the `addCollection` function was removed. You now need to create a new Sephpa object if you
+need a new collection or use the new multi file class. 
+- new: all store/download functions have now the option to store documentation files as PDF. To
+use this you have to also install the package `SepaDocumentor`. See the readme for
+an example.  
+It also supports to download multiple files as a single zip file.
+- new: `orgId > BICOrBEI` and `orgId > Othr > Id` are supported on the file level. This is needed in some countries.
+But it is highly recommended not to use it unless your bank requires this and you know what you 
+are doing. 
+- fixed: invalid xml file if checkAndSanitize is turned off and `AmdmntInd` is not provided (issue #6)
+- fixed: some minor bugs no one seems to have noticed yet.
+- changed: updated SepaUtilities to ~1.2.3
+- changed: made generateXml private. This should not break any code, since no one should be using
+- changed: corrected some doc comments
+this function directly. It was only public to directly access the generated xml for testing.
+- **changed**: renamed `storeSepaFile()` to `store()` and `downloadSepaFile()` to `download()`.
+- **changed**: removed the creation date parameter from `storeSepaFile()` and `downloadSepaFile()`.
+- **changed**: the file name provided to `storeSepaFile()` and `downloadSepaFile()` should no longer
+contain a file ending like `.xml`.
+This should not break any code since it was recommended not to use this. It was just for easier testing.
+- **changed**: Sephpa constructor now throws a SephpaInvalidInput exception if the input was invalid
+and couldn't be sanitized.
+- dependency: For multi file downloads you need [`libzip`](http://php.net/manual/en/book.zip.php).
+- dev: improved testing of SEPA files and added a ton of tests.
+- dev: updated PHPUnit to v5.7.* and 6.3.* depending on PHP version.
+
+## 1.3.0 - Feb 5, '15
 - updated SepaUtilities to 1.1.0
 - changed licence to GNU LGPL v3.0
 
-##1.2.4 - Jan 27, '15##
+## 1.2.4 - Jan 27, '15
 - fixed a bug that results in invalid sepa file, if BIC is not provided for credit transfer (pain.001.003.03)
 
-##1.2.3 - Dec 18, '14##
+## 1.2.3 - Dec 18, '14
 - bugfix: removed the `require` in Sephpa.php. The directory linked there does not exist.
 - changed default file extension for SEPA files from xsd to xml. As everyone should name the files
 in a useful way, the default value will be removed in the future.
 
-##1.2.2 - Oct 19, '14##
+## 1.2.2 - Oct 19, '14
 - bugfix: refactoring caused a naming problem in sepa files
 - added unit tests which compare the outputs to bank-validated files
 
-##1.2.1 - Oct 18, '14##
+## 1.2.1 - Oct 18, '14
 - updated SepaUtilities: Sephpa 1.2.0 throws an exception if you entering a purpose (`purp`) 
 or a category purpose (`ctgypurp`) while `checkAndSanitize` is set to true.
 
-##1.2.0 - Oct 18, '14##
+## 1.2.0 - Oct 18, '14
 - Sephpa is now available via composer
 - Sephpa is now splitted up into `SephpaCreditTransfer` and `SephpaDirectDebit`
 - [SepaUtilities](https://github.com/AbcAeffchen/SepaUtilities) is now a project on its own
@@ -34,14 +78,14 @@ or a category purpose (`ctgypurp`) while `checkAndSanitize` is set to true.
 sanitize all inputs its self.
 - added `downloadSepaFile()` and `storeSepaFile()`
 
-##1.1.3 - Oct 9, '14##
+## 1.1.3 - Oct 9, '14
 - moved the `SEPA_PAIN_*` constants into the Sephpa class. Call them now as `Sephpa::SEPA_PAIN_`.
 - added support for alternative language specific character replacement. Use the 
 `SepaUtilities::FLAG_ALT_REPLACEMENT_*` constants.
 - added an autoloader to load required files dynamic.
 - added patterns to SepaUtilities that can be used in HTML5 pattern attribute
 
-##1.1.2 - Sep 27, '14##
+## 1.1.2 - Sep 27, '14
 - ~~added an autoloader to load required files dynamic.~~
 - ~~added patterns to SepaUtilities that can be used in HTML5 pattern attribute~~
 - added checkAndSanitize function to SepaUtilities
@@ -52,10 +96,10 @@ sanitize all inputs its self.
 server settings
 - updated readme + example.php
 
-##1.1.1 - Sep 18, '14##
+## 1.1.1 - Sep 18, '14
 - Fixed some bugs in SepaUtilities
 
-##1.1.0 - Sep 7, '14##
+## 1.1.0 - Sep 7, '14
 - Renamed the project to Sephpa
 - Renamed SepaXmlFile.php to Sephpa.php
 - runs on PHP 5.3, 5.4, 5.5 and 5.6
@@ -72,13 +116,13 @@ sanitize the input before handing it to Sephpa
 - Bug fixed: CtgyPurp tag (Category Purpose) was written with a lower case 'c'.
 
 
-##1.0.2 - May 3, '14##
+## 1.0.2 - May 3, '14
 - changed file encoding to utf-8
 
-##1.0.1 - Nov 10, '13##
+## 1.0.1 - Nov 10, '13
 - Bug fixed: remittance information was not added to direct debit files
 
-##1.0.0 - Sep 8, '13##
+## 1.0.0 - Sep 8, '13
 - First stable release
 - supports SEPA credit transfer (pain.001.002.03)
 - supports SEPA direct debit (pain.008.002.02)