作者选择Open Sourcing Mental Illness Ltd接受捐赠,作为Write for DOnations计划的一部分。
介绍
“你好,世界!” 程序是计算机编程中的经典和历史悠久的传统。作为初学者的完整第一个程序和测试系统和编程环境的好程序,“Hello,World!” 说明了编程语言的基本语法。
本教程将引导您编写“Hello, World!” PHP中的程序。您还将了解如何在代码中打开和关闭 PHP 代码块以及在代码中使用不同类型的注释。
先决条件
您将需要安装 PHP 并在您的计算机上设置本地编程环境。
要进行设置,请按照如何安装 PHP 7.4 并为您的操作系统设置本地开发环境进行操作。
写下“你好,世界!” 程序
写下“你好,世界!” 程序,首先打开命令行文本编辑器,例如nano
,然后创建一个新文件:
- nano hello.php
在终端窗口中打开文本文件后,输入程序:
<?php
echo "Hello, World!";
?>
让我们分解代码的不同组件。
所有 PHP 代码都属于一个 PHP 代码块,<?php
以?>
.
echo
是一种语言结构。它的参数是echo
关键字后面的表达式列表,以逗号分隔,不以括号分隔。echo
告诉 PHP 显示或输出包含在echo
和结束分号之间的任何内容;
。
在echo
和之间;
是一个字符序列——Hello, World!
用引号括起来。引号内的任何字符都称为字符串。
编写程序后,按住CTRL
键,按X
键退出nano
。当提示保存文件时,按Y
。
退出 nano 后,您将返回到 shell。
有了这个,你就写了“你好,世界!” 程序。
运行“你好,世界!” 程序
用你的“你好,世界!” 程序写好了,你就可以运行程序了。使用该php
命令以及程序文件的名称,如下所示:
- php hello.php
运行hello.php
您刚刚创建的程序将导致您的终端产生以下输出:
OutputHello, World!
让我们更详细地回顾一下程序做了什么。
PHPecho "Hello, World!";
通过调用语言构造来执行该行echo
。的字符串值Hello, World!
已传递给构造。
在此示例中,字符串Hello, World!
也称为参数,因为它是传递给代码另一部分(例如构造或函数)的值。
两边的引号Hello, World!
没有输出到屏幕上,因为它们用于告诉 PHP 这部分代码包含一个字符串。引号描述字符串的开始和结束位置。
由于程序成功运行,您现在可以确认 PHP 已正确安装并且程序语法正确。在进一步研究代码本身之前,让我们仔细看看 PHP 代码块。
在 PHP 代码块之外工作
在.php
文件中,PHP 标记之外的任何内容都被视为 HTML或纯文本。PHP 语言最初是为了扩展 HTML 的功能而编写的。考虑到这一点,您可以在一个文件中包含多个 PHP 代码块。代码块之外的任何内容都将呈现为 HTML 或纯文本。
更新您的hello.php
文件:
Hi Sammy
<?php echo "Hello, World!"; ?>
How are you doing?
<?php echo "Swimmingly!";
保存文件并重新运行它:
OutputHi Sammy
Hello, World!
How are you doing?
Swimmingly!
深入研究代码,您会注意到Hi Sammy
和How are you doing?
都在 PHP 代码块之外,因此在运行程序时呈现为纯文本。
该文件包含两个 PHP 代码块。第一个代码块包括开始和结束标签,而位于文件末尾的第二个代码块不包含最后的结束标签。
?>
不需要包含结束块标记。使用 PHP 代码块结束文件时,建议去掉结束标记。在结束标记之后呈现的任何字符,甚至是空格,都将作为 HTML 或纯文本输出到屏幕上。这可能会导致应用程序功能出现意外后果,因为如果有任何内容输出到浏览器,某些功能(例如重定向)将无法处理。编写仅包含 PHP 代码的文件时,切勿包含 PHP 结束标记。
随着代码变得越来越复杂,比如在将概念拆分到多个代码块上时,为自己和他人留下笔记是有益的。您可以通过使用注释来做到这一点。
在 PHP 中添加注释
代码中的注释是不会作为程序的一部分执行的行。它的唯一目的是让正在查看代码的人阅读。令许多开发人员感到震惊的一件事是阅读代码与编写代码所花费的时间。这意味着拥有尽可能易于阅读的代码至关重要。您可以通过以下几种方式完成此操作:
- 使用编码标准。这些是用于清晰一致地组织和格式化代码的指南和最佳实践的集合。在 PHP 中,最常见的编码标准是由PHP-FIG(框架互操作组)开发的标准。
- 选择易于阅读而不是易于写作。在短变量上使用描述性变量。这不是关于您编写了多少行代码,而是关于有人阅读这些行并了解正在发生的事情需要多长时间。
- 评论清楚。虽然它不是一个硬性的规则,如果你已经按照前面的两个要点,你的代码应该解释什么正在发生的事情,而注释解释为什么事情正在发生事情是这样的。
在 PHP 中编写注释时,有两种类型的注释:单行注释和多行注释。单行注释可以从一行中的任何一点开始,并在行尾或代码块的末尾结束,以先到者为准。
最常见的单行注释开头方式是使用双正斜杠 ( //
),尽管 PHP 也将井号 ( #
)识别为单行注释的有效开头:
Hi Sammy
<?php echo "Hello"; //, World!"; ?>
How are you doing?
<?php echo "Swimmingly!";
// other options: Floating along
保存文件并再次运行它:
OutputHi Sammy
Hello
How are you doing?
Swimmingly!
第一个注释从一行的中间开始。之后添加了结束引号和分号,"Hello"
并注释掉了该行的其余部分。注释掉一行或多行代码通常用于调试,以测试在删除某些元素时代码如何响应。
您使用第二条评论为答案提供第二个选项。项目的下一步可能是在每次执行应用程序时使用多个不同选项之一进行响应。注释用作可以添加的其他选项的提醒。
多行注释/*
以*/
. PHP 解释器将忽略这些字符中的任何文本或代码。为了提供更多选项,让我们将最后一行更改为多行注释:
Hi Sammy
<?php echo "Hello"; //, World!"; ?>
How are you doing?
<?php echo "Swimmingly!";
/* When responding with one of a number of answers, here are some other options:
* Floating along
* Fin-tastic
* Going with the flow
* Treading water
* Swamped
*/
使用多行注释为添加细节或格式提供了更多空间,以再次使代码和代码的意图更易于理解。此多行注释包括换行符并添加*
为列表的描述符。该*/
组合表示我们的注释块的结束。
使用 DocBlocks 文档
有一种特殊类型的多行注释,称为 DocBlock。这是记录特定文件、类、方法或其他结构元素功能的独特方式。尽管 DocBlock 开始和结束与任何其他多行注释一样/* */
,但它们旨在提供处理元素的特定细节。这些详细信息不仅为开发人员提供了代码概览,而且还可以被代码编辑器(或 IDE)用来提供建议和验证。
DocBlock 由几个部分组成。第一个是介绍元素的简短摘要,如果需要更多上下文,则提供更长的描述。
使 DocBlock 独一无二的最后一部分是标签和注释。这些提供了一种简洁且统一地提供有关关联元素的元信息的方法。例如,标签可以描述方法或函数接受或返回的信息类型。它还可能提供有关文件作者或版权的详细信息:
<?php
/**
* DocBlock example
*
* @author Sammy <[email protected]>
*/
...
虽然您应该努力编写清晰易懂的代码,但添加澄清注释可以添加额外的上下文,从而增加对代码的理解和代码背后的选择。
结论
在本教程中,您编写了“Hello, World!” PHP中的程序。您了解了如何在代码中打开和关闭 PHP 代码块,以及在代码变得更复杂时使用不同的注释来阐明和添加上下文。从这里开始,您可以按照如何在 PHP 中使用字符串教程继续学习。