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` は、nullable になりました。

例

例1 spl_autoload_extensions() の例

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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

dantedantas at gmail dot com ¶

7 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 ¶

8 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