SPL_AUTOLOAD_REGISTER(3) 1 SPL_AUTOLOAD_REGISTER(3)spl_autoload_register - Register given function as __autoload() implementationSYNOPSIS
bool spl_autoload_register ([callable $autoload_function], [bool $throw = true], [bool $prepend = false])
DESCRIPTION
Register a function with the spl provided __autoload queue. If the queue is not yet activated it will be activated.
If your code has an existing __autoload(3) function then this function must be explicitly registered on the __autoload queue. This is
because spl_autoload_register(3) will effectively replace the engine cache for the __autoload(3) function by either spl_autoload(3) or
spl_autoload_call(3).
If there must be multiple autoload functions, spl_autoload_register(3) allows for this. It effectively creates a queue of autoload func-
tions, and runs through each of them in the order they are defined. By contrast, __autoload(3) may only be defined once.
PARAMETERS
o $autoload_function
- The autoload function being registered. If no parameter is provided, then the default implementation of spl_autoload(3) will be
registered.
o $throw
- This parameter specifies whether spl_autoload_register(3) should throw exceptions when the $autoload_function cannot be regis-
tered.
o $prepend
- If true, spl_autoload_register(3) will prepend the autoloader on the autoload queue instead of appending it.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
CHANGELOG
+--------+-------------------------------------+
|Version | |
| | |
| | Description |
| | |
+--------+-------------------------------------+
| 5.3.0 | |
| | |
| | Namespaces support was introduced. |
| | |
| 5.3.0 | |
| | |
| | The $prepend parameter was added. |
| | |
+--------+-------------------------------------+
EXAMPLES
Example #1
spl_autoload_register(3) as a replacement for an __autoload(3) function
<?php
// function __autoload($class) {
// include 'classes/' . $class . '.class.php';
// }
function my_autoloader($class) {
include 'classes/' . $class . '.class.php';
}
spl_autoload_register('my_autoloader');
// Or, using an anonymous function as of PHP 5.3.0
spl_autoload_register(function ($class) {
include 'classes/' . $class . '.class.php';
});
?>
Example #2
spl_autoload_register(3) example where the class is not loaded
<?php
namespace Foobar;
class Foo {
static public function test($name) {
print '[['. $name .']]';
}
}
spl_autoload_register(__NAMESPACE__ .'Foo::test'); // As of PHP 5.3.0
new InexistentClass;
?>
The above example will output something similar to:
[[FoobarInexistentClass]]
Fatal error: Class 'FoobarInexistentClass' not found in ...
SEE ALSO __autoload(3).
PHP Documentation Group SPL_AUTOLOAD_REGISTER(3)
Check Out this Related Man Page
VAR_EXPORT(3) 1 VAR_EXPORT(3)var_export - Outputs or returns a parsable string representation of a variableSYNOPSIS
mixed var_export (mixed $expression, [bool $return = false])
DESCRIPTION var_export(3) gets structured information about the given variable. It is similar to var_dump(3) with one exception: the returned represen-
tation is valid PHP code.
PARAMETERS
o $expression
- The variable you want to export.
o $return
- If used and set to TRUE, var_export(3) will return the variable representation instead of outputting it.
RETURN VALUES
Returns the variable representation when the $return parameter is used and evaluates to TRUE. Otherwise, this function will return NULL.
NOTES
Note
When the $return parameter is used, this function uses internal output buffering so it cannot be used inside an ob_start(3) callback
function.
CHANGELOG
+--------+---------------------------------------------------+
|Version | |
| | |
| | Description |
| | |
+--------+---------------------------------------------------+
| 5.1.0 | |
| | |
| | Possibility to export classes and arrays con- |
| | taining classes using the __set_state() magic |
| | method. |
| | |
+--------+---------------------------------------------------+
EXAMPLES
Example #1
var_export(3) Examples
<?php
$a = array (1, 2, array ("a", "b", "c"));
var_export($a);
?>
The above example will output:
array (
0 => 1,
1 => 2,
2 =>
array (
0 => 'a',
1 => 'b',
2 => 'c',
),
)
<?php
$b = 3.1;
$v = var_export($b, true);
echo $v;
?>
The above example will output:
3.1
Example #2
Exporting classes since PHP 5.1.0
<?php
class A { public $var; }
$a = new A;
$a->var = 5;
var_export($a);
?>
The above example will output:
A::__set_state(array(
'var' => 5,
))
Example #3
Using __set_state() (since PHP 5.1.0)
<?php
class A
{
public $var1;
public $var2;
public static function __set_state($an_array)
{
$obj = new A;
$obj->var1 = $an_array['var1'];
$obj->var2 = $an_array['var2'];
return $obj;
}
}
$a = new A;
$a->var1 = 5;
$a->var2 = 'foo';
eval('$b = ' . var_export($a, true) . ';'); // $b = A::__set_state(array(
// 'var1' => 5,
// 'var2' => 'foo',
// ));
var_dump($b);
?>
The above example will output:
object(A)#2 (2) {
["var1"]=>
int(5)
["var2"]=>
string(3) "foo"
}
NOTES
Note
Variables of type resource couldn't be exported by this function.
Note
var_export(3) does not handle circular references as it would be close to impossible to generate parsable PHP code for that. If you
want to do something with the full representation of an array or object, use serialize(3).
Warning
When var_export(3) exports objects, the leading backslash is not included in the class name of namespaced classes for maximum com-
patibility.
SEE ALSO print_r(3), serialize(3), var_dump(3).
PHP Documentation Group VAR_EXPORT(3)