https://github.com/phpexpertsinc/laravel57-env-polyfill

Backward compatible support for Laravel's pre-5.8 env() function.
https://github.com/phpexpertsinc/laravel57-env-polyfill

Last synced: about 5 hours ago
JSON representation

Backward compatible support for Laravel's pre-5.8 env() function.

• Host: GitHub
• URL: https://github.com/phpexpertsinc/laravel57-env-polyfill
• Owner: PHPExpertsInc
• License: other
• Created: 2019-05-09T06:01:35.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-13T07:03:53.000Z (3 months ago)
• Last Synced: 2024-11-16T23:06:35.086Z (about 13 hours ago)
• Language: PHP
• Homepage:
• Size: 31.3 KB
• Stars: 6
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Laravel 5.7 env() Polyfill

[![TravisCI](https://travis-ci.org/phpexpertsinc/Laravel57-env-polyfill.svg?branch=master)](https://travis-ci.org/phpexpertsinc/Laravel57-env-polyfill)

[![Test Coverage](https://api.codeclimate.com/v1/badges/4055759a290cbc797f5f/test_coverage)](https://codeclimate.com/github/phpexpertsinc/Laravel57-env-polyfill/test_coverage)

## Benefits

* Works with *any* package, even non-Laravel ones (it was my secondary reason)

* You no longer have to fear Laravel just going one day "Oops! We're not going to read from the environment anymore! Too bad!" on a non-major release.

## Backstory

With the introduction of Laravel 5.8, they broke the essential `env()` function 

by changing it from reading from/writing to environment variables to only using 

the global `$_SERVER` array, which is totally useless in console-based apps.

See  

 * https://github.com/laravel/framework/pull/27462

 * https://github.com/laravel/framework/issues/27828

 * https://github.com/laravel/framework/issues/27949

Therefore, I took it upon myself to create this polyfill to ensure that the pre-5.8

behaviors remain intact.

Additionally, this is a great little utility function to use outside of Laravel-specic

projects that also want to use the `env()` function.

It is specially configured with a `0.0.1` composer vendor and a `AAutoloadFirst` 

namespace, so that composer will always load it before it gets to Laravel. 

See https://github.com/composer/composer/issues/6768

The source code is lifted directly from the last version of Laravel 5.7.

As you can imagine, most of the copyright in this project belongs to 

Taylor Otwell, 2018.

It also includes 100% unit test code .

## Installation

Via Composer

```bash

composer require phpexperts/laravel-env-polyfill

```

## Usage

```php

putenv('foo=bar');

$foo = \env('foo'); // 'bar'

```

and

```php

if (in_array(SomeTrait::class, class_uses_recursive($this)) {

    // The class or its child it's being called from uses SomeTrait.

}

```

# Use cases

PHPExperts\Laravel57EnvPolyfill\Tests\Env  

 ✔ Env  

 ✔ Env with quotes  

 ✔ Env true  

 ✔ Env false  

 ✔ Env empty  

 ✔ Env null  

 ✔ Value  

 ✔ Env will use default value if needed  

 ✔ Will load vlucas/phpdot if a .env is present.  

 ✔ Will not load vlucas/phpdotenv if a .env is not present.

## Testing

```bash

phpunit

```

# Contributors

[Theodore R. Smith](https://www.phpexperts.pro/])   

GPG Fingerprint: 4BF8 2613 1C34 87AC D28F  2AD8 EB24 A91D D612 5690  

CEO: PHP Experts, Inc.

[Taylor Otwell](https://www.laravel.com/)

## License

MIT license. Please see the [license file](LICENSE) for more information.