11个PHPer必须要了解的编程规范


Posted in PHP onSeptember 22, 2014

本文将讨论常用的良好的代码习惯,或者称为代码规范,在PHP领域。

1,错误报告开启

错误报告是在PHP中一个非常有用的功能,应同时在开发阶段启用。 这可以帮助我们确定我们的代码中的问题。 最常用的功能是“E_ALL”,这有助于我们发现所有的警告和严重错误。 必须指出的是,我们把我们的代码投入上线前,我们应该关闭这个功能提示,否则会在浏览器上的暴漏所有潜在错误及警告。

2,使用DRY原则

‘Do not Repeat Yourself',DRY原则指的是不要重复你的代码.。 这个概念是一个非常有用的编程概念,可硬应用在任何编程语言,如Java,C#或PHP均可以。 使用DRY原则,确保我们在程序中没有冗余的代码。
违反 DRY 原则的解决方案通常被称为 WET,指代“write everything twice”,我们写的相同功能的代码会出现多次以上,别大家戏称是喜欢打字。

让我们看看到下面的代码:
Listing1:
WET代码方式:

$mysql = mysql_connect ( 'localhost', 'mysqladmin_uid', 'mysqladmin_pwd' );
mysql_select_db( 'DB_NAME' ) or die( "Sorry !! No database selected!");

下面使用DRY 原则优化代码:

$db_host = ' localhost ';
$db_user = ' mysqladmin_uid ';
$db_password = ' mysqladmin_pwd ';
$db_database = ' DB_NAME ';
$mysql = mysql_connect($db_host, $db_user, $db_password);
mysql_select_db($db_database);

3,适当的使用缩进及空格

在使用任何一种编程语言编写代码时,必须确保代码在需要的地方提供在必要适当的缩进和足够的空格。 以增加了代码的可读性,用更有效的方式管理代码。

4,使用有意义和一致的命名标准

正如任何编程语言,PHP的老兵还建议我们遵循有意义的命名标准。 我们有两个主要方式在实现这个要求:
A.驼峰式
在这种方法中,第一个字母是小写,每一个单词的第一个字母其后以大写。

Listing2:

public class MyClass {
public void methodName(String argName) {
}
}

B.下划线式
在这种方法中,我们把每两个词之间的下划线(“_”)。 使用这种方法时,代码可以被修改如下:
Listing3:使用下划线代码片段

public class MyClass {
public void method_name(String arg_name) {
}
}

5,避免深层嵌套

使用任何开发语言,多级嵌套降低了代码的可读性。 任何开发者都应应避免使用深层嵌套。

Listing4:代码片段具有多级嵌套

<?php
class MyClass {
public function method_name($arg_name) {
if (is_writable ( $folder )) {
if ($fp = fopen ( $file_location_path, 'w' )) {
if ($stuff = extractSomeConditionalStuff ()) {
if (fwrite ( $fp, $stuff )) {
// ...
} else {
return false;
}
} else {
return false;
}
} else {
return false;
}
} else {
return false;
}
}
}
?>

上面的代码是一个简单的嵌套代码。 我们可以看到它是非常困难的,如果块结束哪里的身影。 为了更好的可读性,让我们修改的代码:
Listing5:代码片段,避免多级嵌套

function method_name (String arg_name) {
// ...
if (! is_writable ( $folder )) {
return false;
}
if (! $fp = fopen ( $file_location_path, 'w' )) {
return false;
}
if (! $stuff = extractSomeConditionalStuff ()) {
return false;
}
if (fwrite ( $fp, $stuff )) {
// ...
} else {
return false;
}
}

6,添加应有的注释

开发中,请确保你的源代码中有足够的行内注释。 这是一个应该遵守的标准做法。 这有助于深入分析代码,因为通常情况下,负责编码的人不会一直保持不变。 即使同一个人被要求在代码中进行一些简单的修改,行内的注释总是会有助于理解当时编写代码是用来做什么的。 为了在PHP中使用较好的注释标准,建议大家去查看一些标准的PHP文档包,例如phpDocumentor。

7,不要把PHPINFO()函数在网站根目录

phpinfo()函数是一个非常重要的功能,应小心使用。 使用此功能,任何人都可以看到服务器环境的详细信息。它最好始终放在
一个安全位置的文件中使用,一旦开发完成上线后,应该删除这段代码使用。

8,永远不要相信用户

如果您的应用程序涉及任何用户输入,务必要编写安全的代码以处理这种方式,因为它包含各种可能的输入。 想要避免程序被攻击注入或者破坏数据完整性,一定要验证过滤数据的格式。大家可以看下这篇文章《可怕的代码注入方式》

9,合理使用缓存机制

良好的编程方法总是建议使用缓存机制缓存帮助我们获得更好的性能。

在PHP的世界,缓存使用来实现:
Memcached的 —— 一个在使用小数据块存储键值对存 储。
APC —— 可选PHP缓存为开放的PHP操作码缓存
XCache —— 一种快速可靠的PHP操作码缓存
Zend Cache ? API,用于实现先进的高速缓存功能的集合。
eAcclerator ? 开源的缓存工具

