PHPackages                             caseycs/catdoc-xls - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. caseycs/catdoc-xls

AbandonedArchivedLibrary[Parsing & Serialization](/categories/parsing)

caseycs/catdoc-xls
==================

PHP wrapper on catdoc util - xls files parser

36133[3 issues](https://github.com/caseycs/catdoc_xls/issues)Python

Since Mar 14Pushed 10y ago1 watchersCompare

[ Source](https://github.com/caseycs/catdoc_xls)[ Packagist](https://packagist.org/packages/caseycs/catdoc-xls)[ RSS](/packages/caseycs-catdoc-xls/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

catdoc\_xls
===========

[](#catdoc_xls)

[![Build Status](https://camo.githubusercontent.com/35836731c66e206425cbd02e707f431126c277292c414f81e7cdc4afbfd012d7/68747470733a2f2f7472617669732d63692e6f72672f636173657963732f636174646f635f786c732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/caseycs/catdoc_xls)

Excel files to PHP array convertor (xls/xlsx), wrapper on [catdoc](https://github.com/petewarden/catdoc), [xls2csv](https://pypi.python.org/pypi/xls2csv) (with few modifications) and [xlsx2csv](https://github.com/dilshod/xlsx2csv).

Dependencies should be already install: `xlsx2csv` can be installed via pip, `catdoc` is available by `apt-get`.

Usage example:
--------------

[](#usage-example)

```
$Parser = new \CatDocXls\Parser;
$result = $Parser->xls('path/to/file.xls');
print_r($result);

//some xsl files are not parsed via xls2csv binary correct, so you can try python script
$Parser = new \CatDocXls\Parser;
$result = $Parser->xls2('path/to/file.xls', 0);
print_r($result);

$Parser = new \CatDocXls\Parser;
$result = $Parser->xlsx('path/to/file.xlsx');
print_r($result);
```

See more examples in [ParserTest.php](test/CatDocXls/Test/ParserTest.php)

Known issues
------------

[](#known-issues)

- Empty lines are ignored - this is hardcoded in xls2csv, and `--ignoreempty` is always passed to xlsx2csv
- Empty sheets are also ignored
- Xls2cvs always output date and datetime fields as days count, so is is passed as is - you should convert them manually, see

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/41736c206f72612ed210fa7b5dce5e56d3b31c70c551bcde8c870ac19043a36c?d=identicon)[caseycs](/maintainers/caseycs)

---

Top Contributors

[![caseycs](https://avatars.githubusercontent.com/u/76095?v=4)](https://github.com/caseycs "caseycs (28 commits)")

### Embed Badge

![Health badge](/badges/caseycs-catdoc-xls/health.svg)

```
[![Health](https://phpackages.com/badges/caseycs-catdoc-xls/health.svg)](https://phpackages.com/packages/caseycs-catdoc-xls)
```

###  Alternatives

[mck89/peast

Peast is PHP library that generates AST for JavaScript code

19037.7M41](/packages/mck89-peast)[sauladam/shipment-tracker

Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access.

9642.0k](/packages/sauladam-shipment-tracker)[jstewmc/rtf

Read and write Rich Text Format (RTF) documents with PHP

46143.1k6](/packages/jstewmc-rtf)[moonshine/layouts-field

Field for repeating groups of fields for MoonShine

107.9k](/packages/moonshine-layouts-field)[tcds-io/php-jackson

A lightweight, flexible object serializer for PHP, inspired by FasterXML/jackson

112.9k10](/packages/tcds-io-php-jackson)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)