0

0

PHP网站代码编写规范

php中文网

php中文网

发布时间:2016-06-21 08:57:16

|

1389人浏览过

|

来源于php中文网

原创

PHP网站代码编写规范

一、 变量命名

a) 所有字母都使用小写

b) 首字母根据变量值类型指定

i. 整数i

ii. 浮点数f

iii. 字符串s

立即学习PHP免费学习笔记(深入)”;

iv. 布尔值b

v. 数组a

vi. 对象o

vii. 资源r

viii. 混合类型m

c) 使用’_’作为每一个词的分界

例如:

$i_age_max = 10;

$f_price = 22.5;

$s_name =‘harry’;

$b_flag = true;

$a_price = array();

$o_object = new class();

$r_file = fopen();

$m_var = array_combine($a_name, $a_flag);
 

二、 类命名

a) 使用大写字母作为词的分隔,其他的字母均使用小写,即驼峰格式。

b) 名字的首字母使用大写

c) 不要使用下划线(’_')

d) interface接口最好使用大写字母I,并以Interface结尾

例如:

class NameOneTwo

class Name

interface IExampleInterface ()

三、 方法命名

a) 使用大写字母作为词的分隔,其他的字母均使用小写

b) 名字的首字母使用大写,声明为 “private” 或 “protected” 的,使用’_’为前缀

c) 不要使用下划线(’_')

d) (与类命名一致的规则)

e) 对象的访问器总是以 “get” 或 “set” 为前缀,当使用设计模式如 单态模式(singleton)或工厂模式(factory),方法的名字应当包含模式的名字,这样容易从名字识别设计模式。

例如:

class NameOneTwo{

public function DoIt() {};

protect function _HandleError() {};

private function _SayHello() {};

}

Dora
Dora

创建令人惊叹的3D动画网站,无需编写一行代码。

下载

四、 类属性命名

a) 属性名前缀应以属性值类型指定(具体参照变量命名规则)

b) 前缀后采用与类命名一致的规则

c) 私有属性采用’_’为前缀

例如:

class NameOneTwo {

public function VarAbc() {};

public function ErrorNumber() {};

public $iAge;

private $_iAge;

}

五、 方法中参数命名

a) 参照类属性命名

例如:

class NameOneTwo {

public function VarAbc($sMsg) {};

}

六、 全局变量

a) 全局变量应该带前缀‘g’

b) 其余参照变量命名规则

例如:

global $gi_Age;

global $ga_Price

七、 定义命名/全局常量

a) 全局常量使用’_’分割每个单词

b) 所有字母使用大写

例如:

define(‘E_ERROR_MISSING_PARA’, 501);

八、 函数

a) 所有的字母采用小写,使用’_’分割每个单词

例如:

function some_bloody_function(){

}

九、 大括号{}规则

a) 将大括号放置关键词下方的同列处或同行,推荐放到同行

例如:

function some_bloody_function() {

}

if (true) {

// code

}

十、 缩进/制表符规则

a) 使用制表符缩进

例如:

function some_bloody_function() {

if (true) {

//code

}

}

十一、 小括号、关键词和函数规则

a) 不要把小括号和关键词紧贴在一起,要用空格隔开它们

b) 小括号和函数名要紧贴在一起

c) 除非必要,不要在Return返回语句中使用小括号

例如:

if (condition) {

}

strcmp($sHello, $sEvening);

return 1;

十二、 If Then Else格式

布局

if (条件1) { //注释

}

else if (条件2) { //注释

}

else { //注释

}

如果你有用到else if语句的话,通常最好有一个else块以用于处理未处理到的其他情况。可以的话放一个记录信息注释在else处,即使在else没有任何的动作。

条件格式

总是将恒量放在等号/不等号的左边,例如:

if ( 6 == $errorNum ) …

一个原因是假如你在等式中漏了一个等号,语法检查器会为你报错。第二个原因是你能立刻找到数值,而不是在你的表达式的末端找到它。需要一点时间来习惯这个格式,但是它确实很有用。

十三、 Switch格式

a) default总应该存在,它应该不被到达,然而如果到达了就会触发一个错误。

b) 如果你要创立一个变量,那就把所有的代码放在块中。

例如:

switch ($numPeople) {
case 1:
break;

case 2:
break;

default:
break;
}

十四、 ?:三元运算符

