PHP EOF（Heredoc）使用说明

最新推荐文章于 2025-05-12 15:34:33 发布

原创最新推荐文章于 2025-05-12 15:34:33 发布 · 1k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#php #android #开发语言

PHP学习专栏收录该内容

19 篇文章

订阅专栏

在 PHP 编程中，heredoc（也称为 EOF，但 EOF 只是一个常用的标识符，你可以使用任何唯一的标识符）是一种定义字符串的方法，它可以包含跨越多行的文本，且无需担心转义字符的问题。它特别适用于包含大量文本或 HTML 内容的字符串。
在这里插入图片描述

什么是 Heredoc？

Heredoc 是一种特殊的字符串字面量，允许你以类似于文件的方式包含多行文本。在 Heredoc 结构中，字符串的起始标记后面跟上一个唯一的标识符（通常是 EOF），然后是字符串的内容，最后以相同的标识符结束字符串。

Heredoc 的语法

Heredoc 的基本语法如下：

<<<EOF
这是一个
包含多行文本的
heredoc 字符串
EOF;

注意几点：

<<<EOF 是 heredoc 的起始标记，其中 EOF 是标识符。你可以使用任何你喜欢的标识符，但请确保它在你的 heredoc 字符串中唯一，并且在结束标记中也使用相同的标识符。
heredoc 字符串的内容从起始标记的下一行开始，直到遇到单独的结束标识符行为止。结束标识符行必须位于行的开始，且后面不能有任何字符（包括空格和制表符）。
heredoc 字符串支持变量解析（如果启用了），就像双引号字符串一样。

Heredoc 示例

示例 1：简单的 Heredoc 字符串

$name = "John Doe";

echo <<<EOF
Hello, my name is $name.
I am using heredoc to output this multi-line string.
EOF;

输出：

Hello, my name is John Doe.
I am using heredoc to output this multi-line string.

示例 2：在 Heredoc 中包含 HTML

echo <<<EOF
<html>
<head>
    <title>Heredoc Example</title>
</head>
<body>
    <h1>Welcome to Heredoc World!</h1>
    <p>This is an example of using heredoc to output HTML content.</p>
</body>
</html>
EOF;

示例 3：在 Heredoc 中包含变量和转义字符

$name = "John Doe";
$age = 30;

echo <<<EOF
My name is $name and I am $age years old.
I can use double quotes (") without escaping them in heredoc.
EOF;

输出：

My name is John Doe and I am 30 years old.
I can use double quotes (") without escaping them in heredoc.

Heredoc 与 Nowdoc 的区别

除了 heredoc，PHP 还提供了 nowdoc 语法（使用 <<<'EOF' 而不是 <<<EOF）。nowdoc 类似于 heredoc，但 nowdoc 不会解析变量或特殊字符（除了 $ 本身）。这意味着在 nowdoc 中，你可以直接包含文本，而无需担心变量解析或转义字符的问题。

注意事项

确保结束标识符（如 EOF）在你的 heredoc 字符串中是唯一的，并且没有前导或尾随的空格或制表符。
heredoc 字符串中的变量解析是可选的，可以通过在 PHP 配置中设置 nowdoc_syntax 来启用或禁用它（在 PHP 7.3.0 之前）。然而，从 PHP 7.3.0 开始，nowdoc_syntax 配置指令已被移除，并且 heredoc 始终支持变量解析。
如果你不希望 heredoc 字符串中的变量被解析，你可以使用 nowdoc 语法。

通过使用 heredoc，你可以更轻松地包含和管理多行文本，特别是在输出大量 HTML 或其他标记语言时。