Erzeugt eine eindeutige ID

Beschreibung

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

Gibt eine eindeutige ID mit Präfix zurück, die auf der aktuellen Zeit in Mikrosekunden basiert.

Parameter-Liste

prefix

Kann z.B. dann hilfreich sein, wenn Sie auf mehreren Hosts gleichzeitig IDs erzeugen, was im ungünstigsten Fall zur selben Mikrosekunde geschehen kann.

Bei leerem prefix ist die zurückgegebene Zeichenkette 13 Zeichen lang. Falls more_entropy TRUE ist, sind es 23 Zeichen.

more_entropy

Falls dieser Parameter auf TRUE gesetzt ist, wird uniqid() am Ende des Rückgabewertes zusätzliche mit dem Kongruenzgenerator für Pseudozufallszahlen (Combined Linear Congruential Generator) erzeugte Entropie anfügen, wodurch die Wahrscheinlichkeit erhöht wird, dass das Ergebnis eindeutig ist.

Rückgabewerte

Gibt eine eindeutige ID als Zeichenkette zurück.

Beispiele

Beispiel #1 uniqid()-Beispiel


<?php
/* Eine eindeutige ID, beispielsweise: 4b3403665fea6 */
$uniqid = uniqid();

/* Zusätzlich kann ein Präfix genutzt werden. Dabei sind die
 * folgenden beiden Anweisungen sind identisch:
 */
$uniqid = uniqid($prefix);
$uniqid = $prefix . uniqid();

/* Weiterhin kann der more_entropy Parameter aktiviert werden (auf einigen Systemen 
 * wie Cygwin ist dies sogar zwangsweise erforderlich). Dadurch generiert uniqid()
 * einen Wert ähnlich dem folgenden: 4b340550242239.64159797
 */
$uniqid = uniqid('', true);

Changelog

Version	Beschreibung
5.0.0	Den Parameter `prefix` optional gemacht
4.3.1	Das Limit von 114 Zeichen für `prefix` erhöht

Anmerkungen

Hinweis:
Unter Cygwin muss der Parameter more_entropy auf TRUE gesetzt sein, damit die Funktion arbeitet.