PHP - Heredoc & Nowdoc



PHP 提供了两种选择,用于以 heredoc 和 newdoc 语法的形式声明单引号或双引号字符串。

  • 单引号字符串不会解释转义字符,也不会扩展变量。
  • 另一方面,如果你声明一个包含双引号字符的双引号字符串,你需要用 “\” 符号来转义它。heredoc 语法提供了一种方便的方法。

PHP 的 Heredoc 字符串

PHP 中的 heredoc 字符串很像双引号字符串,没有双引号。这意味着它们不需要转义引号和扩展变量。

Heredoc 语法


$str = <<<IDENTIFIER
在这里放一根线
它可以跨越多条线
并包括单引号和双引号”
IDENTIFIER;

首先,从 “<<<” 运算符开始。在此运算符之后,提供标识符,然后提供换行符。字符串本身后跟,然后再次使用相同的标识符以结束引号。字符串可以跨越多行,并包含单引号 (') 或双引号 (”)。

结束标识符可以用 space 或 tab 缩进,在这种情况下,缩进将从 doc 字符串中的所有行中去除。

例子

标识符必须仅包含字母数字字符和下划线,并且以下划线或非数字字符开头。结束标识符不应包含除分号 (;).此外,结束标识符前后的字符只能是换行符。

请看下面的例子 -


<?php  
   $str1 = <<<STRING
   启科普
      PHP 教程
         by qikepu.com
   STRING;

   echo $str1;
?>

它将产生以下输出 -

启科普
    PHP 教程
       by qikepu.com

例子

结束标识符在编辑器中的第一列之后可能包含也可能不包含缩进。缩进(如果有)将被去除。但是,结束标识符的缩进不得超过正文的任何行。否则,将引发 ParseError。请看一下以下示例及其输出 -


<?php  
   $str1 = <<<STRING
   Hello World
      PHP 教程
   by qikepu.com
         STRING;
         
   echo $str1;
?>

它将产生以下输出 -

PHP Parse error:  Invalid body indentation level 
(expecting an indentation level of at least 16) in hello.php on line 2

例子

heredoc 中的引号不需要转义,但仍然可以使用 PHP 转义序列。Heredoc 语法也会扩展变量。


<?php  
   $lang="PHP";
   echo <<<EOS
   $lang 中的Heredoc字符串用于扩展变量。
   逃逸序列也得到了解释。
   这里,十六进制ASCII字符生成 \x50\x48\x50
   EOS;
?>

它将产生以下输出 -

   PHP 中的Heredoc字符串用于扩展变量。
   逃逸序列也得到了解释。
   这里,十六进制ASCII字符生成 PHP

PHP 的 Nowdoc 字符串

PHP 中的 nowdoc 字符串类似于 heredoc 字符串,不同之处在于它不扩展变量,也不解释转义序列。


<?php
   $lang="PHP";

   $str = <<<'IDENTIFIER'
   这是一个Nowdoc字符串的示例。
   它可以跨越多条线
   并包括单引号和双引号”
   IT不会扩展$lang变量的值
   IDENTIFIER;

   echo $str;
?>

它将产生以下输出 -

这是一个Nowdoc字符串的示例。
它可以跨越多条线
并包括单引号'和双引号”
IT不会扩展$lang变量的值

nowdoc 的语法类似于 heredoc 的语法,只是 “<<<” 运算符后面的标识符需要用单引号括起来。nowdoc 的标识符也遵循 heredoc 标识符的规则。

Heredoc 字符串就像没有转义的双引号字符串。Nowdoc 字符串就像没有转义的单引号字符串。