2024 年 PHP 日本大会

    echo

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

    echo — 输出一个或多个字符串

    描述

    echo(string ...$expressions): void

    输出一个或多个表达式，不添加额外的换行符或空格。

    echo 不是函数，而是一个语言结构。它的参数是跟随 echo 关键字的一系列表达式，用逗号分隔，并且不用括号括起来。与其他一些语言结构不同，echo 没有返回值，因此不能在表达式的上下文中使用。

    echo 也有一种快捷语法，你可以直接在开始标签后跟一个等号。即使禁用了 short_open_tag 配置设置，此语法仍然可用。

    我有 <?=$foo?> foo。

    与 print 的主要区别在于 echo 接受多个参数并且没有返回值。

    参数

    表达式

    一个或多个用逗号分隔的字符串表达式，用于输出。即使启用了 strict_types 指令，非字符串值也会被强制转换为字符串。

    返回值

    不返回任何值。

    示例

    示例 #1 echo 示例

    <?php
    echo "echo 不需要括号.";

    // 字符串可以单独作为多个参数传递，也可以
    // 连接在一起作为单个参数传递
    echo 'This ', 'string ', 'was ', 'made ', 'with multiple parameters.', "\n";
    echo     'This ' . 'string ' . 'was ' . 'made ' . 'with concatenation.' . "\n";

    // 不添加换行符或空格；下面输出 "helloworld" 全部在一行
    echo "hello";
    echo     "world";

    // 与上面相同
    echo "hello", "world";

    echo     "This string spans
    multiple lines. The newlines will be
    output as well"    ;

    echo     "This string spans\nmultiple lines. The newlines will be\noutput as well.";

    // 参数可以是任何产生字符串的表达式
    $foo = "example";
    echo     "foo is $foo"; // foo is example

    $fruits = ["lemon", "orange", "banana"];
    echo     implode(" and ", $fruits); // lemon and orange and banana

    // 非字符串表达式会被强制转换为字符串，即使使用了 declare(strict_types=1)
    echo 6 * 7; // 42

    // 因为 echo 的行为不像表达式，所以下面的代码无效。
    ($some_var) ? echo 'true' : echo 'false';

    // 但是，下面的示例会起作用：
    ($some_var) ? print 'true' : print 'false'; // print 也是一个结构，但是
    // 它是一个有效的表达式，返回 1，
    // 所以它可以在这个上下文中使用。

    echo $some_var ? 'true': 'false'; // 先计算表达式，然后传递给 echo
    ?>

    注释

    注意: 因为这是一个语言结构而不是函数，所以不能使用 可变函数 或 命名参数 来调用它。

    注意: 使用括号

    用括号括住 echo 的单个参数不会引发语法错误，并且生成的语法看起来像正常的函数调用。但是，这可能会产生误导，因为括号实际上是输出表达式的部分，而不是 echo 语法本身的一部分。

    <?php
    echo "hello";
    // 输出 "hello"

    echo("hello");
    // 也输出 "hello"，因为 ("hello") 是一个有效的表达式

    echo(1 + 2) * 3;
    // 输出 "9"；括号导致先计算 1+2，然后计算 3*3
    // echo 语句将整个表达式视为一个参数

    echo "hello", " world";
    // 输出 "hello world"

    echo("hello"), (" world");
    // 输出 "hello world"；括号是每个表达式的部分

    echo("hello", " world");
    // 抛出解析错误，因为 ("hello", " world") 不是有效的表达式
    ?>

    提示

    将多个参数传递给 echo 可以避免 PHP 中连接运算符的优先级引起的复杂问题。例如，连接运算符的优先级高于三元运算符，并且在 PHP 8.0.0 之前与加法和减法具有相同的优先级。

    <?php
    // 下面的表达式 'Hello ' . isset($name) 首先被计算，
    // 并且总是为真，所以 echo 的参数总是 $name
    echo 'Hello ' . isset($name) ? $name : 'John Doe' . '!';

    // 预期行为需要额外的括号
    echo 'Hello ' . (isset($name) ? $name : 'John Doe') . '!';

    // 在 PHP 8.0.0 之前的版本中，下面输出 "2"，而不是 "Sum: 3"
    echo 'Sum: ' . 1 + 2;

    // 同样，添加括号可以确保预期的计算顺序
    echo 'Sum: ' . (1 + 2);

    如果传递多个参数，则不需要括号来强制优先级，因为每个表达式都是独立的。

    <?php
    echo "Hello ", isset($name) ? $name : "John Doe", "!";

    echo     "Sum: ", 1 + 2;

    参见

    发现问题？

    学习如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 1 个注释

    上
    下
    36
    pemapmodder1970 at gmail dot com
    7 年前
    使用逗号 (',') 传递多个参数给 echo 与使用连接运算符 ('.') 不完全相同。有两个显著的区别。

    首先，连接运算符的优先级要高得多。参考 https://php.net/operators.precedence, 许多运算符的优先级低于连接运算符，因此最好使用多参数形式，而不是传递连接的字符串。

    <?php
    echo "The sum is " . 1 | 2; // 输出： "2"。需要括号。
    echo "The sum is ", 1 | 2; // 输出： "The sum is 3"。正常。
    ?>

    其次，一个略微令人困惑的现象是，与向函数传递参数不同，这些值是逐个计算的。

    <?php
    function f($arg){
    var_dump($arg);
    return     $arg;
    }
    echo     "Foo" . f("bar") . "Foo";
    echo     "\n\n";
    echo     "Foo", f("bar"), "Foo";
    ?>

    输出将是
    string(3) "bar"FoobarFoo

    Foostring(3) "bar"
    barFoo

    对于使用像 sleep() 这样的阻塞函数作为参数的脚本，这将成为一个令人困惑的错误。

    <?php
    while(true){
    echo     "Loop start!\n", sleep(1);
    }
    ?>

    对比

    <?php
    while(true){
    echo     "Loop started!\n" . sleep(1);
    }
    ?>

    使用 ','，光标在每一行的开头停止，而使用 '.'，光标在每一行的开头 0 后停止（因为 sleep() 返回 0）。
    ＋添加注释
    To Top