at-ease

at-ease is a PHP library that provides a safe alternative to PHP's @ error control operator. From 2010 to 2020, it was recommended not to use @ in MediaWiki and extensions, but instead use this library. The code was originally introduced to MediaWiki in r4261, and then split out into a separate library during the MediaWiki 1.26 development cycle.

Since 2020 and the better support of fatal error handling in PHP 7, it is recommended to use @ in MediaWiki and extensions: see the "Error handling" section on the PHP coding conventions page.

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' );

Code stewardship

• Maintained by Performance Team .
• Live chat (IRC): #wikimedia-perf ^connect
• Issue tracker: Phabricator at-ease (Report an issue)

See also

• Error Control Operator, php.net

External links

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