10,避免复制已有变量

将预定义变量复制到具有较小的名字的局部变量不是一个好的编程习惯。 这对应用程序的性能产生不利影响。 让我们来看看下面的代码片段:
Listing6:复制已有变量

$desc = strip_tags($_POST['PHP description']);
echo $desc;

上面的代码的代码是复制一个变量为局部变量不必要的例子。 这是不是一个好的做法。同样的效果可以通过使用下面的代码来实现:

echo strip_tags($_POST['PHP description']);

11,使用框架

框架是大量的研究后开发的,因此,他们被证明是问题较少。 它们使我们的开发更便捷,因为它们提供成熟的解决方案。 在PHP中有很多可用的框架。 在开发过程中,你应该利用这些。 其中的一个框架,被广泛采用的是MVC或模型视图控制器。

结论:

编程规范指导我们更有效的开发代码。

遵循编程规范,确保应用程序的更好的性能。

正如在其他编程语言,要想创造出高质量的代码,PHP也需要遵循这种良好的编程规范。

PHP 相关文章推荐
用PHP程序实现支持页面后退的两种方法
Jun 30 PHP
php 中英文语言转换类
Sep 07 PHP
PHP三元运算符的结合性介绍
Jan 10 PHP
PHP设计模式之装饰者模式
Feb 29 PHP
php中限制ip段访问、禁止ip提交表单的代码分享
Aug 22 PHP
php简单分页类实现方法
Feb 26 PHP
php判断文件夹是否存在不存在则创建
Apr 09 PHP
PHP实现的mongoDB数据库操作类完整实例
Apr 10 PHP
thinkphp5.1 文件引入路径问题及注意事项
Jun 13 PHP
Laravel框架搜索分页功能示例
Feb 01 PHP
使用PHPUnit进行单元测试并生成代码覆盖率报告的方法
Mar 08 PHP
thinkphp5修改view到根目录实例方法
Jul 02 PHP
PHP正则替换函数preg_replace和preg_replace_callback使用总结
Sep 22 #PHP
php分页函数完整实例代码
Sep 22 #PHP
php中file_get_content 和curl以及fopen 效率分析
Sep 19 #PHP
PHP return语句另类用法不止是在函数中
Sep 17 #PHP
php使用$_POST或$_SESSION[]向js函数传参
Sep 16 #PHP
PHP正则表达式替换站点关键字链接后空白的解决方法
Sep 16 #PHP
一个php生成16位随机数的代码(两种方法)
Sep 16 #PHP
You might like
十天学会php之第九天
2006/10/09 PHP
TP5框架安全机制实例分析
2020/04/05 PHP
JavaScript实现禁止后退的方法
2006/12/27 Javascript
JS获取父节点方法
2009/08/20 Javascript
mysql输出数据赋给js变量报unterminated string literal错误原因
2010/05/22 Javascript
自制轻量级仿jQuery.boxy对话框插件代码
2010/10/26 Javascript
javascript之querySelector和querySelectorAll使用说明
2011/10/09 Javascript
jQuery中ajax的post()方法用法实例
2014/12/26 Javascript
javascript内置对象操作详解
2015/02/04 Javascript
JS绘制微信小程序画布时钟
2016/12/24 Javascript
jQuery插件HighCharts绘制2D金字塔图效果示例【附demo源码下载】
2017/03/09 Javascript
JS触摸事件、手势事件详解
2017/05/04 Javascript
Vue组件开发技巧总结
2018/03/04 Javascript
详解Vue.js 作用域、slot用法(单个slot、具名slot)
2019/10/15 Javascript
vue+vant实现商品列表批量倒计时功能
2020/01/13 Javascript
JavaScript动画实例之粒子文本的实现方法详解
2020/07/28 Javascript
Python函数学习笔记
2008/10/07 Python
Python算法之求n个节点不同二叉树个数
2017/10/27 Python
Python中Scrapy爬虫图片处理详解
2017/11/29 Python
Python实现简单生成验证码功能【基于random模块】
2018/02/10 Python
python 反向输出字符串的方法
2018/07/16 Python
解决tensorflow1.x版本加载saver.restore目录报错的问题
2018/07/26 Python
python自动保存百度盘资源到百度盘中的实例代码
2019/08/26 Python
利用 Python ElementTree 生成 xml的实例
2020/03/06 Python
WoolOvers爱尔兰:羊绒、羊毛和棉针织品
2017/01/04 全球购物
体育老师的教学自我评价分享
2013/11/19 职场文书
简历自我评价怎么写呢?
2014/01/06 职场文书
求职信的最佳写作思路
2014/02/01 职场文书
卫校毕业生个人自我鉴定
2014/04/28 职场文书
无刑事犯罪记录证明范本
2014/09/29 职场文书
2014年科普工作总结
2014/12/06 职场文书
幼儿园教师岗位职责
2015/04/02 职场文书
党员转正大会主持词
2015/07/02 职场文书
九年级化学教学反思
2016/02/22 职场文书
Pandas加速代码之避免使用for循环
2021/05/30 Python
Python 数据可视化工具 Pyecharts 安装及应用
2022/04/20 Python