zalas / phpunit-globals
Allows to use attributes to define global variables in PHPUnit test cases.
Fund package maintenance!
jakzal
Installs: 233 648
Dependents: 8
Suggesters: 0
Security: 0
Stars: 39
Watchers: 3
Forks: 9
Open Issues: 0
Requires
- php: ~8.1.0 || ~8.2.0 || ~8.3.0
- phpunit/phpunit: ^10.0 || ^11.0
This package is auto-updated.
Last update: 2024-10-20 10:49:56 UTC
README
Allows to use attributes to define global variables in PHPUnit test cases.
Supported attributes:
#[Env]
for$_ENV
#[Server]
for$_SERVER
#[Putenv]
forputenv()
Supported annotations:
@env
and@unset-env
for$_ENV
@server
and@unset-server
for$_SERVER
@putenv
and@unset-getenv
forputenv()
Annotations are deprecated since v3.1.0 and will be removed in v3.4.0. The latest annotation support is planned to be removed is when PHPUnit 12 is released. Annotation support is complete, so if you plan on using them keep using v3.3 of this package.
Global variables are set before each test case is executed,
and brought to the original state after each test case has finished.
The same applies to putenv()
/getenv()
calls.
Installation
Composer
composer require --dev zalas/phpunit-globals
Phar
The extension is also distributed as a PHAR, which can be downloaded from the most recent Github Release.
Put the extension in your PHPUnit extensions directory.
Remember to instruct PHPUnit to load extensions in your phpunit.xml
using the extensionsDirectory
attribute:
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="file://./vendor/phpunit/phpunit/phpunit.xsd" extensionsDirectory="tools/phpunit.d" > </phpunit>
Usage
Enable the globals attribute extension in your PHPUnit configuration:
<?xml version="1.0" encoding="UTF-8"?> <phpunit ...> <!-- ... --> <extensions> <bootstrap class="Zalas\PHPUnit\Globals\AttributeExtension" /> </extensions> </phpunit>
If you are using a version before PHP 8.1 you can use the
AnnotationExtension
instead.
Make sure the AttributeExtension
is registered before any other extensions that might depend on global variables.
Global variables can now be defined in attributes:
use PHPUnit\Framework\TestCase; use Zalas\PHPUnit\Globals\Attribute\Env; use Zalas\PHPUnit\Globals\Attribute\Server; use Zalas\PHPUnit\Globals\Attribute\Putenv; #[Env('FOO', 'bar')] class ExampleTest extends TestCase { #[Env('APP_ENV', 'foo')] #[Env('APP_DEBUG', '0')] #[Server('APP_ENV', 'bar')] #[Server('APP_DEBUG', '1')] #[Putenv('APP_HOST', 'localhost')] public function test_global_variables() { $this->assertSame('bar', $_ENV['FOO']); $this->assertSame('foo', $_ENV['APP_ENV']); $this->assertSame('0', $_ENV['APP_DEBUG']); $this->assertSame('bar', $_SERVER['APP_ENV']); $this->assertSame('1', $_SERVER['APP_DEBUG']); $this->assertSame('localhost', \getenv('APP_HOST')); } }
It's also possible to mark an attribute with unset so it will not be present in any of the global variables:
use PHPUnit\Framework\TestCase; class ExampleTest extends TestCase { #[Env('APP_ENV', unset: true)] #[Server('APP_DEBUG', unset: true)] #[Putenv('APP_HOST', unset: true)] public function test_global_variables() { $this->assertArrayNotHasKey('APP_ENV', $_ENV); $this->assertArrayNotHasKey('APP_DEBUG', $_SERVER); $this->assertArrayNotHasKey('APP_HOST', \getenv()); } }
Updating to PHPUnit 10
When updating from a previous version of this extension dedicated to work with PHPUnit 9,
replace the extension registration in phpunit.xml
:
<extensions> <extension class="Zalas\PHPUnit\Globals\AttributeExtension" /> </extensions>
with:
<extensions> <bootstrap class="Zalas\PHPUnit\Globals\AttributeExtension" /> </extensions>
Contributing
Please read the Contributing guide to learn about contributing to this project. Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.