{"id":13405036,"url":"https://github.com/spatie/simple-excel","last_synced_at":"2025-05-13T15:11:52.152Z","repository":{"id":37432452,"uuid":"216833389","full_name":"spatie/simple-excel","owner":"spatie","description":"Read and write simple Excel and CSV files","archived":false,"fork":false,"pushed_at":"2025-02-14T12:48:29.000Z","size":345,"stargazers_count":1258,"open_issues_count":1,"forks_count":135,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-04-23T18:58:28.030Z","etag":null,"topics":["csv","excel","export","generator","import","lazycollection","read","write"],"latest_commit_sha":null,"homepage":"https://spatie.be/open-source","language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spatie.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"spatie"}},"created_at":"2019-10-22T14:24:39.000Z","updated_at":"2025-04-20T11:50:14.000Z","dependencies_parsed_at":"2023-02-13T23:40:21.799Z","dependency_job_id":"1ed0454a-8f9d-48ad-932c-d18a9738c16b","html_url":"https://github.com/spatie/simple-excel","commit_stats":{"total_commits":289,"total_committers":59,"mean_commits":4.898305084745763,"dds":0.5674740484429066,"last_synced_commit":"d98e66690ce3bcb7830d13729ab07391f866e793"},"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fsimple-excel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fsimple-excel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fsimple-excel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fsimple-excel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spatie","download_url":"https://codeload.github.com/spatie/simple-excel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969260,"owners_count":21992263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv","excel","export","generator","import","lazycollection","read","write"],"created_at":"2024-07-30T19:01:54.860Z","updated_at":"2025-05-13T15:11:47.131Z","avatar_url":"https://github.com/spatie.png","language":"PHP","funding_links":["https://github.com/sponsors/spatie"],"categories":["PHP"],"sub_categories":[],"readme":"# Read and write simple Excel and CSV files\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/spatie/simple-excel.svg?style=flat-square)](https://packagist.org/packages/spatie/simple-excel)\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/spatie/simple-excel/run-tests.yml?label=tests\u0026branch=main)\n[![Total Downloads](https://img.shields.io/packagist/dt/spatie/simple-excel.svg?style=flat-square)](https://packagist.org/packages/spatie/simple-excel)\n\nThis package allows you to easily read and write simple Excel and CSV files. Behind the scenes generators are used to ensure low memory usage, even when working with large files.\n\nHere's an example on how to read an Excel or CSV.\n\n```php\nuse Spatie\\SimpleExcel\\SimpleExcelReader;\n\nSimpleExcelReader::create($pathToFile)-\u003egetRows()\n   -\u003eeach(function(array $rowProperties) {\n        // process the row\n    });\n```\n\nIf `$pathToFile` ends with `.csv` a CSV file is assumed. If it ends with `.xlsx`, an Excel file is assumed.\n\n## Support us\n\n[\u003cimg src=\"https://github-ads.s3.eu-central-1.amazonaws.com/simple-excel.jpg?t=1\" width=\"419px\" /\u003e](https://spatie.be/github-ad-click/simple-excel)\n\nWe invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).\n\nWe highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).\n\n## Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require spatie/simple-excel\n```\n\n## Usage\n\n### Reading a CSV\n\nImagine you have a CSV with this content.\n\n```csv\nemail,first_name\njohn@example.com,john\njane@example.com,jane\n```\n\n```php\nuse Spatie\\SimpleExcel\\SimpleExcelReader;\n\n// $rows is an instance of Illuminate\\Support\\LazyCollection\n$rows = SimpleExcelReader::create($pathToCsv)-\u003egetRows();\n\n$rows-\u003eeach(function(array $rowProperties) {\n   // in the first pass $rowProperties will contain\n   // ['email' =\u003e 'john@example.com', 'first_name' =\u003e 'john']\n});\n```\n\n#### Reading an Excel file\n\nReading an Excel file is identical to reading a CSV file. Just make sure that the path given to the `create` method of `SimpleExcelReader` ends with `xlsx`.\n\n#### Working with LazyCollections\n\n`getRows` will return an instance of [`Illuminate\\Support\\LazyCollection`](https://laravel.com/docs/master/collections#lazy-collections). This class is part of the Laravel framework. Behind the scenes generators are used, so memory usage will be low, even for large files.\n\nYou'll find a list of methods you can use on a `LazyCollection` [in the Laravel documentation](https://laravel.com/docs/master/collections#the-enumerable-contract).\n\nHere's a quick, silly example where we only want to process rows that have a `first_name` that contains more than 5 characters.\n\n```php\nSimpleExcelReader::create($pathToCsv)-\u003egetRows()\n    -\u003efilter(function(array $rowProperties) {\n       return strlen($rowProperties['first_name']) \u003e 5;\n    })\n    -\u003eeach(function(array $rowProperties) {\n        // processing rows\n    });\n```\n\n#### Reading a file without headers\n\nIf the file you are reading does not contain a header row, then you should use the `noHeaderRow()` method.\n\n```php\n// $rows is an instance of Illuminate\\Support\\LazyCollection\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003enoHeaderRow()\n    -\u003egetRows()\n    -\u003eeach(function(array $rowProperties) {\n       // in the first pass $rowProperties will contain\n       // [0 =\u003e 'john@example', 1 =\u003e 'john']\n});\n```\n\n#### Manually setting the headers\n\nIf you would like to use a specific array of values for the headers, you can use the `useHeaders()` method.\n\n```php\n// $rows is an instance of Illuminate\\Support\\LazyCollection\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003euseHeaders(['email_address', 'given_name'])\n    -\u003egetRows()\n    -\u003eeach(function(array $rowProperties) {\n       // in the first pass $rowProperties will contain\n       // ['email_address' =\u003e 'john@example', 'given_name' =\u003e 'john']\n});\n```\n\nIf your file already contains a header row, it will be ignored and replaced with your custom headers.\n\nIf your file does not contain a header row, you should also use `noHeaderRow()`, and your headers will be used instead of numeric keys, as above.\n\n#### Working with multiple sheet documents\n\nExcel files can include multiple spreadsheets. You can select the sheet you want to use with the `fromSheet()` method to select by index.\n\n```php\n$rows = SimpleExcelReader::create($pathToXlsx)\n    -\u003efromSheet(3)\n    -\u003egetRows();\n```\n\nWith multiple spreadsheets, you can too select the sheet you want to use with the `fromSheetName()` method to select by name.\n\n```php\n$rows = SimpleExcelReader::create($pathToXlsx)\n    -\u003efromSheetName(\"sheet1\")\n    -\u003egetRows();\n```\n\nIf you want to check if a sheet exists, use the `hasSheet()` method.\n\n```php\n$hasSheet = SimpleExcelReader::create($pathToXlsx)\n    -\u003ehasSheet(\"sheet1\");\n```\n\n#### Retrieving header row values\n\nIf you would like to retrieve the header row as an array, you can use the `getHeaders()` method.\n\nIf you have used `useHeaders()` to set custom headers, these will be returned instead of the actual headers in the file. To get the original headers from the file, use `getOriginalHeaders()`.\n\n```php\n$headers = SimpleExcelReader::create($pathToCsv)-\u003egetHeaders();\n\n// $headers will contain\n// [ 'email', 'first_name' ]\n```\n\n#### Dealing with headers that are not on the first line\n\nIf your file has headers that are not on the first line, you can use the `headerOnRow()` method\nto indicate the line at which the headers are present. Any data above this line\nwill be discarded from the result.\n\n`headerOnRow` accepts the line number as an argument, starting at 0. Blank lines are not counted.\n\nSince blank lines will not be counted, this method is mostly useful for files\nthat include formatting above the actual dataset, which can be the case with Excel files.\n\n```csv\nThis is my data sheet\nSee worksheet 1 for the data, worksheet 2 for the graphs.\n\n\n\nemail , firstname\njohn@example.com,john\njane@example.com,jane\n```\n\n```php\n// $rows is an instance of Illuminate\\Support\\LazyCollection\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003etrimHeaderRow()\n    -\u003eheaderOnRow(3)\n    -\u003egetRows()\n    -\u003eeach(function(array $rowProperties) {\n       // in the first pass $rowProperties will contain\n       // ['email' =\u003e 'john@example', 'first_name' =\u003e 'john']\n});\n```\n\n#### Trimming headers\n\nIf the file you are reading contains a title row, but you need to trim additional characters on the title values, then you should use the `trimHeaderRow()` method.\nThis functionality mimics the `trim` method, and the default characters it trims, matches that function.\n\nImagine you have a csv file with this content.\n\n```csv\nemail , first_name\njohn@example.com,john\njane@example.com,jane\n```\n\n```php\n// $rows is an instance of Illuminate\\Support\\LazyCollection\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003etrimHeaderRow()\n    -\u003egetRows()\n    -\u003eeach(function(array $rowProperties) {\n       // in the first pass $rowProperties will contain\n       // ['email' =\u003e 'john@example', 'first_name' =\u003e 'john']\n});\n```\n\n`trimHeaderRow()` additionally accepts a param to specify what characters to trim. This param can utilize the same functionality allowed by the trim function's `$characters` definition including a range of characters.\n\n#### Convert headers to snake_case\n\nIf you would like all the headers to be converted to snake_case, use the the `headersToSnakeCase()` method.\n\n```csv\nEmail,First Name,Last Name\njohn@example.com,john,doe\nmary-jane@example.com,mary jane,doe\n```\n\n```php\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003eheadersToSnakeCase()\n    -\u003egetRows()\n    -\u003eeach(function(array $rowProperties) {\n        // rowProperties converted to snake_case\n        // ['email' =\u003e 'john@example', 'first_name' =\u003e 'John', 'last_name' =\u003e 'doe']\n    });\n```\n\n#### Manually formatting headers\n\nYou can use a custom formatter to change the headers using the `formatHeadersUsing` method and passing a closure.\n\n```csv\nemail,first_name,last_name\njohn@example.com,john,doe\nmary-jane@example.com,mary jane,doe\n```\n\n```php\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003eformatHeadersUsing(fn($header) =\u003e \"{$header}_simple_excel\")\n    -\u003egetRows()\n    -\u003eeach(function(array $rowProperties) {\n        // ['email_simple_excel' =\u003e 'john@example', 'first_name_simple_excel' =\u003e 'John', 'last_name_simple_excel' =\u003e 'doe']\n    });\n```\n\n#### Manually working with the reader object\n\nUnder the hood this package uses the [box/spout](https://github.com/openspout/openspout) package. You can get to the underlying reader that implements `\\OpenSpout\\Reader\\ReaderInterface` by calling the `getReader` method.\n\n```php\n$reader = SimpleExcelReader::create($pathToCsv)-\u003egetReader();\n```\n\n#### Limiting the result set\n\nThe `take` method allows you to specify a limit on how many rows should be returned.\n\n```php\n// $rows is an instance of Illuminate\\Support\\LazyCollection\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003etake(5)\n    -\u003egetRows();\n```\n\nThe `skip` method allows you to define which row to start reading data from. In this example we get rows 11 to 16.\n\n\n```php\n$rows = SimpleExcelReader::create($pathToCsv)\n    -\u003eskip(10)\n    -\u003etake(5)\n    -\u003egetRows();\n```\n\n#### Reading cells that contain formulas\n\nNormally, cells containing formulas are parsed and their computed value will be returned. If you want to keep the actual formula as a string, you can use the `keepFormulas` method.\n\n```php\n$rows = SimpleExcelReader::create($pathToXlsx)\n    -\u003ekeepFormulas()\n    -\u003egetRows();\n```\n\n#### Preserve date formatting\n\nBy default, when reading a spreadsheet with dates or times, the values are returned as `DateTimeImmutable` objects. To return a formatted date (e.g., “9/20/2024”) instead, use the `preserveDateTimeFormatting` method. The date format will match what’s specified in the spreadsheet.\n\n```php\n$rows = SimpleExcelReader::create($pathToXlsx)\n    -\u003epreserveDateTimeFormatting()\n    -\u003egetRows();\n```\n\n#### Preserve empty rows\n\nYou can preserve empty rows by using the `preserveEmptyRows` method.\n\n```php\n$rows = SimpleExcelReader::create($pathToXlsx)\n    -\u003epreserveEmptyRows()\n    -\u003egetRows();\n```\n\n### Writing files\n\nHere's how you can write a CSV file:\n\n```php\nuse Spatie\\SimpleExcel\\SimpleExcelWriter;\n\n$writer = SimpleExcelWriter::create($pathToCsv)\n     -\u003eaddRow([\n        'first_name' =\u003e 'John',\n        'last_name' =\u003e 'Doe',\n    ])\n    -\u003eaddRow([\n        'first_name' =\u003e 'Jane',\n        'last_name' =\u003e 'Doe',\n    ]);\n```\n\nThe file at `pathToCsv` will contain:\n\n```csv\nfirst_name,last_name\nJohn,Doe\nJane,Doe\n```\n\n#### Manually set the header from array\n\nInstead of letting the package automatically detect a header row, you can set it manually.\n\n```php\nuse Spatie\\SimpleExcel\\SimpleExcelWriter;\n\n$writer = SimpleExcelWriter::create($pathToCsv)\n    -\u003eaddHeader(['first_name', 'last_name'])\n    -\u003eaddRow(['John', 'Doe'])\n    -\u003eaddRow(['Jane', 'Doe'])\n```\n\n#### Writing an Excel file\n\nWriting an Excel file is identical to writing a csv. Just make sure that the path given to the `create` method of `SimpleExcelWriter` ends with `xlsx`.\nOne other thing to be aware of when writing an Excel file is that the file doesn't get written until the instance of `SimpleExcelWriter` is garbage collected.\nThat's when the `close` method is called. The `close` method is what finalizes writing the file to disk. If you need to access the file before the instance is garbage collected you will need to call the `close` method first.\n\n```php\n$writer-\u003eclose();\n```\n\n#### Streaming an Excel file to the browser\n\nInstead of writing a file to disk, you can stream it directly to the browser.\n\n```php\n$writer = SimpleExcelWriter::streamDownload('your-export.xlsx')\n     -\u003eaddRow([\n        'first_name' =\u003e 'John',\n        'last_name' =\u003e 'Doe',\n    ])\n    -\u003eaddRow([\n        'first_name' =\u003e 'Jane',\n        'last_name' =\u003e 'Doe',\n    ])\n    -\u003etoBrowser();\n```\n\nMake sure to call `flush()` if you're sending large streams to the browser\n\n```php\n$writer = SimpleExcelWriter::streamDownload('your-export.xlsx');\n\nforeach (range(1, 10_000) as $i) {\n    $writer-\u003eaddRow([\n        'first_name' =\u003e 'John',\n        'last_name' =\u003e 'Doe',\n    ]);\n\n    if ($i % 1000 === 0) {\n        flush(); // Flush the buffer every 1000 rows\n    }\n}\n\n$writer-\u003etoBrowser();\n```\n\nYou could also use a callback.\n\n```php\nuse Spatie\\SimpleExcel\\SimpleExcelWriter;\nuse OpenSpout\\Common\\Entity\\Row;\n\n$writer = SimpleExcelWriter::streamDownload('user-list.xlsx', function ($writerCallback, $downloadName) {\n\n    $writerCallback-\u003eopenToBrowser($downloadName);\n\n    $writerCallback-\u003eaddRow(Row::fromValues([\n        'first_name' =\u003e 'First Name',\n        'last_name' =\u003e 'Last Name',\n    ]));\n\n    $writerCallback-\u003eaddRow(Row::fromValues([\n        'first_name' =\u003e 'Rakib',\n        'last_name' =\u003e 'Hossain',\n    ]));\n\n    foreach (range(1, 10_000) as $i) {\n        $writerCallback-\u003eaddRow(Row::fromValues([\n            'first_name' =\u003e 'Rakib',\n            'last_name' =\u003e 'Hossain',\n        ]));\n\n        if ($i % 1000 === 0) {\n            flush();\n        }\n    }\n});\n\n$writer-\u003etoBrowser();\n```\n\n\n### Writing multiple rows at once\n\nYou can use `addRows` instead of `addRow` to add multiple rows at once.\n\n```php\n$writer = SimpleExcelWriter::streamDownload('your-export.xlsx')\n     -\u003eaddRows([\n        [\n            'first_name' =\u003e 'John',\n            'last_name' =\u003e 'Doe',\n        ],\n        [\n            'first_name' =\u003e 'Jane',\n            'last_name' =\u003e 'Doe',\n        ],\n    ]);\n```\n\n#### Writing a file without titles\n\nIf the file you are writing should not have a title row added automatically, then you should use the `noHeaderRow()` method.\n\n```php\n$writer = SimpleExcelWriter::create($pathToCsv)\n    -\u003enoHeaderRow()\n    -\u003eaddRow([\n        'first_name' =\u003e 'Jane',\n        'last_name' =\u003e 'Doe',\n    ]);\n```\n\nThis will output:\n\n```csv\nJane,Doe\n```\n\n#### Adding layout\n\nUnder the hood this package uses the [openspout/openspout](https://github.com/openspout/openspout) package. That package contains a `Style` builder that you can use to format rows. Styles can only be used on excel documents.\n\n```php\nuse OpenSpout\\Common\\Entity\\Style\\Color;\nuse OpenSpout\\Common\\Entity\\Style\\CellAlignment;\nuse OpenSpout\\Common\\Entity\\Style\\Style;\nuse OpenSpout\\Common\\Entity\\Style\\Border;\nuse OpenSpout\\Common\\Entity\\Style\\BorderPart;\n\n/* Create a border around a cell */\n$border = new Border(\n        new BorderPart(Border::BOTTOM, Color::LIGHT_BLUE, Border::WIDTH_THIN, Border::STYLE_SOLID),\n        new BorderPart(Border::LEFT, Color::LIGHT_BLUE, Border::WIDTH_THIN, Border::STYLE_SOLID),\n        new BorderPart(Border::RIGHT, Color::LIGHT_BLUE, Border::WIDTH_THIN, Border::STYLE_SOLID),\n        new BorderPart(Border::TOP, Color::LIGHT_BLUE, Border::WIDTH_THIN, Border::STYLE_SOLID)\n    );\n\n$style = (new Style())\n   -\u003esetFontBold()\n   -\u003esetFontSize(15)\n   -\u003esetFontColor(Color::BLUE)\n   -\u003esetShouldWrapText()\n   -\u003esetBackgroundColor(Color::YELLOW)\n   -\u003esetBorder($border);\n\n$writer-\u003eaddRow(['values', 'of', 'the', 'row'], $style);\n```\nTo style your HeaderRow simply call the `setHeaderStyle($style)` Method.\n\n```php\n$writer-\u003esetHeaderStyle($style);\n```\n\nFor more information on styles head over to [the Spout docs](https://github.com/openspout/openspout/tree/4.x/docs).\n\n#### Setting column widths and row heights\n\nBy accessing the underlying OpenSpout Writer you can set default column widths and row heights and change the width of specific columns.\n\n```php\nSimpleExcelWriter::create(\n    file: 'document.xlsx',\n    configureWriter: function ($writer) {\n        $options = $writer-\u003egetOptions();\n        $options-\u003eDEFAULT_COLUMN_WIDTH=25; // set default width\n        $options-\u003eDEFAULT_ROW_HEIGHT=15; // set default height\n        // set columns 1, 3 and 8 to width 40\n        $options-\u003esetColumnWidth(40, 1, 3, 8);\n        // set columns 9 through 12 to width 10\n        $options-\u003esetColumnWidthForRange(10, 9, 12);\n    }\n)\n```\n\n#### Creating an additional sheets\n\nBy default, the writer will write to the first sheet. If you want to write to an additional sheet, you can use the `addNewSheetAndMakeItCurrent` method.\n\n```php\n$writer = SimpleExcelWriter::create($pathToXlsx);\n\nPosts::all()-\u003eeach(function (Post $post) use ($writer) {\n    $writer-\u003enameCurrentSheet($post-\u003etitle);\n\n    $post-\u003ecomments-\u003eeach(function (Comment $comment) use ($writer) {\n        $writer-\u003eaddRow([\n            'comment' =\u003e $comment-\u003ecomment,\n            'author' =\u003e $comment-\u003eauthor,\n        ]);\n    });\n\n    if(!$post-\u003eis($posts-\u003elast())) {\n        $writer-\u003eaddNewSheetAndMakeItCurrent();\n    }\n});\n```\n\n#### Using an alternative delimiter\n\nBy default the `SimpleExcelReader` will assume that the delimiter is a `,`.\n\nThis is how you can use an alternative delimiter:\n\n```php\nSimpleExcelWriter::create($pathToCsv)-\u003euseDelimiter(';');\n```\n\n#### Getting the number of rows written\n\nYou can get the number of rows that are written. This number includes the automatically added header row.\n\n```php\n$writerWithAutomaticHeader = SimpleExcelWriter::create($this-\u003epathToCsv)\n    -\u003eaddRow([\n        'first_name' =\u003e 'John',\n        'last_name' =\u003e 'Doe',\n    ]);\n\n$writerWithAutomaticHeader-\u003egetNumberOfRows(); // returns 2\n```\n\n#### Disable BOM\n\nYou can also disable adding a BOM to the start of the file. BOM must be disabled on create and cannot be disabled after creation of the writer.\n\nA BOM, or byte order mark, indicates a number of things for the file being written including the file being unicode as well as it's UTF encoding type.\n\n```php\nSimpleExcelWriter::createWithoutBom($this-\u003epathToCsv, $type);\n```\n\nAdditional information about BOM can be found [here](https://en.wikipedia.org/wiki/Byte_order_mark).\n\n#### Manually working with the writer object\n\nUnder the hood this package uses the [openspout/openspout](https://github.com/openspout/openspout) package. You can get to the underlying writer that implements `\\OpenSpout\\Reader\\WriterInterface` by calling the `getWriter` method.\n\n```php\n$writer = SimpleExcelWriter::create($pathToCsv)-\u003egetWriter();\n```\n\n### Testing\n\n``` bash\ncomposer test\n```\n\n### Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.\n\n### Security\n\nIf you've found a bug regarding security please mail [security@spatie.be](mailto:security@spatie.be) instead of using the issue tracker.\n\n## Postcardware\n\nYou're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.\n\nOur address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium.\n\nWe publish all received postcards [on our company website](https://spatie.be/en/opensource/postcards).\n\n## Credits\n\n- [Freek Van der Herten](https://github.com/freekmurze)\n- [All Contributors](../../contributors)\n\n## Alternatives\n\n- [PhpSpreadsheet](https://phpspreadsheet.readthedocs.io/en/latest/)\n- [laravel-excel](https://laravel-excel.com)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspatie%2Fsimple-excel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspatie%2Fsimple-excel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspatie%2Fsimple-excel/lists"}