PhpSpreadsheet/docs/topics/migration-from-PHPExcel.md

# Migration from PHPExcel

PhpSpreadsheet introduced many breaking changes by introducing
namespaces and renaming some classes. To help you migrate existing
project, a tool was written to replace all references to PHPExcel
classes to their new names. But there are also manual changes that
need to be done.

## Automated tool

[RectorPHP](https://github.com/rectorphp/rector) can be used to migrate
automatically your codebase. Assuming your files to be migrated lives
in `src/`, you can run the migration like so:

``` sh
composer require rector/rector --dev
vendor/bin/rector process src --set phpexcel-to-phpspreadsheet
composer remove rector/rector
```

For more details, see
[RectorPHP blog post](https://getrector.org/blog/2020/04/16/how-to-migrate-from-phpexcel-to-phpspreadsheet-with-rector-in-30-minutes).
Introduce a tool to migrate from PHPExcel to PhpSpreadsheet 2016-11-27 15:11:16 +00:00			`# Migration from PHPExcel`

Wrap lines to 80 We wrapped lines to make easier the source easier to read, and to have more manageable diffs. This was done with something like: ```sh pandoc --wrap=auto --atx-headers -f markdown -t markdown-fenced_code_attributes+pipe_tables+raw_html+intraword_underscores` ``` 2016-12-03 15:00:54 +00:00			`PhpSpreadsheet introduced many breaking changes by introducing`
			`namespaces and renaming some classes. To help you migrate existing`
			`project, a tool was written to replace all references to PHPExcel`
Correct typo: "they are" -> "there are" (#725) 2018-10-21 07:28:39 +00:00			`classes to their new names. But there are also manual changes that`
Document readers/writeres short name changes Closes #253 2017-10-17 07:16:54 +00:00			`need to be done.`

			`## Automated tool`
Introduce a tool to migrate from PHPExcel to PhpSpreadsheet 2016-11-27 15:11:16 +00:00
Replace migration tool with RectorPHP Fixes #1445 2020-05-02 03:34:20 +00:00			`[RectorPHP](https://github.com/rectorphp/rector) can be used to migrate`
			`automatically your codebase. Assuming your files to be migrated lives`
			in `src/`, you can run the migration like so:
Introduce a tool to migrate from PHPExcel to PhpSpreadsheet 2016-11-27 15:11:16 +00:00
Wrap lines to 80 We wrapped lines to make easier the source easier to read, and to have more manageable diffs. This was done with something like: ```sh pandoc --wrap=auto --atx-headers -f markdown -t markdown-fenced_code_attributes+pipe_tables+raw_html+intraword_underscores` ``` 2016-12-03 15:00:54 +00:00			``` sh
Replace migration tool with RectorPHP Fixes #1445 2020-05-02 03:34:20 +00:00			`composer require rector/rector --dev`
			`vendor/bin/rector process src --set phpexcel-to-phpspreadsheet`
			`composer remove rector/rector`
Introduce a tool to migrate from PHPExcel to PhpSpreadsheet 2016-11-27 15:11:16 +00:00			```

Replace migration tool with RectorPHP Fixes #1445 2020-05-02 03:34:20 +00:00			`For more details, see`
			`[RectorPHP blog post](https://getrector.org/blog/2020/04/16/how-to-migrate-from-phpexcel-to-phpspreadsheet-with-rector-in-30-minutes).`