uniqid

FunctionParams and return types changed in PHP 8.0

Generate a time-based identifier.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

uniqid Function synopsis

uniqid(string $prefix = "", bool $more_entropy = false): string

Parameters

$prefix

OptionalTypestringDefault value""

Can be useful, for instance, if you generate identifiers simultaneously on several hosts that could generate the same identifier at the same microsecond. (This can happen even on a single host if the system clock is moved backwards, such as by an NTP adjustment.)

$more_entropy

OptionalTypeboolDefault valuefalse

If set to true, uniqid will add additional entropy (using the combined linear congruential generator) at the end of the return value, which increases the likelihood that the result will be unique.

Return value

Typestring

Returns timestamp based identifier as a string.

 This function does not guarantee the uniqueness of the return value.

Changes to the uniqid Function

PHP 8.0

  • Return type added: string
  • Parameter type added for parameter #1 ($prefix): string
  • Parameter default value added for position #1 ($prefix): ""
  • Parameter type added for parameter #2 ($more_entropy): bool
  • Parameter default value added for position #2 ($more_entropy): false
- uniqid($prefix, $more_entropy)
+ uniqid(string $prefix = "", bool $more_entropy = false): string

uniqid Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes