php怎么写注释?php注释规范介绍
@access
使用范围:class,function,var,define,module
该标记用于指明关键字的存取权限:private、public或proteced
@author
指明作者
@copyright
使用范围:class,function,var,define,module,use
指明版权信息
@deprecated
使用范围:class,function,var,define,module,constent,global,include
指明不用或者废弃的关键字
@example
该标记用于解析一段文件内容,并将他们高亮显示。Phpdoc会试图从该标记给的文件路径中读取文件内容
@const
使用范围:define
用来指明php中define的常量
@final
使用范围:class,function,var
指明关键字是一个最终的类、方法、属性,禁止派生、修改。
@filesource
和example类似,只不过该标记将直接读取当前解析的php文件的内容并显示。
@global
指明在此函数中引用的全局变量
@ingore
用于在文档中忽略指定的关键字
@license
相当于html标签中的,首先是URL,接着是要显示的内容
例如百度
可以写作 @license http://www.baidu.com 百度
@link
类似于license
但还可以通过link指到文档中的任何一个关键字
@name
为关键字指定一个别名。
@package
使用范围:页面级别的-> define,function,include
类级别的->class,var,methods
用于逻辑上将一个或几个关键字分到一组。
@abstrcut
说明当前类是一个抽象类
@param
指明一个函数的参数
@return
指明一个方法或函数的返回指
@static
指明关建字是静态的。
@var
指明变量类型
@version
指明版本信息
@todo
指明应该改进或没有实现的地方
@throws
指明此函数可能抛出的错误异常,极其发生的情况
上面提到过,普通的文档标记标记必须在每行的开头以@标记,除此之外,还有一种标记叫做inline tag,用{@}表示,具体包括以下几种:
{@link}
用法同@link
{@source}
显示一段函数或方法的内容
创建文件我们用到函数
fopen ( string filename, string mode )
参数filename为创建文件名
参数mode为以什么方式打开文件filename
其中mode可能值列表:
mode 说明
‘r' 只读方式打开,将文件指针指向文件头。
‘r+' 读写方式打开,将文件指针指向文件头。
‘w' 写入方式打开,将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。
‘w+' 读写方式打开,将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。
‘a' 写入方式打开,将文件指针指向文件末尾。如果文件不存在则尝试创建之。
‘a+' 读写方式打开,将文件指针指向文件末尾。如果文件不存在则尝试创建之。
‘x' 创建并以写入方式打开,将文件指针指向文件头。如果文件已存在,则 fopen() 调用失败并返回 FALSE,并生成一条 E_WARNING 级别的错误信息。如果文件不存在则尝试创建之。这和给 底层的 open(2) 系统调用指定 O_EXCL|O_CREAT 标记是等价的。此选项被 PHP 4.3.2 以及以后的版本所支持,仅能用于本地文件。
‘x+' 创建并以读写方式打开,将文件指针指向文件头。如果文件已存在,则 fopen() 调用失败并返回 FALSE,并生成一条 E_WARNING 级别的错误信息。如果文件不存在则尝试创建之。这和给 底层的 open(2) 系统调用指定 O_EXCL|O_CREAT 标记是等价的。此选项被 PHP 4.3.2 以及以后的版本所支持,仅能用于本地文件。
下面代码是我通过利用函数fopen创建一个名为Demo,格式为txt的文件,并在文件中写入"Welcome To ItCodeWorld!"的数据。
< ?php
//要创建的两个文件
$TxtFileName="Demo.txt";
//以读写方式打写指定文件,如果文件不存则创建
if( ($TxtRes=fopen($TxtFileName,"w+")) === FALSE){
echo("创建可写文件:".$TxtFileName."失败");
exit();
}
echo("创建可写文件".$TxtFileName."成功!</br>");
$StrConents="Welcome To ItCodeWorld!";//要 写进文件的内容
if(!fwrite ($TxtRes,$StrConents)){//将信息写入文件
echo("尝试向文件".$TxtFileName."写入".$StrConents."失败!");
fclose($TxtRes);
exit();
}
echo("尝试向文件".$TxtFileName."写入".$StrConents."成功!");
fclose ($TxtRes);//关闭指针
?>
PHP 创建文件 – fopen()
fopen() 函数也用于创建文件。也许有点混乱,但是在 PHP 中,创建文件所用的函数与打开文件的相同。
如果您用 fopen() 打开并不存在的文件,此函数会创建文件,假定文件被打开为写入(w)或增加(a)。
下面的例子创建名为 "testfile.txt" 的新文件。此文件将被创建于 PHP 代码所在的相同目录中:
实例
$myfile = fopen("testfile.txt", "w")
PHP 文件权限
如果您试图运行这段代码时发生错误,请检查您是否有向硬盘写入信息的 PHP 文件访问权限。
PHP 写入文件 – fwrite()
fwrite() 函数用于写入文件。
fwrite() 的第一个参数包含要写入的文件的文件名,第二个参数是被写的字符串。
下面的例子把姓名写入名为 "newfile.txt" 的新文件中:
实例
<?php
$myfile=fopen("newfile.txt","w")ordie("Unable to open file!");
$txt="Bill Gates\n";
fwrite($myfile,$txt);
$txt="Steve Jobs\n";
fwrite($myfile,$txt);
fclose($myfile);
?>
请注意,我们向文件 "newfile.txt" 写了两次。在每次我们向文件写入时,在我们发送的字符串 $txt 中,第一次包含 "Bill Gates",第二次包含 "Steve Jobs"。在写入完成后,我们使用 fclose() 函数来关闭文件。
如果我们打开 "newfile.txt" 文件,它应该是这样的:
Bill Gates
Steve Jobs
PHP 覆盖(Overwriting)
如果现在 "newfile.txt" 包含了一些数据,我们可以展示在写入已有文件时发生的的事情。所有已存在的数据会被擦除并以一个新文件开始。
在下面的例子中,我们打开一个已存在的文件 "newfile.txt",并向其中写入了一些新数据:
实例
<?php
$myfile=fopen("newfile.txt","w")ordie("Unable to open file!");
$txt="Mickey Mouse\n";
fwrite($myfile,$txt);
$txt="Minnie Mouse\n";
fwrite($myfile,$txt);
fclose($myfile);
?>
如果现在我们打开这个 “newfile.txt” 文件,Bill 和 Steve 都已消失,只剩下我们刚写入的数据:
Mickey Mouse
Minnie Mouse
换行符‘\n'和回车符‘\r'
顾名思义,换行符就是另起一行,回车符就是回到一行的开头,所以我们平时编写文件的回车符应该确切来说叫做回车换行符
‘\n' 10 换行(newline)
‘\r' 13 回车(return)
也可以表示为'\x0a'和'\x0d'.(16进制)
在windows系统下,回车换行符号是”\r\n”.但是在Linux等系统下是没有”\r”符号的。
在解析文本或其他格式的文件内容时,常常要碰到判定回车换行的地方,这个时候就要注意既要判定”\r\n”又要判定”\n”。
写程序时可能得到一行,将其进行trim掉'\r',这样能得到你所需要的string了。
分页基本上是每个项目都会使用到的,所以呢,把它封装成一个工具类,以后直接调用就可以了(虽然TP框架的灰常强大,但是自己封一个也未尝不可。),这样既省时又省力还赚‘工分'。
我封的这个分页工具类还比较完整,有首页,上一页,下一页,末页和可选数量的页码数量(也就是当页面很多时,只显示依据参数传入的个数),还可以依据需求选择是否使用下拉跳转页面功能。
代码如下 | 复制代码 |
<?php /** * 分页工具类 */
classpage{
/** * 返回分页所需字符串 * @param $pageNum int 显示的页码 * @param $pageCount int 总的页码数 * @param $url string 当前页码路径 * @param $Count string 页码列表里显示的个数 * @param $selected bool 是否开启下拉框选择功能。默认不开启 * return $strpage string 分页字符串 */ functionshowPage($pageNum,$pageCount,$url,$Count= 5,$selected= false){ $pageMaxVal=$Count- 1;// 页码到达最大时,页码列表里第一个页码与最大页码的差 $pageMiddleVal=ceil($Count/ 2);// 依据需要显示页码个数得到的中间值 $pageMiddleCha=floor($Count/ 2);// 依据需要显示页码个数得到的当前页码与第一个页码的差
// 判断url是否已经存在? if(!strpos($url,'?')){// 未存在? $url.='?' }else{ $url.='&' }
// 首页 $strpage="首页";
// 上一页 $preNum=$pageNum> 1 ?$pageNum- 1 : 1;
// 当页码为第一页时取消上一页按钮的功能 $strpage.=$pageNum== 1 ?"上一页":"上一页";
// 显示的页码列表中的第一个页码 $startPage=$pageNum>$pageMiddleVal?$pageNum-$pageMiddleCha: 1; // 起始页码最大值 = 总页数 - 4 if($pageCount-$pageMaxVal> 0 &&$startPage>$pageCount-$pageMaxVal){ $startPage=$pageCount-$pageMaxVal; }
// 显示的页码列表中的最后一个页码 $endPage=$startPage<($pageCount-$pageMaxVal) ?$startPage+$pageMaxVal:$pageCount;
// 中间数字页码 for($i=$startPage;$i<=$endPage;$i++){ if($i==$pageNum){ $strpage.="$i"; }else{ $strpage.="$i"; } }
// 下一页 $nextNum=$pageNum<$pageCount?$pageNum+ 1 :$pageCount;
// 当页码为最后一页时取消下一页按钮的功能 $strpage.=$pageNum==$pageCount?"下一页":"下一页";
// 末页 $strpage.="末页";
// 总页数 $strpage.="总页数:{$pageCount} ";
// 判断是否是否选择页码功能 if($selected){// 选择了 $strpage.="当前页码: for($i= 1;$i<=$pageCount;$i++){ if($i==$pageNum){ $strpage.=" }else{ $strpage.=" } }
$strpage.=""; }
return$strpage; }
} |
接下来应该会PO完MySQL剩余部分知识吧,希望大家继续关注。
这篇文章介绍了PHP使用递归算法无限遍历数组的实例,分析了php针对一维数组、二维数组及多维不规则数组的通用遍历技巧,有兴趣的同学可以看看本文实例讲述了PHP使用递归算法无限遍历数组。分享给大家供大家参考,具体如下:
代码如下 | 复制代码 |
<?php //无限遍历数组 $a1=array("a","b","c");//一维数组 $a2=array(array(21, 3, 6),array("a","b","c"));//二维数组 $a3=array(array(array(5, 55), 4, 444), 2, 7, 6, 8,array("w","d",array(3, 2,"a"),"s"));//多维不规则数组 functionfun($a) { foreach($aas$val) { if(is_array($val)) {//如果键值是数组,则进行函数递归调用 fun($val); }else{// 如果键值是数值,则进行输出 echo"$val<br />"; }//end if }//end foreach }//end fun //fun($a1); //fun($a2); fun($a3); ?> |
输出:
代码如下 | 复制代码 |
5 55 4 444 2 7 6 8 w d 3 2 a s |
相关文章
- 本文主要介绍了C#中注释的相关知识,具有很好的参考价值,下面跟着小编一起来看下吧...2020-06-25
- C#注释的一些使用方法浅谈,需要的朋友可以参考一下...2020-06-25
- Promise是异步编程的一种解决方案,在ES6中Promise被列为了正式规范,统一了用法,原生提供了Promise对象。接下来通过本文给大家介绍Promise的介绍及基本用法,感兴趣的朋友一起看看吧...2021-10-21
- 这篇文章主要介绍了IDEA插件之快速删除Java代码中的注释,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-02-18
- 这篇文章主要介绍了R语言-使用快捷键快速注释的实现方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-05-06
- 这篇文章主要介绍了解决阿里代码规范检测中方法缺少javadoc注释的问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-08-10
- 这篇文章主要介绍了PyCharm设置注释字体颜色以及是否倾斜的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-09-16
- 下面小编就为大家带来一篇老生常谈javascript变量的命名规范和注释。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧...2016-10-02
- 本章节讨论使用ES6编码风格到代码中需要注意的点。通过记住这些关键点,可以让我们写出更优美的、可读性更强的JavaScript ES6风格的代码。...2021-05-08
PHP中print_r、var_export、var_dump用法介绍
文章详细的介绍了关于PHP中print_r、var_export、var_dump区别比较以及这几个在php不同的应用中的用法,有需要的朋友可以参考一下 可以看出print_r跟var_export都...2016-11-25Framewrok7 视图介绍(views、view)使用介绍
下面我们来看一篇关于Framewrok7 视图介绍(views、view)使用介绍吧,希望这篇文章能够帮助到各位朋友。 一、Views 与View的介绍 1,Views (<div class="views">) (1)Vi...2016-10-02- 这篇文章主要介绍了C#编程的通用结构和程序书写格式规范,这里我们根据C#语言的开发方微软给出的约定来作为编写样式参照,需要的朋友可以参考下...2020-06-25
VSCode 添加自定义注释的方法(附带红色警戒经典注释风格)
这篇文章主要介绍了VSCode 添加自定义注释的方法(附带红色警戒经典注释风格),本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-08-28- PHP日志类库在低版本中我们都没有看到了但在高版本的php中就有了,下面我们来看一篇关于PHP日志类库使用详解介绍吧. Monolog遵循PSR3的接口规范,可以很轻易的替换...2016-11-25
- 本文给大家总结了js编码规范知识,非常实用,在日常程序开发中经常可以用到,大家务必掌握...2016-06-24
- 这篇文章介绍了php获取当前url地址的方法小结,有兴趣的同学可以参考一下 本文实例讲述了php获取当前url地址的方法。分享给大家供大家参考,具体如下: js 获取: ...2017-01-22
- 1. PHP-GTK介绍 1.1 PHP-GTK PHP-GTK是PHP的延伸模组,它可以让程式设计师写出在客户端执行的、且独立的GUI的程式。这个模组不允许在浏览器上显视GTK+的程式,它一开始就...2016-11-25
- 介绍性指南 mod_perl 是个庞大而复杂的工具,它内建了许多模块帮助你方便地构建动态网站。这篇指南的目的是帮助你构建一个良好的 mod_perl 模块,并从中理解 mod_perl 的实现...2020-06-29
- 在php中要获取或目录权限我们可使用fileperms函数来获取,fileperms() 函数返回文件或目录的权限,。若成功,则返回文件的访问权限。若失败,则返回 false。 例子 1 ...2016-11-25
- php默认时区是欧美国家的所以与我们中国时区相差了整整8小时哦,下面我来给各位介绍php设置时区方法,有需要了解的朋友可进入参考。 在 php.ini 中,默认是 date.timez...2016-11-25