PHP中文手册

版权信息

PHP 手册

入门指引

安装与配置

语言参考

安全

特点

函数参考

PHP 核心:骇客指南

FAQ

附录

重载

PHP所提供的"重载"(overloading)是指动态地"创建"类属性和方法。我们是通过魔术方法(magic methods)来实现的。

当调用当前环境下未定义或不可见的类属性或方法时,重载方法会被调用。本节后面将使用"不可访问属性(inaccessible properties)"和"不可访问方法(inaccessible methods)"来称呼这些未定义或不可见的类属性或方法。

所有的重载方法都必须被声明为 public

Note:

这些魔术方法的参数都不能通过引用传递

Note:

PHP中的"重载"与其它绝大多数面向对象语言不同。传统的"重载"是用于提供多个同名的类方法,但各方法的参数类型和个数不同。

更新日志

版本 说明
5.3.0 新增 __callStatic()魔术方法。可见性未设置为 public 或未声明为 static 的时候会产生一个警告。
5.1.0 新增 __isset()__unset() 两个魔术方法。

属性重载

public void __set ( string $name , mixed $value )
public mixed __get ( string $name )
public bool __isset ( string $name )
public void __unset ( string $name )

在给不可访问属性赋值时,__set() 会被调用。

读取不可访问属性的值时,__get() 会被调用。

当对不可访问属性调用 isset() empty() 时,__isset() 会被调用。

当对不可访问属性调用 unset() 时,__unset() 会被调用。

参数 $name 是指要操作的变量名称。__set() 方法的 $value 参数指定了 $name 变量的值。

属性重载只能在对象中进行。在静态方法中,这些魔术方法将不会被调用。所以这些方法都不能被 声明为 static。从 PHP 5.3.0 起, 将这些魔术方法定义为 static 会产生一个警告。

Note:

因为 PHP 处理赋值运算的方式,__set() 的返回值将被忽略。类似的, 在下面这样的链式赋值中,__get() 不会被调用:

$a = $obj->b = 8; 

Note:

在除 isset() 外的其它语言结构中无法使用重载的属性,这意味着当对一个重载的属性使用 empty() 时,重载魔术方法将不会被调用。

为避开此限制,必须将重载属性赋值到本地变量再使用 empty()

Example #1 使用 __get()__set()__isset()__unset() 进行属性重载

<?php
class  PropertyTest  {
     
/**  被重载的数据保存在此  */
    
private  $data  = array();

 
     
/**  重载不能被用在已经定义的属性  */
    
public  $declared  1 ;

     
/**  只有从类外部访问这个属性时,重载才会发生 */
    
private  $hidden  2 ;

    public function 
__set ( $name $value
    {
        echo 
"Setting ' $name ' to ' $value '\n" ;
        
$this -> data [ $name ] =  $value ;
    }

    public function 
__get ( $name
    {
        echo 
"Getting ' $name '\n" ;
        if (
array_key_exists ( $name $this -> data )) {
            return 
$this -> data [ $name ];
        }

        
$trace  debug_backtrace ();
        
trigger_error (
            
'Undefined property via __get(): '  $name  .
            
' in '  $trace [ 0 ][ 'file' ] .
            
' on line '  $trace [ 0 ][ 'line' ],
            
E_USER_NOTICE );
        return 
null ;
    }

    
/**  PHP 5.1.0之后版本 */
    
public function  __isset ( $name
    {
        echo 
"Is ' $name ' set?\n" ;
        return isset(
$this -> data [ $name ]);
    }

    
/**  PHP 5.1.0之后版本 */
    
public function  __unset ( $name
    {
        echo 
"Unsetting ' $name '\n" ;
        unset(
$this -> data [ $name ]);
    }

    
/**  非魔术方法  */
    
public function  getHidden () 
    {
        return 
$this -> hidden ;
    }
}


echo 
"<pre>\n" ;

$obj  = new  PropertyTest ;

$obj -> 1 ;
echo 
$obj -> "\n\n" ;

var_dump (isset( $obj -> a ));
unset(
$obj -> a );
var_dump (isset( $obj -> a ));
echo 
"\n" ;

echo 
$obj -> declared  "\n\n" ;

echo 
"Let's experiment with the private property named 'hidden':\n" ;
echo 
"Privates are visible inside the class, so __get() not used...\n" ;
echo 
$obj -> getHidden () .  "\n" ;
echo 
"Privates not visible outside of class, so __get() is used...\n" ;
echo 
$obj -> hidden  "\n" ;
?>

以上例程会输出:

Setting 'a' to '1'
Getting 'a'
1Is 'a' set?
bool(true)
Unsetting 'a'
Is 'a' set?
bool(false)1Let's experiment with the private property named 'hidden':
Privates are visible inside the class, so __get() not used...
2
Privates not visible outside of class, so __get() is used...
Getting 'hidden'Notice:  Undefined property via __get(): hidden in <file> on line 70 in <file> on line 29

方法重载

public mixed __call ( string $name , array $arguments )
public static mixed __callStatic ( string $name , array $arguments )

在对象中调用一个不可访问方法时,__call() 会被调用。

用静态方式中调用一个不可访问方法时,__callStatic() 会被调用。

$name 参数是要调用的方法名称。 $arguments 参数是一个枚举数组,包含着要传递给方法 $name 的参数。

Example #2 使用 __call()__callStatic() 对方法重载

<?php
class  MethodTest 
{
    public function 
__call ( $name $arguments
    {
        
// 注意: $name 的值区分大小写
        
echo  "Calling object method ' $name ' "
             
implode ( ', ' $arguments ).  "\n" ;
    }

    
/**  PHP 5.3.0之后版本  */
    
public static function  __callStatic ( $name $arguments
    {
        
// 注意: $name 的值区分大小写
        
echo  "Calling static method ' $name ' "
             
implode ( ', ' $arguments ).  "\n" ;
    }
}

$obj  = new  MethodTest ;
$obj -> runTest ( 'in object context' );

MethodTest :: runTest ( 'in static context' );   // PHP 5.3.0之后版本
?>

以上例程会输出:

Calling object method 'runTest' in object context
Calling static method 'runTest' in static context