Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ozdemirburak/json-csv

JSON to CSV and CSV to JSON converters in PHP.
https://github.com/ozdemirburak/json-csv

csv-converter csv2json csvtojson hacktoberfest json-converter json2csv jsontocsv php

Last synced: 2 days ago
JSON representation

JSON to CSV and CSV to JSON converters in PHP.

Host: GitHub
URL: https://github.com/ozdemirburak/json-csv
Owner: ozdemirburak
License: mit
Created: 2018-02-25T23:43:40.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2024-11-18T16:56:42.000Z (about 1 month ago)
Last Synced: 2024-12-13T20:51:26.530Z (9 days ago)
Topics: csv-converter, csv2json, csvtojson, hacktoberfest, json-converter, json2csv, jsontocsv, php
Language: PHP
Homepage:
Size: 122 KB
Stars: 36
Watchers: 2
Forks: 19
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

README

        # JSON to CSV and CSV to JSON Converter Library in PHP

[![Latest Version on Packagist][ico-version]][link-packagist]

[![Software License][ico-license]](LICENSE.md)

[![Build Status][ico-travis]][link-travis]

[![Total Downloads][ico-downloads]][link-downloads]

The most basic CSV to JSON and JSON to CSV converter library in PHP without any dependencies.

## Install

Via Composer

``` bash

$ composer require ozdemirburak/json-csv

```

## Usage

### JSON to CSV Converter

``` php

use OzdemirBurak\JsonCsv\File\Json;

// JSON to CSV

$json = new Json(__DIR__ . '/above.json');

// To convert JSON to CSV string

$csvString = $json->convert();

// To set a conversion option then convert JSON to CSV and save

$json->setConversionKey('utf8_encoding', true);

$json->convertAndSave(__DIR__ . '/above.csv');

// To convert JSON to CSV and force download on browser

$json->convertAndDownload();

```

You can also convert directly from a JSON string using the `fromString` method.

``` php

$csvString = (new Json())->fromString('{"name": "Buddha", "age": 80}')->convert();

```

Assume that the input JSON is something like below. 

```json

[

  {

    "name": {

      "common": "Turkey",

      "official": "Republic of Turkey",

      "native": "T\u00fcrkiye"

    },

    "area": 783562,

    "latlng": [39, 35]

  },

  {

    "name": {

      "common": "Israel",

      "official": "State of Israel",

      "native": "\u05d9\u05e9\u05e8\u05d0\u05dc"

    },

    "area": 20770,

    "latlng": [31.30, 34.45]

  }

]

```

After the conversion, the resulting CSV data will look like below.

**name\_common**|**name\_official**|**name\_native**|**area**|**latlng\_0**|**latlng\_1**

:-----:|:-----:|:-----:|:-----:|:-----:|:-----:

Turkey|Republic of Turkey|Türkiye|783562|39|35

Israel|State of Israel|ישראל|20770|31.3|34.45

### CSV to JSON Converter

``` php

use OzdemirBurak\JsonCsv\File\Csv;

// CSV to JSON

$csv = new Csv(__DIR__ . '/below.csv');

$csv->setConversionKey('options', JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE|JSON_UNESCAPED_SLASHES);

// To convert CSV to JSON string

$jsonString = $csv->convert();

// To convert CSV to JSON and save

$csv->convertAndSave(__DIR__ . '/below.json');

// To convert CSV to JSON and force download on browser

$csv->convertAndDownload();

```

You can also convert directly from a CSV string using the `fromString` method.

``` php

$jsonString = (new Csv())->fromString('[{"name":"Buddha","age":"80"}]')->convert();

```

Assume that the input CSV file is something like below. 

**SepalLength**|**SepalWidth**|**PetalLength**|**PetalWidth**|**Name**

:-----:|:-----:|:-----:|:-----:|:-----:

5.1|3.5|1.4|0.2|Iris-setosa                       

7.0|3.2|4.7|1.4|Iris-versicolor                   

6.3|3.3|6.0|2.5|Iris-virginica

After the conversion, the resulting JSON data will look like below.

```json

[

  {

    "SepalLength": "5.1",

    "SepalWidth": "3.5",

    "PetalLength": "1.4",

    "PetalWidth": "0.2",

    "Name": "Iris-setosa"

  },

  {

    "SepalLength": "7.0",

    "SepalWidth": "3.2",

    "PetalLength": "4.7",

    "PetalWidth": "1.4",

    "Name": "Iris-versicolor"

  },

  {

    "SepalLength": "6.3",

    "SepalWidth": "3.3",

    "PetalLength": "6.0",

    "PetalWidth": "2.5",

    "Name": "Iris-virginica"

  }

]

```

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash

$ composer test

```

## Known Issues

Currently, there are not any issues that are known.

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

## Credits

- [Burak Özdemir][link-author]

- [All Contributors][link-contributors]

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

[ico-version]: https://img.shields.io/packagist/v/ozdemirburak/json-csv.svg?style=flat-square

[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square

[ico-travis]: https://img.shields.io/travis/ozdemirburak/json-csv/master.svg?style=flat-square

[ico-downloads]: https://img.shields.io/packagist/dt/ozdemirburak/json-csv.svg?style=flat-square

[link-packagist]: https://packagist.org/packages/ozdemirburak/json-csv

[link-travis]: https://travis-ci.org/ozdemirburak/json-csv

[link-downloads]: https://packagist.org/packages/ozdemirburak/json-csv

[link-author]: https://github.com/ozdemirburak

[link-contributors]: ../../contributors