Submit a Pull Request Report a Bug

spl_autoload_extensions

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

spl_autoload_extensions — 注册并返回 spl_autoload 的默认文件扩展名

说明

spl_autoload_extensions(?string $file_extensions = null): string

本函数可以修改和检查 __autoload() 后备函数 spl_autoload() 将使用的扩展名。

注意: 在定义的文件扩展名之间不应该有空格。

参数

file_extensions: 如果为 null，只返回当前扩展名列表，每个扩展名用逗号分隔。要修改文件扩展名列表，只需在单个字符串中，用逗号分割的新文件扩展名列表调用此函数即可。

返回值

逗号分隔的 spl_autoload() 的默认文件扩展名。

更新日志

版本	说明
8.0.0	`file_extensions` 现在可以为 null。

示例

示例 #1 spl_autoload_extensions() 示例

<?php
spl_autoload_extensions(".php,.inc");
?>

＋add a note

User Contributed Notes 2 notes

down

dantedantas at gmail dot com ¶

6 years ago

The order of the extensions influence the velocity of the reply. For example: 

spl_autoload_extensions(".php, .inc");

is more fast than:

spl_autoload_extensions(".inc, .php");

Check out this example:

Some class files:

ClassA.php
<?php class ClassA { var $val = 'Hello from class "ClassA"'; } ?>
ClassB.php
<?php class ClassB { var $val = 'Hello from class "ClassB"'; } ?>
ClassC.php
<?php class ClassC { var $val = 'Hello from class "ClassC"'; } ?>
ClassD.php
<?php class ClassD { var $val = 'Hello from class "ClassD"'; } ?>
ClassE.php
<?php class ClassE { var $val = 'Hello from class "ClassE"'; } ?>

1. Simple:
<?php
// default priority: .inc .php
for($n=65; $n<70; $n++) {
    $className = 'Class'.chr($n);
    spl_autoload($className);
    $ins = new $className;
    echo $ins->val.'<br>';
}
// 4.2 miliseconds
?>

2. Change priority:
<?php
spl_autoload_extensions('.php,.inc');
// new priority: .php .inc
for($n=65; $n<70; $n++) {
    $className = 'Class'.chr($n);
    spl_autoload($className);
    $ins = new $className;
    echo $ins->val.'<br>';
}
// 1.4 miliseconds
?>

down

pim dot stoit at gmail dot com ¶

7 years ago

Extensions doesn't have to start with a dot, spl_autload() will simply append whatever you supply to the basename. The following example will try to load "test.php" first, and "test/index.php" as well:

spl_autoload_register('.php,/index.php');
spl_autoload('Test');

＋add a note