PHP开发规范手册之PHP代码规范详解


Posted in PHP onJanuary 13, 2011

涉及多个方面,比如PHP代码规范、PHP文件命名规范、网站开发流程、网站安全与维护等。
作为PHP开发规范的开篇,我从一个纯PHP开发者的角度来说说我所认为的PHP代码规范,主要从PHP目录框架结构、PHP代码书写规范、PHP文件命名规范三个角度来阐述,希望对PHP入门学习者有所帮助。
合理建设PHP目录框架结构

我们知道在使用PHP进行网站开发之前,我们需要建设网站的目录结构,网站目录框架结构设计得合理规范,不但有利于网站开发,而且对SEO,网站推广都有好处。

一般最基础的PHP网站结构涉及图片、CSS文件、JS文件、第三方组件、管理后台等内容,相对应的,基础的PHP目录框架结构也涉及这些内容,这些目录命名时也有规范,比如

图片目录:images或者pic

CSS目录:css

JS目录:js

第三方组件目录:libs或者include,下一级目录可以根据具体的组件名定义目录名

管理目录:一般都是admin,单位了安全起见,你可以另起一个目录名或者对admin目录设置密码保护。如何对访问目录设置密码保护?

特别提醒:对于网站的框架目录结构,事先要做好规划,为了对搜索引擎友好便于网站推广,建议目录结构层次不要太深,二三级目录结构就可以了。

另外如果你采用模板,可以创建模板目录,比如将目录命名为tpl,如果使用第三方模板引擎,比如smarty,你可以根据需要自行决定是否要另设目录。PHP基础教程:Smarty安装教程

对于中等规模的网站,你也可以根据网站功能划分网站目录框架结构,比如按照频道等。

PHP文件命名规范

良好的PHP文件命名规范也是PHP开发规范的要素,有助于记忆,便于管理,PHP网站程序文件的命名也有一定的规则,比如

PHP网站首页文件命名规范:index.php或index.html

CSS文件命名规范:主CSS文件命名为style.css,另外你也可以针对具体的模块或者频道命名,比如用于用户的CSS文件,可以定义为user_style.css或者u_style.css

JS文件命名规范:主JS文件命名为main.js或major.js,其他的JS文件命名,你可以根据具体的页面或者特定的对象命名,比如首页JS文件可以命名为index.js,服务于用户登录的JS文件可以命名为user_login.js等。

网站配置文件命名规范:config.php或default_config.php等

文件命名特别提醒:在对PHP文件进行命名时考虑到可移植性,一律请使用小写命名,另外与网站目录名命名一样,文件命名时可以采用两种方式,一种可以使用拼音命名具体的文件,一种可以使用简单明了的英语单词命名文件,切勿随便命名,导致今后维护混乱。

PHP代码书写规范

良好的PHP代码规范,有助于PHP入门学习者从你写的PHP代码中受益,也有助于你今后的代码维护。

1、对于所写的PHP代码,添加必要的代码注释,同时代码注释要规范,更多基础PHP代码书写规范,请参考PHP基本语法教程

2、保持良好的PHP代码书写规范,合理使用缩进,保持代码美观。

3、使用赋值符时变量名、赋值符、值之间以空格分隔,即

<? 
$leapsoulcn = "欢迎访问PHP网站教程网,此节主要介绍PHP开发规范之PHP代码规范"; 
?>

4、在书写if、switch、函数代码时,务必保持大括号匹配,即
<? 
if(){ 
...... 
} 
?>

或者
<? 
if() 
{ 
...... 
} 
?>

5、命名变量名或者函数名时注意代码书写规范,可以使用拼音、英语单词、缩写等形式,推荐以英语单词作为PHP代码命名规范,对于两个单词以上的以下划线连接或者其中一个单词首字母大写的形式,即
<? 
$web_name = "PHP网站开发教程网"; 
$webUrl = "https://3water.com"; 
function userLogin() 
{ 
} 
?>

以上就是基础的PHP代码规范,对于PHP初学者学习PHP会有所帮助。养成良好的PHP代码规范会让开发者受益一生。

至此,PHP开发规范手册之PHP代码规范就介绍完了,良好的网站框架目录构建能力、PHP文件命名规范和PHP代码书写规范需要自己在不断的开发中积累和养成,同时这些开发规范也有助于伙伴之间的合作,有助于PHP入门学习者学习你的PHP代码。

