如何编写你的第一个PHP程序

作者选择Open Sourcing Mental Illness Ltd作为Write for DOnations计划的一部分接受捐赠。

简介

"你好，世界！"程序是计算机编程中一个经典的、历史悠久的传统。作为初学者的第一个完整程序，以及测试系统和编程环境的好程序，"你好，世界！"说明了编程语言的基本语法。

本教程将指导你用php编写一个 "你好，世界！"程序。你还将学习如何在代码中打开和关闭PHP代码块，以及在代码中使用不同类型的注释。

前提条件

你需要安装PHP，并在你的计算机上设置一个本地编程环境。

要设置这些，请按照如何安装 PHP 7.4 并为你的操作系统设置一个本地开发环境。

编写 "Hello, World!"程序

要编写 "Hello, World!"程序，首先要打开一个命令行文本编辑器，如nano ，并创建一个新文件。

nano hello.php

一旦文本文件在终端窗口中打开，就输入该程序。

hello.php

<?php
echo "Hello, World!";
?>

让我们来分解一下代码的不同组成部分。

所有的PHP代码都属于一个PHP代码块，以<?php 开始，以?> 结束。

echo 是一个语言结构。它的参数是在echo 关键字后面的表达式列表，用逗号隔开，不以括号为界。echo 告诉PHP显示或输出在echo 和结尾的分号; 之间的任何内容。

在echo 和; 之间是一连串的字符 -Hello, World! - 用引号括起来。任何在引号内的字符都被称为字符串。

写完程序后，按住CTRL ，并按下X ，退出nano 。当提示保存文件时，按Y 。

一旦你退出nano，你将回到你的shell。

这样，你就写好了你的 "Hello, World!"程序。

运行 "Hello, World!"程序程序

写好 "Hello, World!"程序后，你就可以运行该程序了。使用php 命令和程序文件的名称，如下所示。

php hello.php

运行你刚刚创建的hello.php 程序将使你的终端产生以下输出。

OutputHello, World!

让我们更详细地看看这个程序做了什么。

PHP通过调用语言结构echo ，执行行echo "Hello, World!"; 。Hello, World! 的字符串值被传递给该结构体。

在这个例子中，字符串Hello, World! 也被称为参数，因为它是一个被传递给代码中另一部分的值，比如一个结构体或一个函数。

Hello, World! 两边的引号没有输出到屏幕上，因为它们是用来告诉 PHP 这段代码包含一个字符串。引号划定了字符串的开始和结束位置。

由于程序运行成功，现在可以确认PHP已经正确安装，而且程序的语法也是正确的。在进一步了解代码本身之前，让我们仔细看看PHP代码块。

在PHP代码块之外工作

在.php 文件中，PHP 标签以外的任何内容都被当作 HTML或纯文本处理。PHP语言最初是作为扩展HTML功能的一种方式而编写的。考虑到这一点，你可以在整个文件中包含多个 PHP 代码块。代码块之外的任何内容都将作为 HTML 或纯文本呈现。

更新你的hello.php 文件。

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（Framework Interop Group）制定的。
• 选择易读性而不是易写性。使用描述性的变量而不是简短的变量。这不是你写了多少行代码的问题，而是要让别人花多长时间来阅读这些行并理解发生了什么。
• 评论要清晰。虽然这不是一个硬性规定，但如果你遵循了前面两个要点，你的代码应该解释正在发生的事情，而注释则解释为什么事情会以这种方式发生。

在PHP中写注释时，有两种类型的注释：单行注释和多行注释。单行注释可以从一行中的任何一点开始，并在行尾或代码块的末尾结束，以先到者为准。

最常见的方法是用双正斜杠(//)来开始单行注释，尽管PHP也承认哈希符号(#)是单行注释的有效开始。

hello.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 解释器将忽略这些字符内的任何文本或代码。为了提供更多的选项，让我们把最后一行改为多行注释。

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独特的最后部分是标签和注释。这些提供了一种简洁和统一地提供关于相关元素的元信息的方法。例如，标签可以描述一个方法或函数所接受或返回的信息类型。它也可以提供关于一个文件的作者或版权的细节。

hello.php

<?php
/**
 * DocBlock example
 *
 * @author Sammy <sammy@digitalocean.com>
 */
 ...

虽然你应该努力写出清晰易懂的代码，但添加澄清性的注释可以增加额外的背景，从而增加对代码的理解和代码背后的选择。

总结

在本教程中，你已经用PHP编写了 "你好，世界！"程序。你学到了如何在代码中打开和关闭PHP代码块，以及在代码越来越复杂的情况下使用不同的注释来澄清和添加上下文。从这里开始，你可以通过学习《如何在PHP中使用字符串》教程继续学习。