Download the PHP package aternos/almost-json without Composer
On this page you can find all versions of the php package aternos/almost-json. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aternos/almost-json
More information about aternos/almost-json
Files in aternos/almost-json
Package almost-json
Short Description Parse all those weird things that should be JSON but someone decided to add weird quirks
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package almost-json
aternos/almost-json
A library to parse all those things that are kind of JSON but not quite.
Why?
Over the years, many accidentally or intentionally broken JSON parsers have emerged.
If a software uses such a parser, users of that software might start writing broken JSON
that is accepted by that parser, but not actually valid.
This makes writing code that deals with files originally created for such software very
annoying, since some files will just randomly not work with a standard JSON parser because
someone decided that wrapping a string in quotes was just way too much work for them.
This library aims to correctly parse normal JSON, while also accommodating as many weird quirks as possible.
Supported JSON quirks
When parsing valid JSON, this library should return the exact same result as PHP's built-in
json_decode function. Additionally, the following quirks are supported:
- Line comments (
//and#) - Block comments (
/* ... */) - Objects
- Unquoted keys
- Missing or additional commas
- Implicit close at end of input
- Arrays
- Missing or additional commas
- Implicit close at end of input
- Strings
- Single quotes (
') instead of double quotes (") - Backticks (
`) instead of double quotes (") - Unquoted strings
- Escape sequences
\vand\0 - Ignore invalid escape sequences (e.g.
\a=>a) - Line continuation (
\at the end of a line) - Literal newlines
- Single quotes (
- Numbers
- Hexadecimal numbers (
0x...) - Binary numbers (
0b...) - Octal numbers (
0o...) - Octal numbers with only
0as prefix (0...) (not enabled by default) - Allow leading zeros (e.g.
0123) for decimal numbers if octal numbers are enabled - Exponential notation with
eorE - Underscores in numbers (e.g.
1_000_000) - Decimal numbers with a trailing dot (e.g.
1.) - Decimal numbers with a leading dot (e.g.
.1) - Float values
NaN,Infinity, and-Infinity
- Hexadecimal numbers (
- Case-insensitive boolean values
- Case-insensitive null
- Ignore additional data after end of root node
Usage
Installation
Parsing
By default, the parser will assume the string is encoded as UTF-8. To use a different encoding
you can call the parse method, which accepts an Input object instead of a string.
To automatically detect the correct encoding, you can pass the result of the mb_detect_encoding function.
Options
There are a number of options that can be set for a parser instance.
Performance
This library is almost certainly significantly slower than PHP's built-in JSON implementation. If performance is critical, and most files are expected to be valid JSON, it might make sense to first try to use the built-in JSON parser, and only fall back to this library if it fails.
