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 静态变量与自定义常量的使用方法
Jan 26 PHP
php access 数据连接与读取保存编辑数据的实现代码
May 12 PHP
php 实现进制转换(二进制、八进制、十六进制)互相转换实现代码
Oct 22 PHP
PHP 常用数组内部函数(Array Functions)介绍
Jun 05 PHP
解析php下载远程图片函数 可伪造来路
Jun 25 PHP
PHP中round()函数对浮点数进行四舍五入的方法
Nov 19 PHP
[原创]smarty简单模板变量输出方法
Jul 09 PHP
php中foreach结合curl实现多线程的方法分析
Sep 22 PHP
php获取客户端IP及URL的方法示例
Feb 03 PHP
PHP-CGI远程代码执行漏洞分析与防范
May 07 PHP
PHP PDOStatement::fetch讲解
Jan 31 PHP
Windows上php5.6操作mongodb数据库示例【配置、连接、获取实例】
Feb 13 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调用mysql存储过程
2007/02/14 PHP
PHP多个文件上传到服务器实例
2014/10/29 PHP
PHP的命令行命令使用指南
2015/08/18 PHP
Yii2 assets清除缓存的方法
2016/05/16 PHP
PHP读取zip文件的方法示例
2016/11/17 PHP
php接口技术实例详解
2016/12/07 PHP
PHP+swoole+linux实现系统监控和性能优化操作示例
2019/04/15 PHP
gearman中worker常驻后台,导致MySQL server has gone away的解决方法
2020/02/27 PHP
使用jquery实现简单的ajax
2013/07/08 Javascript
判断文件是否正在被使用的JS代码
2013/12/21 Javascript
Jquery模仿Baidu、Google搜索时自动补充搜索结果提示
2013/12/26 Javascript
javascript判断是手机还是电脑访问网页的简单实例分享
2014/06/03 Javascript
JavaScript中switch语句的用法详解
2015/06/03 Javascript
JS简单实现DIV相对于浏览器固定位置不变的方法
2016/06/17 Javascript
Vue.js第四天学习笔记
2016/12/02 Javascript
vue中的scope使用详解
2017/10/29 Javascript
JS面向对象编程基础篇(二) 封装操作实例详解
2020/03/03 Javascript
vue利用全局导航守卫作登录后跳转到未登录前指定页面的实例代码
2020/05/19 Javascript
Python解析树及树的遍历
2016/02/03 Python
Google开源的Python格式化工具YAPF的安装和使用教程
2016/05/31 Python
Python中交换两个元素的实现方法
2018/06/29 Python
selenium跳过webdriver检测并模拟登录淘宝
2019/06/12 Python
详解10个可以快速用Python进行数据分析的小技巧
2019/06/24 Python
python的pytest框架之命令行参数详解(上)
2019/06/27 Python
选择Python写网络爬虫的优势和理由
2019/07/07 Python
大学自我鉴定
2013/12/20 职场文书
工商管理毕业生推荐信
2013/12/24 职场文书
暑期社会实践学生的自我评价
2014/01/09 职场文书
平安校园建设方案
2014/05/02 职场文书
留学经费担保书
2014/05/12 职场文书
低碳日宣传活动总结
2014/07/09 职场文书
法学专业求职信
2014/07/15 职场文书
2014小学一年级班主任工作总结
2014/12/05 职场文书
党员转正大会主持词
2015/07/02 职场文书
小学英语教学经验交流材料
2015/11/02 职场文书
日元符号 ¥
2022/02/17 杂记