textdomain

(PHP 4, PHP 5, PHP 7, PHP 8)

textdomain — Sets the default domain

Description

function textdomain(?string $domain = null): string

This function sets the domain to search within when calls are made to gettext(), usually the named after an application.

Parameters

domain

The new message domain, or null to get the current setting without changing it

Return Values

If successful, this function returns the current message domain, after possibly changing it.

Errors/Exceptions

Throws a ValueError if domain is the empty string or longer than 1024 bytes.

Throws a ValueError if domain is "0".

Changelog

Version Description
8.4.0 Now throws a ValueError if domain is the empty string or "0". Previously, both returned the current message domain without changing it.
8.4.0 domain is optional now. Previously, the parameter always had to be specified.
8.0.0 Now throws a ValueError if an argument is too long. Previously, an E_WARNING was raised and false was returned.

Notes

Note:

The textdomain() information is maintained per process, not per thread.