PHP 编程的 5 个良好习惯Word文件下载.docx
《PHP 编程的 5 个良好习惯Word文件下载.docx》由会员分享,可在线阅读,更多相关《PHP 编程的 5 个良好习惯Word文件下载.docx(21页珍藏版)》请在冰豆网上搜索。
case6:
case7:
return1;
default:
return($d+1);
}
}
$day=5;
$nextDay=getNBDay($day);
echo("
Nextdayis:
"
.$nextDay."
n"
);
>
良好习惯:
说明性强并且简洁的名称
清单2中的代码体现了良好的编程习惯。
新的方法名具有很强的说明性,反映了方法的用途。
同样,更改后的变量名也更具说明性。
惟一的保持最短的变量是$i,在本清单中,它是一个循环变量。
尽管很多人不赞同使用过短的名称,但在循环变量中使用还是可以接受的(甚至有好处),因为它明确表明了代码的功能。
清单2.良好习惯:
define('
MONDAY'
1);
TUESDAY'
2);
WEDNESDAY'
3);
THURSDAY'
4);
FRIDAY'
5);
SATURDAY'
6);
SUNDAY'
7);
/*
*
*@param$dayOfWeek
*@returnintDayofweek,with1beingMondayandsoon.
*/
functionfindNextBusinessDay($dayOfWeek)
$nextBusinessDay=$dayOfWeek;
switch($dayOfWeek){
caseFRIDAY:
caseSATURDAY:
caseSUNDAY:
$nextBusinessDay=MONDAY;
break;
$nextBusinessDay+=1;
return$nextBusinessDay;
$day=FRIDAY;
$nextBusDay=findNextBusinessDay($day);
"
.$nextBusDay."
我们鼓励您将大的条件拆分为一个方法,然后用能够描述该条件的名字命名方法。
这个技巧能够提高代码的可读性,并且能够将条件具体化,使之能够被提取甚至重用。
如果条件发生变化,更新方法也很容易。
因为方法拥有一个有意义的名字,所以它能反映代码的用途,让代码更容易阅读。
分成更小的部分
专心解决一个问题之后再继续编程,这样会让您更轻松。
在解决一个紧急的问题时,如果继续编程,会使函数越来越长。
从长远来说,这并不是一个问题,但您要记得回过头来将它重构为更小的部分。
重构是个不错的主意,但您应该养成编写更短、功能更集中的代码。
短的方法能够在一个窗口中一次看完,并且容易理解。
如果方法过长,不能在一个窗口中一次看完,那么它就变得不容易理解,因为您不能快速地从头到尾了解它的整个思路。
构建方法时,您应该养成这样的习惯,让每个方法只完成一件事情。
这个习惯很好,因为:
首先,如果方法只完成一件事情,那么它就更容易被重用;
其次,这样的方法容易测试;
第三,这样的方法便于理解和更改。
过长的方法(完成很多件事情)
清单3展示了一个很长的函数,其中存在很多问题。
它完成很多件事情,因此不够紧凑。
它也不便于阅读、调试和测试。
它要做的事情包括遍历一个文件、构建一个列表、为每个对象赋值、执行计算等等。
清单3.不良习惯:
过长的函数
functionwriteRssFeed($user)
//GettheDBconnectioninformation
//lookuptheuser'
spreferences...
$link=mysql_connect('
mysql_host'
'
mysql_user'
mysql_password'
)
ORdie(mysql_error());
//Query
$perfsQuery=sprintf("
SELECTmax_storiesFROMuser_perfsWHEREuser='
%s'
mysql_real_escape_string($user));
$result=mysql_query($query,$link);
$max_stories=25;
//defaultitto25;
if($row=mysql_fetch_assoc($result)){
$max_stories=$row['
max_stories'
];
//gogetmydata
SELECT*FROMstoriesWHEREpost_date='
mysql_real_escape_string());
$feed="
<
rssversion="
2.0"
.
channel>
title>
MyGreatFeed<
/title>
link>
description>
Thebestfeedintheworld<
/description>
language>
en-us<
/language>
pubDate>
Tue,20Oct200810:
00:
00GMT<
/pubDate>
lastBuildDate>
/lastBuildDate>
docs>
generator>
MyFeedGenerator<
/generator>
managingEditor>
editor@<
/managingEditor>
webMaster>
webmaster@<
/webMaster>
ttl>
5<
/ttl>
;
//buildthefeed...
while($row=mysql_fetch_assoc($result)){
$title=$row['
title'
$link=$row['
link'
$description=$row['
description'
$date=$row['
date'
$guid=$row['
guid'
$feed.="
item>
.$title."
.$link."
/link>
.$description."
.$date."
guid>
.$guid."
/guid>
/item>
/rss"
//writethefeedouttotheserver...
echo($feed);
如果多编写几个这样的方法,维护就成了真正的难题了。
易管理、功能专一的方法
清单4将原来的方法改写为更加紧凑、易读的方法。
在这个示例中,将一个很长的方法分解为几个短方法,并且让每个短方法负责一件事情。
这样的代码对将来的重用和测试都是大有裨益的。
清单4.良好习惯:
functioncreateRssHeader()
return"
functioncreateRssFooter()
/channel>
/rss>
functioncreateRssItem($title,$link,$desc,$date,$guid)
$item.="
return$item;
functiongetUserMaxStories($db_link,$default)
$result=mysql_query($perfsQuery,$db_link);
$max_stories=$default;
}
return$max_stories;
$settings=parse_ini_file("
rss_server.ini"
$link=mysql_connect($settings['
db_host'
],$settings['
user'
],
$settings['
password'
])ORdie(mysql_error());
$max_stories=getUserMaxStories($link,25);
$newsQuery=sprintf("
mysql_real_escape_string(time()));
$result=mysql_query($newsQuery,$link);
$feed=createRssHeader();
$i=0;
if($i<
$max_stories){
$feed.=createRssItem($title,$link,$description,$date,$guid);
$i++;
}else{
mysql_close($link);
$feed.=createRssFooter();
将长方法拆分为短方法也是有限制的,过度拆分将适得其反。
因此,不要滥用这个良好的习惯。
将代码分成大量的片段就像没有拆分长代码一样,都会造成阅读困难。
为代码添加注释
要为代码添加良好的注释有时似乎和编写代码一样难。
要了解应该为哪些内容添加注释并不容易,因为我们常常倾向于注释代码当前做的事情。
注释代码的目的是不错的主意。
在函数的不是很明显的头部代码块中,告诉读者方法的输入和输出,以及方法的最初目标。
注释代码当前做什么是很常见的,但这是不必要的。
如果代码很复杂,不得不注释它当前在做什么,这将暗示您应该重写代码,让它更容易理解。
学会使用良好的名称和更短的方法,在不提供注释说明其用途的情况下提高代码的可读性。
函数注释过多或不足
清单5中的注释仅告诉读者代码在做什么—它正在通过一个循环进行迭代或添加一个数字。
但它忽略了它为什么做当前的工作。
这使维护该代码的人员不知道是否可以安全地更改代码(不引入新缺陷)。
清单5.不良习惯:
classResultMessage
private$severity;
private$message;
publicfunction__construct($sev,$msg)
{
$this->
severity=$sev;
message=$msg;
publicfunctiongetSeverity()
return$this->
severity;
publicfunctionsetSeverity($severity)
severity=$severity;
publicfunctiongetMessage()
message;
publicfunctionsetMessage($msg)
functioncntMsgs($messages)
$n=0;
/*iteratethroughthemessages...*/
foreach($messagesas$m){
if($m->
getSeverity()=='
Error'
){
$n++;
//addonetotheresult;
return$n;
$messages=array(newResultMessage("
Error"
"
Thisisanerror!
),
newResultMessage("
Warning"
Thisisawarning!
Thisisanothererror!
));
$errs=cntMsgs($messages);
echo("
Thereare"
.$errs."
errorsintheresult.n"
带注释的函数和类
清单6中的注释告诉读者类和方法的目的。
该注释解释了为什么代码在做当前的工作,这对未来维护代码十分有用。
可能需要根据条件变更而修改代码,如果能够轻松了解代码的目的,则修改起来很容易。
清单6.良好习惯:
/**
*TheResultMessageclassholdsamessagethatcanbereturned
*asaresultofaprocess.Themessagehasaseverityand
*message.
*
*@authornagood
/**
*ConstructorfortheResultMessagethatallowsyoutoassign
*severityandmessage.
*@param$sevSee{@linkgetSeverity()}
*@param$msg
*@returnunknown_type
*Returnstheseverityofthemessage.Shouldbeone
*"
Information"
or"
.
*@returnstringMessageseverity
*Setstheseverityofthemessage
*@param$severity
*@returnvoid
*Countsthemessageswiththegivenseverityinthearray
*ofmessages.
*@param$messagesAnarrayofResultMessage
*@returnintCountofmessageswithaseverityof"
functioncountErrors($messages)
$matchingCount=0;
getSeverity()=="
$matchingCount++;
return$matchingCount;
$errs=countErrors($messages);
处理错误
根据大众的经验,如果要编写健壮的应用程序,错误