spatie/7to5

Convert PHP 7 code to PHP 5 code

This package has been abandoned, _(*1)

We are not maintaining this package any more. Feel free to fork our code and maintain your own copy., _(*2)

Convert PHP 7.0 code to PHP 5 code

, _(*3)

This package can convert PHP 7.0 code to PHP 5. This can be handy when you are running PHP 7 in development, but PHP 5 in production., _(*4)

You can convert an entire directory with PHP 7.0 code with a the console command:, _(*5)

php7to5 convert {$directoryWithPHP7Code} {$destinationWithPHP5Code}

Here's an example of what it can do. It'll convert this code with PHP 7 features:, _(*6)

class Test
{
    public function test()
    {
        $class = new class() {
            public function method(string $parameter = '') : string {
                return $parameter ?? 'no parameter set';
            }
        };

        $class->method();

        $anotherClass = new class() {
            public function anotherMethod(int $integer) : int {
                return $integer > 3;
            }
        };
    }

}

to this equivalent PHP 5 code:, _(*7)

class AnonymousClass0
{
    public function method($parameter = '')
    {
        return isset($parameter) ? $parameter : 'no parameter set';
    }
}
class AnonymousClass1
{
    public function anotherMethod($integer)
    {
        return $integer < 3 ? -1 : ($integer == 3 ? 0 : 1);
    }
}
class Test
{
    public function test()
    {
        $class = new AnonymousClass0();
        $class->method();
        $anotherClass = new AnonymousClass1();
    }
}

Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website., _(*8)

Installation

If you plan on use the console command we recommend installing the package globally:, _(*9)

``` bash $ composer global require spatie/7to5, <sub>(*10)</sub>

If you want to [integrate the package in your own code](#programmatically-convert-files) require the package like usual:

``` bash
$ composer require spatie/7to5

The conversion process

This package converts PHP 7 code to equivalent PHP 5 code by:, <sub>(*11)</sub>

• removing scalar type hints
• removing return type hints
• removing the strict type declaration
• replacing the spaceship operator by an equivalent PHP 5 code
• replacing null coalesce statements by equivalent PHP 5 code
• replacing group use declarations by equivalent PHP 5 code
• replacing defined arrays by equivalent PHP 5 code
• converting anonymous classes to regular classes

Because there are a lot of things that cannot be detected and/or converted properly we do not guarantee that the converted code will work. We highly recommend running your automated tests against the converted code to determine if it works., <sub>(*12)</sub>

Using the console command

This package provides a console command php7to5 to convert files and directories., <sub>(*13)</sub>

This is how a entire directory can be converted:, <sub>(*14)</sub>

$ php7to5 convert {$directoryWithPHP7Code} {$destinationWithPHP5Code}

Want to convert a single file? That's cool too! You can use the same command., <sub>(*15)</sub>

$ php7to5 convert {$sourceFileWithPHP7Code} {$destinationFileWithPHP5Code}

By default the command will only copy over php-files. Want to copy over all files? Use the copy-all option:, <sub>(*16)</sub>

$ php7to5 convert {$directoryWithPHP7Code} {$destinationWithPHP5Code} --copy-all

By default the command will only convert files with a php extension, but you can customize that by using the --extension option., <sub>(*17)</sub>

$ php7to5 convert {$directoryWithPHP7Code} {$destinationWithPHP5Code} --extension=php --extension=phtml

If necessary, you can exclude directories / files., <sub>(*18)</sub>

$ php7to5 convert {$directoryWithPHP7Code} {$destinationWithPHP5Code} --exсlude=cache

Programmatically convert files

You can convert a single file by running this code:, <sub>(*19)</sub>

$converter = new Converter($pathToPhp7Code);

$converter->saveAsPhp5($pathToWherePhp5CodeShouldBeSaved);

An entire directory can be converted as well:, <sub>(*20)</sub>

$converter = new DirectoryConverter($sourceDirectory);

$converter->savePhp5FilesTo($destinationDirectory);

By default this will recursively copy all to files to the destination directory, even the non php files., <sub>(*21)</sub>

If you only want to copy over the php files do this:, <sub>(*22)</sub>

$converter = new DirectoryConverter($sourceDirectory);

$converter
   ->doNotCopyNonPhpFiles()
   ->savePhp5FilesTo($destinationDirectory);

Changelog

Please see CHANGELOG for more information what has changed recently., <sub>(*23)</sub>

Testing

bash $ composer test, <sub>(*24)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*25)</sub>

Security

If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker., <sub>(*26)</sub>

Postcardware

You'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., <sub>(*27)</sub>

Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium., <sub>(*28)</sub>

We publish all received postcards on our company website., <sub>(*29)</sub>

Credits

• Hannes Van De Vreken
• Freek Van der Herten
• All Contributors

Original idea: Jens Segers, <sub>(*30)</sub>

Support us

Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website., <sub>(*31)</sub>

Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff., <sub>(*32)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*33)</sub>