Page MenuHomePhabricator
Files F13309518

D11676.diff
No OneTemporary
Actions

D11676.diff
View Options

diff --git a/src/error/phlog.php b/src/error/phlog.php
--- a/src/error/phlog.php
+++ b/src/error/phlog.php
@@ -1,19 +1,17 @@
<?php
-
/**
* libphutil log function for development debugging. Takes any argument and
* forwards it to registered listeners. This is essentially a more powerful
- * version of ##error_log()##.
+ * version of `error_log()`.
*
- * @param wild Any value you want printed to the error log or other registered
- * logs/consoles.
- * @param ... Other values to be logged.
- * @return wild Passed $value.
+ * @param wild Any value you want printed to the error log or other registered
+ * logs/consoles.
+ * @param ... Other values to be logged.
+ * @return wild Passed $value.
*/
function phlog($value/* , ... */) {
-
- // Get the caller information
+ // Get the caller information.
$trace = debug_backtrace();
$metadata = array(
'file' => $trace[0]['file'],
@@ -33,31 +31,30 @@
return $value;
}
-
/**
* Example @{class:PhutilErrorHandler} error listener callback. When you call
- * ##PhutilErrorHandler::setErrorListener()##, you must pass a callback function
+ * `PhutilErrorHandler::setErrorListener()`, you must pass a callback function
* with the same signature as this one.
*
* NOTE: @{class:PhutilErrorHandler} handles writing messages to the error
* log, so you only need to provide a listener if you have some other console
* (like Phabricator's DarkConsole) which you //also// want to send errors to.
*
- * NOTE: You will receive errors which were silenced with the "@" operator. If
- * you don't want to display these, test for "@" being in effect by checking if
- * ##error_reporting() === 0## before displaying the error.
+ * NOTE: You will receive errors which were silenced with the `@` operator. If
+ * you don't want to display these, test for `@` being in effect by checking if
+ * `error_reporting() === 0` before displaying the error.
*
- * @param const A PhutilErrorHandler constant, like PhutilErrorHandler::ERROR,
- * which indicates the event type (e.g. error, exception,
- * user message).
- * @param wild The event value, like the Exception object for an exception
- * event, an error string for an error event, or some user object
- * for user messages.
- * @param dict A dictionary of metadata about the event. The keys 'file',
- * 'line' and 'trace' are always available. Other keys may be
- * present, depending on the event type.
+ * @param const A PhutilErrorHandler constant, like PhutilErrorHandler::ERROR,
+ * which indicates the event type (e.g. error, exception,
+ * user message).
+ * @param wild The event value, like the Exception object for an exception
+ * event, an error string for an error event, or some user object
+ * for user messages.
+ * @param dict A dictionary of metadata about the event. The keys 'file',
+ * 'line' and 'trace' are always available. Other keys may be
+ * present, depending on the event type.
* @return void
*/
function phutil_error_listener_example($event, $value, array $metadata) {
- throw new Exception('This is just an example function!');
+ throw new Exception(pht('This is just an example function!'));
}

File Metadata

Mime Type
text/plain
Expires
Tue, Jun 11, 10:18 AM (3 w, 1 d ago)
Storage Engine
blob
Storage Format
Encrypted (AES-256-CBC)
Storage Handle
6286895
Default Alt Text
D11676.diff (3 KB)

Event Timeline

Phabricator · Built by Phacility