PHPackages                             lesphp/psr4-converter - 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. [PSR & Standards](/categories/psr-standards)
4. /
5. lesphp/psr4-converter

ActiveLibrary[PSR & Standards](/categories/psr-standards)

lesphp/psr4-converter
=====================

A tool to automatically converts PSR-0 and non-standard autoload to PSR-4.

0.5.1(2y ago)4957[1 issues](https://github.com/lesphp/psr4-converter/issues)MITPHPPHP ^8.1

Since Nov 8Pushed 2y ago2 watchersCompare

[ Source](https://github.com/lesphp/psr4-converter)[ Packagist](https://packagist.org/packages/lesphp/psr4-converter)[ RSS](/packages/lesphp-psr4-converter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (11)Used By (0)

PSR-4 Converter
===============

[](#psr-4-converter)

PSR-4 Converter is a tool to automate the conversion of PSR-0 or non-standard codes to PSR-4 compliance codes. To convert the php code (support codebase with PHP >= 5.0), this tool statically parses the code and then all the code is scanned to find the definitions that will be changed. Making legacy code compiler with PSR-4 involves more steps than renaming namespaces, this tool solves the following problems with this conversion:

1. Ensure that there is only one class per php file;
2. Possibility of converting names from PSR-0 to PSR-4, converting underscore to namespace;
3. Prefix existing namespaces with a vendor namespace;
4. Create class\_alias from the old class to the new one to ensure dynamic calls (class reference by variables);
5. Validation of invalid statements that cannot be converted in php files;
6. Creating include files with conditional functions and definitions to be included using composer.
7. Automatic generation of autoload file to load old classes, delivering the new class instead.
8. Possibility to ignore namespaces and directories.
9. Creation of a mapping json file, allowing to use it to automate other steps.
10. Rename all references from the old names to the new class and function names.
11. Rename all references in DocBlocks from the old names to the new class and function names.
12. Refactoring the imports to use the new converted names.
13. Risky conversion alert.
14. Checksum validation, allowing you to use pre-existing mapping files safely.

Instalation
-----------

[](#instalation)

You can install this library in several ways.

### composer

[](#composer)

1. Add the dependency to your `composer require lesphp/psr4-converter` project. It is recommended to install globally via the command `composer require --global lesphp/psr4-converter`.
2. Run the PSR-4 Converter via the command `php vendor/bin/psr4-converter help` or `psr4-converter help` if installed globally.

### Phive

[](#phive)

1. Install PSR-4 from phive with the command `phive install --force-accept-unsigned lesphp/psr4-converter`
2. Run PSR-4 Converter via `psr4-converter help` command.

Usage
-----

[](#usage)

### Mapping

[](#mapping)

The map command will generate a mapping json file containing all the information needed for the conversion, including all old and new name mappings.

```
psr4-converter map "App" /path/to/source -m /tmp/.psr4-converter.json --append-namespace --underscore-conversion --ignore-namespaced-underscore --ignore-path="ignored_relative_path"
```

For example the above command will generate the mapping file `/tmp/.psr4-converter.json` with all conversions to the `/path/to/source` directory, will also:

- Use the `App` vendor namespace for the new converted names, so a `\Old\Name` class will be `\App\Old\Name`;
- With the `--underscore-conversion` option an `Old_Name2` class will become `\App\Old\Name2`;
- With the option `--append-namespace` the vendor namespace `App` will always be added to the new name, without this option a class `\App\Old\Name3` would become `\App\Old\Name3`, with this option it will become `\App\App\Old\Name3`;
- With the `--ignore-namespaced-underscore` option underscores in old names will be kept for classes that are already namespaced, then a class `\Old\Name_Four` would become `\App\Old\Name_Four`.

Use the `psr4-converter map --help` command to get more details on the arguments and possibilities of the command.

### Converting

[](#converting)

Using the mapping file it is possible to convert the code to a new directory through the following command.

```
psr4-converter convert /tmp/.psr4-converter.json /path/to/destination -m /tmp/.psr4-converter2.json --ignore-vendor-path --create-aliases --allow-risky
```

It will convert the code mapped in `/tmp/.psr4-converter.json` to the `/path/to/destination` directory, will also:

- Definitions that need to be statically included by composer will be created in `/path/to/destination/includes` .
- With the `-m` option it is possible to add other mapping files to be used only to rename the classes mapped in the additional file, so the conversion will already have the new names of the additional mapping.
- With the option `--ignore-vendor-path` the vendor path will be ignored for generating the path of the converted file, so a class with new name `\App\New\Name` will be in `/path/to/destination/New/Name.php`, this is useful for doing psr-4 mappings in composer.json.
- With the `--create-aliases` option a file will be created in `/path/to/destination/includes/autoload.php`, that can be statically included in composer to autoload the old names, keeping compatibility for dynamic calls of the old names.
- With the `--allow-risky` option the tool will allow the conversion even if there is some risk mapped.

Use the `psr4-converter convert --help` command to get more details on the arguments and possibilities of the command.

### Renaming

[](#renaming)

Using the mapping file it is possible to rename the mapped references, so the old names will be converted to the new names. Use the rename command like this `psr4-converter rename /tmp/.psr4-converter.json /path/to/destination`. The convert command already renames the converted code, so the rename command is useful only to rename another already existent code.

Use the `psr4-converter rename --help` command to get more details on the arguments and possibilities of the command.

### Inspecting

[](#inspecting)

Using the mapping file it is possible to inspect the mapped changes. Use the inspect command like this `psr4-converter inspect /tmp/.psr4-converter.json`. Using the option `-o names-changes` is possible to get a json from changed names.

Use the `psr4-converter inspect --help` command to get more details on the arguments and possibilities of the command.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.4% 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.

###  Release Activity

Cadence

Every ~42 days

Total

10

Last Release

908d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/35bf43ea733f41fff08e0eb3a7f077219d4137846c236c49e6715cc96dc7c77e?d=identicon)[lainosantos](/maintainers/lainosantos)

---

Top Contributors

[![lainosantos](https://avatars.githubusercontent.com/u/8415575?v=4)](https://github.com/lainosantos "lainosantos (37 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (1 commits)")

---

Tags

convertautoloadnamespacePSR-4psr-0

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/lesphp-psr4-converter/health.svg)

```
[![Health](https://phpackages.com/badges/lesphp-psr4-converter/health.svg)](https://phpackages.com/packages/lesphp-psr4-converter)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

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