# Upgrading from the previous versions

## 1.4

### User visible changes

#### Decoder
- Empty string is considered invalid and JSON_ERROR_SYNTAX is raised
- Removed option `JSOND_VALID_ESCAPED_UNICODE`
  - The `JSON_ERROR_UTF16` will be always set for invalid \uXXXX code
  - PHP bug #62010
- Added new error `JSOND_ERROR_INVALID_PROPERTY_NAME` for invalid property names
  - The only case when the property is invalid is if it starts with `\0` character
  - PHP bug #68546
- Fixed compatibility with json ext for  `JSOND_ERROR_CTRL_CHAR`

#### Encoder
- Added depth checking for greater than 0 and lower than `INT_MAX`
  - PHP bug #72787
- Added JSOND_PRESERVE_ZERO_FRACTION option for better handling of float values
- Fixed blank line inside empty array/object when JSOND_PRETTY_PRINT is set
  - PHP bug #66021
- Fixed JSON_NUMERIC_CHECK issue with NaN and Inf double
  - PHP bug #64695

### Internal changes
- Added compatibility with PHP 7
- Used new UTF8 decoder based on automaton from Bjoern Hoehrmann
- Introduced new experimental buffer for encoding
  - Added a build option to enable it: `--enable-jsond-buffer-native`
- Added a possibility to switch prefix to json and replace existing json functions and constants
  - Added a build option to use json prefixing: `--enable-jsond-with-json-prefix`
- Use special template for Bison
  - Version 3.0.4 has to be used
- The parser and scanner is rebuilt only if enabled in configuration
  - Added a build option to rebuild it: `--enable-jsond-filegen`


## 1.3

### User visible changes

#### Decoder
- Rejected ECMA-404 incompatible number formats
  - top level (PHP json_decode check): `07`, `0xff`, `.1`, `-.1`
  - all (JSON_Parser): `[1.]`, [1.e1]
- Added new option `JSOND_VALID_ESCAPED_UNICODE` to check if \uXXXX code is not ill-formed surrogate pair
  - If set, the new error `JSON_ERROR_UTF16` will be set for invalid \uXXXX code

### Internal changes
- Removed JSON_parser.h header
- Removed utf8_decode.h header
- Error codes constants moved to php_json.h
- Renamed `enum error_codes` to `php_json_error_codes` (typedef)
- Changed ext global `error_code` type from `int` to `php_json_error_codes` enum
- Renamed macro JSON_PARSER_DEFAULT_DEPTH to PHP_JSON_PARSER_DEFAULT_DEPTH


## 1.2

Version 1.2 of jsond has never been released as it is a version of the json extension in PHP 5.