Sonstige Funktionen
PHP Manual

uniqid

(PHP 4, PHP 5)

uniqidErzeugt 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.


Sonstige Funktionen
PHP Manual