WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

spl_autoload_register()

Registriert einen Loader für unbekannte Klassennamen ohne führenden Rückwärtsschrägstrich.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

spl_autoload_register(?callable $callback = null, bool $throw = true, bool $prepend = false): bool

Registriert einen Loader für unbekannte Klassennamen ohne führenden Rückwärtsschrägstrich. PHP versucht die Loader in Reihenfolge ihrer Registrierung, bis die Klasse definiert ist. prepend stellt den neuen Loader an den Anfang. Ein Rückgabewert definiert keine Klasse. Seit PHP 8 wird throw=false mit E_NOTICE ignoriert. Eine Exception aus einem Loader unterbricht die Kette.

Signatur

spl_autoload_register(?callable $callback = null, bool $throw = true, bool $prepend = false): bool

Ausgabe des Beispiels

[false,true]
notice
stop false

Beispiele

<?php
class LocalBadge {}
$loader=function($name) { if ($name==="RemoteBadge") { class_alias(LocalBadge::class,$name); } };
spl_autoload_register($loader);
echo json_encode([class_exists("RemoteBadge",false),new RemoteBadge() instanceof LocalBadge]);
spl_autoload_unregister($loader);
$called=false; set_error_handler(function($level){ echo "\n",($level===E_NOTICE ? "notice" : "unexpected"); return true; });
spl_autoload_register(function($name){throw new RuntimeException("stop");},false); restore_error_handler();
spl_autoload_register(function($name) use (&$called) { $called=true; });
try {class_exists("NotYetLoaded");} catch (RuntimeException $e) {echo "\n",$e->getMessage()," ",json_encode($called); }

Ergebnis

[false,true]
notice
stop false

Quellen