at-ease

at-ease is a PHP library that provides a safe alternative to PHP's @ error control operator. See the "Error handling" section on the PHP coding conventions page on why we don't use @. The code was originally introduced to MediaWiki in r4261, and then split out into a separate library during the MediaWiki 1.26 development cycle.

Usage

use Wikimedia\AtEase\AtEase;

// Suppress warnings in a block of code:
AtEase::suppressWarnings();
$content = file_get_contents( 'foobar.txt' );
AtEase::restoreWarnings();

// ..or in a callback function:
AtEase::quietCall( 'file_get_contents', 'foobar.txt' );

See also

• Error Control Operator, php.net

External links

• Source code (Phabricator mirror, GitHub mirror)
• README file
• Composer package
• API Documentation
• Test coverage report
• Issue tracker