Message
class Message implements Stringable (View source)
a single message
simple usage examples:
// display simple error message 'Error'
echo Message::error()->getDisplay();
// get simple success message 'Success'
$message = Message::success();
// get special notice
$message = Message::notice(__('This is a localized notice'));more advanced usage example:
// create another message, a hint, with a localized string which expects
$hint = Message::notice('Read the %smanual%s');
// replace placeholders with the following params
$hint->addParam('[doc@cfg_Example]');
$hint->addParam('[/doc]');
// add this hint as a tooltip
$hint = showHint($hint);
// add the retrieved tooltip reference to the original message
$message->addMessage($hint);Constants
| SUCCESS |
|
| NOTICE |
|
| ERROR |
|
Properties
| protected string | $string | The locale string identifier |
|
| protected string | $message | The formatted message |
|
| protected bool | $isDisplayed | Whether the message was already displayed |
|
| protected bool | $useBBCode | Whether to use BB code when displaying. |
|
| protected string|null | $hash | Unique id |
|
| protected array | $params | holds parameters |
|
| protected (string|Message)[] | $addedMessages | holds additional messages |
Methods
No description
magic method: return string representation for this object
get Message for type of affected rows
get Message for type of deleted rows
get Message for type of inserted rows
get Message of type success with custom content
No description
No description
No description
Set whether we should use BB Code when rendering.
set raw message (overrides string)
set string (does not take effect if raw message is set)
set message type type
add string or Message parameter
add parameter as raw HTML, usually in conjunction with strings
add a bunch of messages at once
add a bunch of messages at once
add another raw message to be concatenated on displaying
add another raw message to be concatenated on displaying
add another html message to be concatenated on displaying
set all params at once, usually used in conjunction with string
return all parameters
return all added messages
returns unique Message::$hash, if not exists it will be created
returns compiled message
Returns only message string without image & other HTML.
returns Message::$string
returns level of message
No description
returns HTML code for displaying this message
sets and returns whether the message was displayed or not
Returns the message with corresponding image icon
Details
__construct(string $string = '', int $type = self::NOTICE, array $params = [])
No description
string
__toString()
magic method: return string representation for this object
static Message
success(string $string = '')
get Message of type success
shorthand for getting a simple success message
static Message
error(string $string = '')
get Message of type error
shorthand for getting a simple error message
static Message
notice(string $string)
get Message of type notice
shorthand for getting a simple notice message
static Message
raw(string $message, int $type = self::NOTICE)
get Message with customized content
shorthand for getting a customized message
static Message
getMessageForAffectedRows(int $rows)
get Message for type of affected rows
shorthand for getting a customized message
static Message
getMessageForDeletedRows(int $rows)
get Message for type of deleted rows
shorthand for getting a customized message
static Message
getMessageForInsertedRows(int $rows)
get Message for type of inserted rows
shorthand for getting a customized message
static Message
rawError(string $message)
get Message of type error with custom content
shorthand for getting a customized error message
static Message
rawNotice(string $message)
get Message of type notice with custom content
shorthand for getting a customized notice message
static Message
rawSuccess(string $message)
get Message of type success with custom content
shorthand for getting a customized success message
bool
isSuccess()
No description
bool
isNotice()
No description
bool
isError()
No description
void
setBBCode(bool $useBBCode)
Set whether we should use BB Code when rendering.
void
setMessage(string $message)
set raw message (overrides string)
void
setString(string $string)
set string (does not take effect if raw message is set)
void
setType(int $type)
set message type type
void
addParam(mixed $param)
add string or Message parameter
usage
$message->addParam('[em]some string[/em]');
void
addParamHtml(string $param)
add parameter as raw HTML, usually in conjunction with strings
usage
$message->addParamHtml('<img src="img">');
void
addMessages(array $messages, string $separator = ' ')
add a bunch of messages at once
void
addMessagesString(array $messages, string $separator = ' ')
add a bunch of messages at once
void
addMessage(Message $message, string $separator = ' ')
add another raw message to be concatenated on displaying
void
addText(string $message, string $separator = ' ')
add another raw message to be concatenated on displaying
void
addHtml(string $message, string $separator = ' ')
add another html message to be concatenated on displaying
void
setParams(array $params)
set all params at once, usually used in conjunction with string
array
getParams()
return all parameters
array
getAddedMessages()
return all added messages
string
getHash()
returns unique Message::$hash, if not exists it will be created
string
getMessage()
returns compiled message
string
getOnlyMessage()
Returns only message string without image & other HTML.
string
getString()
returns Message::$string
string
getLevel()
returns level of message
string
getContext()
No description
string
getDisplay()
returns HTML code for displaying this message
bool
isDisplayed(bool $isDisplayed = false)
sets and returns whether the message was displayed or not
string
getMessageWithIcon(string $message)
Returns the message with corresponding image icon