PHP 相关文章推荐
PHP4实际应用经验篇(8)
Oct 09 PHP
php array_merge下进行数组合并的代码
Jul 22 PHP
php面向对象全攻略 (五) 封装性
Sep 30 PHP
PHP用GD库生成高质量的缩略图片
Mar 09 PHP
谈谈关于php的优点与缺点
Apr 11 PHP
PHP在线生成二维码(google api)的实现代码详解
Jun 04 PHP
php与java通过socket通信的实现代码
Oct 21 PHP
php实现下载限制速度示例分享
Feb 13 PHP
Drupal读取Excel并导入数据库实例
Mar 02 PHP
php压缩和解压缩字符串的方法
Mar 14 PHP
Joomla简单判断用户是否登录的方法
May 04 PHP
laravel框架模型和数据库基础操作实例详解
Jan 25 PHP
PHP JSON格式数据交互实例代码详解
Jan 13 #PHP
PHP学习笔记之二 php入门知识
Jan 12 #PHP
php算开始时间到过期时间的相隔的天数
Jan 12 #PHP
php数据库密码的找回的步骤
Jan 12 #PHP
重新封装zend_soap实现http连接安全认证的php代码
Jan 12 #PHP
php 变量未定义等错误的解决方法
Jan 12 #PHP
兼容性比较好的PHP生成缩略图的代码
Jan 12 #PHP
You might like
DC四月将推出百页特刊漫画 纪念小丑诞生80周年
2020/04/09 欧美动漫
php发送与接收流文件的方法
2015/02/11 PHP
PHP使用递归按层级查找数据的方法
2019/11/10 PHP
PHP实现基本留言板功能原理与步骤详解
2020/03/26 PHP
jquery选择器之属性过滤选择器详解
2014/01/27 Javascript
jQuery 无限级菜单的简单实例
2014/02/21 Javascript
IE下双击checkbox反应延迟问题的解决方法
2014/03/27 Javascript
用C/C++来实现 Node.js 的模块(二)
2014/09/24 Javascript
JS中三目运算符和if else的区别分析与示例
2014/11/21 Javascript
js关于命名空间的函数实例
2015/02/05 Javascript
基于jquery插件实现拖拽删除图片功能
2020/08/27 Javascript
JS实现简单短信验证码界面
2017/08/07 Javascript
layui 实现table翻页滚动条位置保持不变的例子
2019/09/05 Javascript
小程序富文本提取图片可放大缩小
2020/05/26 Javascript
Vue 实现监听窗口关闭事件,并在窗口关闭前发送请求
2020/09/01 Javascript
Vue中inheritAttrs的使用实例详解
2020/12/31 Vue.js
python快速查找算法应用实例
2014/09/26 Python
python dict.get()和dict['key']的区别详解
2016/06/30 Python
Linux下python3.7.0安装教程
2018/07/30 Python
基于python3 的百度图片下载器的实现代码
2019/11/05 Python
Python 词典(Dict) 加载与保存示例
2019/12/06 Python
python实现的分层随机抽样案例
2020/02/25 Python
python中如何使用虚拟环境
2020/10/14 Python
css3 background属性调整增强介绍
2010/12/18 HTML / CSS
解决HTML5中滚动到底部的事件问题
2019/08/22 HTML / CSS
你的自行车健身专家:FaFit24
2016/11/16 全球购物
LN-CC中国:高端男装和女装的奢侈时尚目的地
2019/09/14 全球购物
学生自我鉴定
2013/12/18 职场文书
幼教简历自我评价
2014/01/28 职场文书
《夜晚的实验》教学反思
2014/02/19 职场文书
银行求职自荐信
2014/06/30 职场文书
2014应届本科生自我评价
2014/09/13 职场文书
go语言-在mac下brew升级golang
2021/04/25 Golang
如何开发一个渐进式Web应用程序PWA
2021/05/10 Javascript
HTML5简单实现添加背景音乐的几种方法
2021/05/12 HTML / CSS
Android使用EventBus发送消息,Fragment中接收消息的方法会执行多次
2022/04/24 Java/Android