a) 把条件放在括号内以使它和其他的代码相分离。

b) 如果可能的话,动作可以用简单的函数。

c) 把所做的动作,“?”,“:”放在不同的行,除非他们可以清楚的放在同一行。

例如

(condition) ? funct1() : func2();

(condition)

? long statement

: another long statement;

十五、 代码块的声明

a) 声明代码块需要对齐。

例如

$iDate = 0;

$irDate = NULL;

$sName = ‘’;

$mName = NULL;

十六、 不要采用缺省方法测试非零值

不要采用缺省值测试非零值,也就是使用:

if (FAIL != f())

比下面的方法好:

if (f())

即使FAIL可以含有0值,也就是PHP认为false的表示。在某人决定用-1代替0作为失败返回值的时候,一个显式的测试就可以帮助你了。就算是比较值不会变化也应该使用显式的比较;

例如:if (!($bufsize % strlen($str)))应该写成:if (($bufsize % strlen($str)) == 0)以表示测试的数值(不是布尔)型。一个经常出问题的地方就是使用strcmp来测试一个字符等式,结果永远也不会等于缺省值。

非零测试采用基于缺省值的做法,那么其他函数或表达式就会受到以下的限制:

只能返回0表示失败,不能为/有其他的值。

命名以便让一个真(true)的返回值是绝对显然的,调用函数IsValid()而不是Checkvalid()。

十七、PHP注释与方法解析

a) //单行注释

b) 第二种
/*
* 多行注释…
*
*/
c) 第三种
/**
* 多行文档注释…
*
*/

d) 关于文档注释的说明

/**
* 这是一个关于函数的注释 …
*
*/
function bac(){}

/*
* 这不是一个文档注释,因为不是以/**开头 …
*
*/
function bac(){}

/**
* 这是一个文档注释,但与函数无关,因为他没放到函数前面 …
*
*/

function bac(){}

e) 文档说明
/**
* 文件说明
* @author 作者
* @license License
* @version 1.0
* @link
* @final
*/

推荐写完代码后用ZendStudio重新格式化一次代码,清晰



PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

705

2026.02.13

微博网页版主页入口与登录指南_官方网页端快速访问方法
微博网页版主页入口与登录指南_官方网页端快速访问方法

本专题系统整理微博网页版官方入口及网页端登录方式,涵盖首页直达地址、账号登录流程与常见访问问题说明,帮助用户快速找到微博官网主页,实现便捷、安全的网页端登录与内容浏览体验。

233

2026.02.13

Flutter跨平台开发与状态管理实战
Flutter跨平台开发与状态管理实战

本专题围绕Flutter框架展开,系统讲解跨平台UI构建原理与状态管理方案。内容涵盖Widget生命周期、路由管理、Provider与Bloc状态管理模式、网络请求封装及性能优化技巧。通过实战项目演示,帮助开发者构建流畅、可维护的跨平台移动应用。

117

2026.02.13

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

22

2026.02.13

Redis高可用架构与分布式缓存实战
Redis高可用架构与分布式缓存实战

本专题围绕 Redis 在高并发系统中的应用展开,系统讲解主从复制、哨兵机制、Cluster 集群模式及数据分片原理。内容涵盖缓存穿透与雪崩解决方案、分布式锁实现、热点数据优化及持久化策略。通过真实业务场景演示,帮助开发者构建高可用、可扩展的分布式缓存系统。

61

2026.02.13

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

30

2026.02.12

雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法
雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法

本专题系统整理雨课堂网页版官方入口及在线登录方式,涵盖账号登录流程、官方直连入口及平台访问方法说明,帮助师生用户快速进入雨课堂在线教学平台,实现便捷、高效的课程学习与教学管理体验。

15

2026.02.12

豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法
豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法

本专题汇总豆包AI官方网页版入口及在线使用方式,涵盖智能写作工具、图片生成体验入口和官网登录方法,帮助用户快速直达豆包AI平台,高效完成文本创作与AI生图任务,实现便捷智能创作体验。

669

2026.02.12

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

58

2026.02.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【李炎恢】ThinkPHP8.x 后端框架课程
【李炎恢】ThinkPHP8.x 后端框架课程

共50课时 | 4.6万人学习

PHP+MySQL基础入门课程
PHP+MySQL基础入门课程

共113课时 | 8.5万人学习

php初学者入门课程
php初学者入门课程

共10课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号