广告
返回顶部
首页 > 资讯 > 后端开发 > PHP编程 >PHP入门基础之注释的写法
  • 123
分享到

PHP入门基础之注释的写法

PHP 注释PHP注释方法 2022-11-13 09:11:29 123人浏览 薄情痞子
摘要

目录1 什么是注释1.1 注释的目的1.2 注释的格式2 PHP 的注释格式2.1 行注释2.2 多行注释3 小结1 什么是注释 注释就是对代码的解释和说明,其目的是让人们能够更加轻

1 什么是注释

注释就是对代码的解释和说明,其目的是让人们能够更加轻松地了解代码。注释是编写程序时,写程序的人给一个语句、程序段、函数等的解释或提示,能提高程序代码的可读性。

1.1 注释的目的

注释只是为了提高可读性,不会被计算机编译。

1.2 注释的格式

注释通常会分为行注释和块注释

  • 行注释: 在符号后那一行不会被编译
  • 块注释: 被块注释符号中间的部分不会被编译

2 php 的注释格式

PHP 支持 C,c++ 和 Unix shell 风格(Perl 风格)的注释。例如:

<?php
    echo 'This is a test'; // 这是单行 c++ 样式注释
    
    echo 'This is yet another test';
    echo 'One Final Test'; # 这是单行 shell 风格的注释
?>

2.1 行注释

单行注释

C 风格单行注释

<?php
    //这是第二行注释
    echo "Http://c.biancheng.net/php/";
    // echo "PHP 注释";
?>

shell 风格单行注释

   #这是第一行注释
    echo "C语言中文网<br>";

注意:单行注释仅仅注释到行末或者当前的 PHP 代码块,视乎哪个首先出现。这意味着在 // … ?> 或者 # … ?> 之后的 html 代码将被显示出来:?> 跳出了 PHP 模式并返回了 HTML 模式,// 或 # 并不能影响到这一点。

<h1>This is an <?php # echo 'simple';?> example</h1>
<p>The header above will say 'This is an example'.</p>

2.2 多行注释

在需要注释的代码块上以结束。

<?php
	

注意:C 风格的注释在碰到第一个 */ 时结束。要确保不要嵌套 C 风格的注释。

// 错误的写法
// Error: expect statement

*/
?>

3 小结

合理使用注释应该满足以下几项原则:

  • 注释必须准确、易懂、简洁,错误的注释不但无益反而有害;
  • 注释可以书写在代码中的任意位置,但是一般写在代码的开头或者结束位置;
  • 修改程序代码时,一定要同时修改相关的注释,以保持代码和注释的同步;
  • 在实际的代码规范中,要求注释占程序代码的 20% 左右,即 100 行程序中包含 20 行左右的注释;
  • 避免在注释中使用缩写,特别是不常用缩写;
  • 注释与所描述内容进行同样的缩进,可使程序排版整齐,并方便注释的阅读与理解。

到此这篇关于PHP入门基础之注释的写法的文章就介绍到这了,更多相关PHP注释内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

--结束END--

本文标题: PHP入门基础之注释的写法

本文链接: https://www.lsjlt.com/news/150686.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
猜你喜欢
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作