unset

(PHP 4, PHP 5, PHP 7, PHP 8)

unset清除指定变量

说明

unset(mixed $var, mixed ...$vars): void

unset() 销毁指定变量。

unset() 在函数中的行为会依赖于想要销毁的变量的类型而有所不同。

如果在函数中 unset() 一个全局变量,则只是局部变量被销毁,而在调用环境中的变量将保持调用 unset() 之前一样的值。

<?php
function destroy_foo()
{
global
$foo;
unset(
$foo);
}

$foo = 'bar';
destroy_foo();
echo
$foo;
?>

以上示例会输出:

bar

如果您想在函数中 unset() 一个全局变量,可使用 $GLOBALS 数组来实现:

<?php
function foo()
{
unset(
$GLOBALS['bar']);
}

$bar = "something";
foo();
?>

如果在函数中 unset() 一个通过引用传递的变量,则只是局部变量被销毁,而在调用环境中的变量将保持调用 unset() 之前一样的值。

<?php
function foo(&$bar)
{
unset(
$bar);
$bar = "blah";
}

$bar = 'something';
echo
"$bar\n";

foo($bar);
echo
"$bar\n";
?>

以上示例会输出:

something
something

如果在函数中 unset() 一个静态变量,那么在函数内部此静态变量将被销毁。但是,当再次调用此函数时,此静态变量将被复原为上次被销毁之前的值。

<?php
function foo()
{
static
$bar;
$bar++;
echo
"Before unset: $bar, ";
unset(
$bar);
$bar = 23;
echo
"after unset: $bar\n";
}

foo();
foo();
foo();
?>

以上示例会输出:

Before unset: 1, after unset: 23
Before unset: 2, after unset: 23
Before unset: 3, after unset: 23

参数

var

要销毁的变量。

vars

更多变量。

返回值

没有返回值。

示例

示例 #1 unset() 示例

<?php
// 销毁单个变量
unset($foo);

// 销毁单个数组元素
unset($bar['quux']);

// 销毁一个以上的变量
unset($foo1, $foo2, $foo3);
?>

示例 #2 使用 (unset) 类型强制转换

(unset) 类型强制转换经常与函数 unset() 引起困惑。 为了完整性,(unset) 是作为 NULL 类型的强制转换。 它不会改变变量的类型。自 PHP 7.2.0 起,弃用 (unset) 强制转换,自 8.0.0 起移除。

<?php
$name
= 'Felipe';

var_dump((unset) $name);
var_dump($name);
?>

以上示例会输出:

NULL
string(6) "Felipe"

注释

注意: 因为是语言构造器而不是函数,不能被 可变函数 或者 命名参数 调用。

注意:

它可以取消设置当前上下文中可见的对象属性。

如果已声明,则在访问未设置的属性时调用 __get(), 在设置未设置的属性时调用 __set()

注意:

无法在对象里销毁 $this

注意:

unset() 一个无法访问的对象属性时,如果定义了 __unset() 则会调用这个重载方法。

参见