PHP给pdf添加多行水印+PHP，pdf+PHP添加水印

PHPUnit Polyfills ===================================================== [](//packagist.org/packages/yoast/phpunit-polyfills) [](https://github.com/Yoast/PHPUnit-Polyfills/actions/workflows/cs.yml) [](https://github.com/Yoast/PHPUnit-Polyfills/actions/workflows/lint.yml) [](https://github.com/Yoast/PHPUnit-Polyfills/actions/workflows/test.yml) [](https://packagist.org/packages/yoast/phpunit-polyfills) [](https://github.com/Yoast/PHPUnit-Polyfills/blob/master/LICENSE) Set of polyfills for changed PHPUnit functionality to allow for creating PHPUnit cross-version compatible tests. * [Requirements](#requirements) * [Installation](#installation) * [Why use the PHPUnit Polyfills?](#why-use-the-phpunit-polyfills) * [Using this library](#using-this-library) * [Features](#features) - [Polyfill traits](#polyfill-traits) - [Helper traits](#helper-traits) - [TestCases](#testcases) - [TestListener](#testlistener) * [Frequently Asked Questions](#frequently-asked-questions) * [Contributing](#contributing) * [License](#license) Requirements ------------ * PHP 5.4 or higher. * [PHPUnit] 4.8 - 9.x (automatically required via Composer). [PHPUnit]: https://packagist.org/packages/phpunit/phpunit Installation ------------ To install this package, run: ```bash composer require --dev yoast/phpunit-polyfills ``` To update this package, run: ```bash composer update --dev yoast/phpunit-polyfills --with-dependencies ``` Make sure to either use the Composer `vendor/autoload.php` file _as_ your test bootstrap file; òr require the `vendor/yoast/phpunit-polyfills/phpunitpolyfills-autoload.php` file _in_ your test bootstrap. Why use the PHPUnit Polyfills? ------------------------------ This library is set up to allow for creating PHPUnit cross-version compatible tests by offering a number of polyfills for functionality which was introduced, split up or renamed in PHPUnit. ### Write your tests for PHPUnit 9.x and run them on PHPUnit 4.8 - 9.x The polyfills have been setup to allow tests to be _forward_-compatible. What that means is, that your tests can use the assertions supported by the _latest_ PHPUnit version, even when running on older PHPUnit versions. This puts the burden of upgrading to use the syntax of newer PHPUnit versions at the point when you want to _start_ running your tests on a newer version. By doing so, dropping support for an older PHPUnit version becomes as straight-forward as removing it from the version constraint in your `composer.json` file. Using this library ------------------ Each of the polyfills and helpers has been setup as a trait and can be imported and `use`d in any test file which extends the PHPUnit native `TestCase` class. If the polyfill is not needed for the particular PHPUnit version on which the tests are being run, the autoloader will automatically load an empty trait with that same name, so you can safely use these traits in tests which need to be PHPUnit cross-version compatible. ```php <?php namespace Vendor\YourPackage\Tests; use PHPUnit\Framework\TestCase; use Yoast\PHPUnitPolyfills\Polyfills\AssertIsType; class FooTest extends TestCase { use AssertIsType; public function testSomething() { $this->assertIsBool( $maybeBool ); self::assertIsNotIterable( $maybeIterable ); } } ``` Alternatively, you can use one of the [`TestCase` classes](#testcases) provided by this library instead of using the PHPUnit native `TestCase` class. In that case, all polyfills and helpers will be available whenever needed. ```php <?php namespace Vendor\YourPackage\Tests; use Yoast\PHPUnitPolyfills\TestCases\TestCase; class FooTest extends TestCase { public function testSomething() { $this->assertIsBool( $maybeBool ); self::assertMatchesRegularExpression( $pattern, $string, $message ); } } ``` ### Supported ways of calling the assertions By default, PHPUnit supports [four ways of calling assertions]: 1. **As a method in the `TestCase` class - `$this->assertSomething()`.** 2. **Statically as a method in the `TestCase` class - `self/static/parent::assertSomething()`.** 3. Statically as a method of the `Assert` class - `Assert::assertSomething()`. 4. As a global function - `assertSomething()`. The polyfills in this library support the first two ways of calling the assertions as those are the most commonly used type of assertion calls. For the polyfills to work, a test class is **required** to be a (grand-)child of the PHPUnit native `TestCase` class. [four ways of calling assertions]: https://phpunit.readthedocs.io/en/stable/assertions.html#static-vs-non-static-usage-of-assertion-methods ### Use with PHPUnit < 5.7.0 If your library still needs to support PHP < 5.6 and therefore needs PHPUnit 4 for testing, there are a few caveats when using the traits stand-alone as we then enter "double-polyfill" territory. To prevent _"conflicting method names"_ errors when a trait is `use`d multiple times in a class, the traits offered here do not attempt to solve this. You will need to make sure to `use` any additional traits needed for the polyfills to work. | PHPUnit | When `use`-ing this trait | You also need to `use` this trait | |-----------|---------------------------------|-----------------------------------| | 4.8 < 5.2 | `ExpectExceptionObject` | `ExpectException` | | 4.8 < 5.2 | `ExpectPHPException` | `ExpectException` | | 4.8 < 5.2 | `ExpectExceptionMessageMatches` | `ExpectException` | | 4.8 < 5.6 | `AssertionRenames` | `AssertFileDirectory` | _**Note: this only applies to the stand-alone use of the traits. The [`TestCase` classes](#testcases) provided by this library already take care of this automatically.**_ Code example testing for a PHP native warning in a test which needs to be able to run on PHPUnit 4.8: ```php <?php namespace Vendor\YourPackage\Tests; use PHPUnit\Framework\TestCase; use Yoast\PHPUnitPolyfills\Polyfills\ExpectException; use Yoast\PHPUnitPolyfills\Polyfills\ExpectPHPException; class FooTest extends TestCase { use ExpectException; use ExpectPHPException; public function testSomething() { $this->expectWarningMessage( 'A non-numeric value encountered' ); } } ``` Features -------- ### Polyfill traits #### PHPUnit < 5.0.0: `Yoast\PHPUnitPolyfills\Polyfills\AssertNumericType` Polyfills the following methods: | | | | |----------------------------|------------------------------|-------------------------| | [`Assert::assertFinite()`] | [`Assert::assertInfinite()`] | [`Assert::assertNan()`] | These methods were introduced in PHPUnit 5.0.0. [`Assert::assertFinite()`]: https://phpunit.readthedocs.io/en/stable/assertions.html#assertinfinite [`Assert::assertInfinite()`]: https://phpunit.readthedocs.io/en/stable/assertions.html#assertinfinite [`Assert::assertNan()`]: https://phpunit.readthedocs.io/en/stable/assertions.html#assertnan #### PHPUnit < 5.2.0: `Yoast\PHPUnitPolyfills\Polyfills\ExpectException` Polyfills the following methods: | | | |-------------------------------------|----------------------------------------------| | [`TestCase::expectException()`] | [`TestCase::expectExceptionMessage()`]